美股 SEC XBRL 單一概念時序 (季/年)

us_get_sec_concept_series

台灣專屬MIT

**關鍵字 / 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.

輸入 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"
}

呼叫方式

配置好 Twinkle Hub 的 MCP client 後，agent 會看到 us_get_sec_concept_series。直接讓它呼叫即可，例如：

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

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

尚未設定 Client？

Claude Desktop 約 3 分鐘即可完成設定 — 下載 .mcpb 檔案並雙擊即可，或參閱文件中的各 Client 安裝步驟。

查看使用者設定文件

輸入 schema

呼叫​方式

呼叫方式