美股 SEC 單一申報文件 metadata

us_get_sec_filing

台灣專屬MIT

**關鍵字 / Keywords**: SEC EDGAR 美股財報申報 filing accession primary document 10-K 10-Q 8-K URL cite metadata single filing detail

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

Look up one filing by CIK + accession number. Returns full metadata
plus the direct URL to the primary document — the filing body is
NOT downloaded inline (agents crawl on demand via `original_url`).

Endpoint:
    https://data.sec.gov/submissions/CIK{cik10}.json
    (looks up accession in the filings.recent block)

Args:
    cik: CIK (zero-padded or not).
    accession_number: SEC accession, dashed ("0000320193-25-000079")
                      or undashed ("000032019325000079") — either works.

Returns dict with `form`, `filing_date`, `report_date`,
`acceptance_datetime`, `primary_document`, `primary_document_url`,
`filing_index_url`, `is_xbrl`, `is_inline_xbrl`, `size_bytes`,
`items` (for 8-K), plus `original_url` = primary_document_url. If
the accession predates the recent-1000 window, returns
`error="not_in_recent_1000"` + `older_file_pointers` telling the
agent where to look next. License: US Public Domain.

輸入 schema

{
  "properties": {
    "cik": {
      "title": "Cik",
      "type": "string"
    },
    "accession_number": {
      "title": "Accession Number",
      "type": "string"
    }
  },
  "required": [
    "cik",
    "accession_number"
  ],
  "title": "us_get_sec_filingArguments",
  "type": "object"
}

呼叫方式

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

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

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

尚未設定 Client？

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

查看使用者設定文件

輸入 schema

呼叫​方式

呼叫方式