Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.llmquantdata.com/llms.txt

Use this file to discover all available pages before exploring further.

已暴露为 MCP 工具sec_filing_browse —— 在 Claude / Cursor / 任意 MCP 客户端中直接调用。详见 MCP Server 60 秒配置。
已上线   免费 · listing

它为 Agent 做什么

sec_filing_browse 是 SEC Filing progressive disclosure 模式的第一步:给定美股 ticker,返回该公司可用的 10-K / 10-Q / 8-K 元数据列表(不含正文)。agent 用它先发现公司有哪些 filing,再用 sec_filing_read 拉取具体章节内容 —— 10-K / 10-Q 用 year / quarter,8-K 用 accession_number(事件驱动,一年多份)。每份 filing 还会带上 section_keys(该 filing 可用的章节 code),agent 不读正文就能判断某份 8-K 讲的是什么。 Browse 不是 semantic search:只接受 ticker + 可选 filing_type。不做关键词匹配,不做相关性排序,不接自然语言查询。

返回值

data
Filing[]
required
filing_date 倒序排列的申报文件数组。
meta.count
number
本次返回的 filing 数。
meta.creditsUsed
number
固定 0 —— browse 免费。
200 OK · sec_filing_browse
{
  "data": [
    {
      "sec_filing_id": "a1b2c3d4-...",
      "ticker": "AAPL",
      "company_name": "Apple Inc.",
      "filing_type": "10-K",
      "accession_number": "0000320193-25-000079",
      "filing_date": "2025-10-31",
      "report_date": "2025-09-27",
      "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm",
      "section_keys": ["1", "1A", "7", "7A", "8"]
    }
  ],
  "meta": { "count": 1, "creditsUsed": 0 }
}

说明

两步检索是 canonical 模式sec_filing_browse 免费拉 filing 列表,再用 sec_filing_read(1 credit)抽取具体章节。把 browse 返回的 accession_number 直接传给 read,定位最干净。
每份 filing 都带 section_keys —— 它可用的章节 code 列表。对一年多份、全叫「8-K」的 8-K,这是 agent 不读正文就挑对那份的关键:item2.02 = earnings、item5.02 = 高管变动、ex99.1 = press release 附件。把想要的 code 直接传给 sec_filing_readitems
SEC filing 一旦公布就不会再变,结果可长期复用。某 ticker 的首次查询可能略慢,之后秒回。
支持 10-K、10-Q 和 8-K。暂不支持 20-F、proxy(DEF 14A)等其他类型。
不支持日期范围过滤filed_at_gte / filed_at_lte),不支持按 CIK 查询。只接 ticker(+ 可选 filing_type)。

直接调用

{
  "method": "tools/call",
  "params": {
    "name": "sec_filing_browse",
    "arguments": { "ticker": "AAPL", "filing_type": "10-K", "limit": 10 }
  }
}

完整参数参考

ticker
string
required
美股 ticker(如 AAPLMSFTBRK.B)。
filing_type
string
按文件类型过滤。可选值:10-K10-Q8-K。省略则全部返回。
limit
integer
default:10
返回的最大 filing 数。默认 10,最大 50

相关接口

SEC 申报文件章节读取

progressive disclosure 第二步 —— 从指定 filing 抽取具体 item 的完整文本。

13F 头部机构枚举

枚举本季度 smart money universe,作为 consensus 分析的起点。

MCP Server 接入

60 秒接入 Claude / Cursor / 任意 agent harness。