US SEC XBRL concept time series

us_get_sec_concept_series

TW-specificMIT

**關鍵字 / Keywords**: SEC EDGAR XBRL concept time series us-gaap Revenues NetIncomeLoss Assets quarterly annual 季報年報 financial ratio time series 財務比率時間序列

Scope: US public companies filing with the SEC (EDGAR).

One XBRL concept across all reported periods for one filer — the
efficient path when you already know which line item you want
(e.g. quarterly revenue history).

Endpoint:
    https://data.sec.gov/api/xbrl/companyconcept/CIK{cik10}/{taxonomy}/{tag}.json

Args:
    cik: CIK (zero-padded or not).
    taxonomy: usually "us-gaap" (US filers). Others: "dei" (entity
              registration), "ifrs-full" (foreign filers using
              IFRS), "srt" (SEC Reporting Taxonomy).
    tag: XBRL concept name. Common us-gaap tags:
         - "Revenues" · "SalesRevenueNet" ·
           "RevenueFromContractWithCustomerExcludingAssessedTax"
         - "NetIncomeLoss" · "OperatingIncomeLoss"
         - "Assets" · "AssetsCurrent" · "Liabilities" ·
           "StockholdersEquity"
         - "CashAndCashEquivalentsAtCarryingValue"
         If the tag is not reported, response has
         `error="concept_not_reported"` — call
         `us_get_sec_company_facts` to enumerate available tags.

Returns dict with `label`, `description`, `unit_summary`
({USD: n_periods, shares: n, …}), and `units` (raw per-period
array). Each period row has `end` (period-end YYYY-MM-DD), `val`
(numeric), `accn` (accession that reported it), `fy`, `fp`
(Q1/Q2/Q3/FY), `form` (10-K / 10-Q), `filed` (filing date),
optional `frame` (SEC quarter frame). License: US Public Domain.

Input schema

{
  "properties": {
    "cik": {
      "title": "Cik",
      "type": "string"
    },
    "taxonomy": {
      "default": "us-gaap",
      "title": "Taxonomy",
      "type": "string"
    },
    "tag": {
      "default": "Revenues",
      "title": "Tag",
      "type": "string"
    }
  },
  "required": [
    "cik"
  ],
  "title": "us_get_sec_concept_seriesArguments",
  "type": "object"
}

How to call

Once your Twinkle Hub MCP client is configured, your agent will see us_get_sec_concept_series. Just ask it to call — example:

# Ask Claude / any MCP client:
請用 us_get_sec_concept_series 處理 "…"。

# It will call:
us_get_sec_concept_series(input="…")

Haven't set up a client yet?

Claude Desktop in 3 minutes — download the .mcpb and double-click, or see docs for other clients.

See user docs