美股 SEC XBRL 財務數據 (全欄位)

us_get_sec_company_facts

台灣專屬MIT

**關鍵字 / Keywords**: SEC EDGAR XBRL company facts financial statements revenue net income assets liabilities equity us-gaap dei taxonomy 財報財務數據財務報表營收淨利資產負債股東權益

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

All XBRL facts for one filer — the raw machine-parseable financial
statement data (revenue · net income · assets · liabilities ·
equity · cash flows · every reported us-gaap and dei concept).

Endpoint:
    https://data.sec.gov/api/xbrl/companyfacts/CIK{cik10}.json

Args:
    cik: CIK (zero-padded or not).

Returns dict with:
    entity_name: str
    taxonomies: {taxonomy → {tag_count, tags_sample: [first 25 tags]}}
    facts: {taxonomy → {tag → {label, description, units:
                               {unit → [{end, val, accn, fy, fp,
                                         form, filed, frame?}, ...]}}}}
Downstream agents pick the tag they want (e.g.
`facts["us-gaap"]["NetIncomeLoss"]["units"]["USD"]`) — no
server-side flattening. Large response (100 KB to a few MB for
mega-caps). License: US Public Domain. Rate-limited to 10 req/sec.

輸入 schema

{
  "properties": {
    "cik": {
      "title": "Cik",
      "type": "string"
    }
  },
  "required": [
    "cik"
  ],
  "title": "us_get_sec_company_factsArguments",
  "type": "object"
}

呼叫方式

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

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

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

尚未設定 Client？

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

查看使用者設定文件

輸入 schema

呼叫​方式

呼叫方式