US SEC XBRL company facts

us_get_sec_company_facts

TW-specificMIT

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

Input schema

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

How to call

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

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

# It will call:
us_get_sec_company_facts(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