SEC 申报文件章节读取

已暴露为 MCP 工具：sec_filing_read —— 在 Claude / Cursor / 任意 MCP 客户端中直接调用。详见 MCP Server 60 秒配置。

已上线每次 1 credit

它为 Agent 做什么

sec_filing_read 是 SEC Filing progressive disclosure 模式的第二步：在 sec_filing_browse 拿到某 ticker 的 filing 列表之后，用本工具抽出某份 filing 中具体 item 的全文（Risk Factors、MD&A、财务报表、earnings press release 等）。传 accession_number（在 browse 后推荐，且 8-K 必传）或 year / quarter + 章节 code，响应里会带上正文 + 该 filing 其他章节的 manifest。传 items（数组）可一次取多段、仍只 1 credit；请求里这份 filing 没有的 code 会被直接略过、不报错。 sec_filing_read 不是 semantic search：按 (ticker, filing_type, accession_number 或 year[+quarter], item) 做参数化精确查询，返回精确的章节文本 —— 不做相关性排序，不做模糊匹配。

MCP 工具把定位字段收进一个 filing 对象。 走 HTTP API 时定位字段仍是平铺 query 参数；Hosted Remote MCP 和 @llmquant/data-mcp@0.7.1 传结构化 filing 对象，只接受三种写法中的一种：

年报 —— {"filing_type": "10-K", "year": 2024}
季报 —— {"filing_type": "10-Q", "year": 2025, "quarter": 2}
指定某一份 filing —— {"filing_type": "10-K" | "10-Q" | "8-K", "accession_number": "0000320193-26-000050"}

只传你选中那种写法列出的字段。三种之外的组合 —— accession_number 和 year 同时出现、10-K 带 quarter、8-K 不带 accession_number —— 在调用真正发出前就会被拒绝，不消耗 credit。

返回值

HTTP API 响应用 snake_case 字段名。MCP 工具结果返回同一份数据，但字段名是 camelCase，如 filingType、accessionNumber、availableSections。

FilingReadResult

required

Show FilingReadResult 字段

string

required

股票代码。

string

required

文件类型 —— 10-K、10-Q 或 8-K。

string

required

命中的 filing 的 SEC 受理号。

integer

period_of_report 的日历年（8-K 为 null —— 事件驱动、无报告期）。

integer

period_of_report 的季度（10-Q 为 1-4；10-K 和 8-K 为 null）。

SectionManifest[]

required

该 filing 所有可抽取章节的 manifest —— 用来探索还能读哪些 item。

Show SectionManifest 字段

string

required

Item code（1、1A、7、part1item2、item2.02 等）。

string

required

章节名称（Business、Risk Factors 等）。

integer

required

该章节在 filing 内的展示顺序。

integer

required

字符数；该章节尚未被读取时为 0。

Item[]

required

请求的 items 对应的章节内容（不指定时返回全部章节）。这份 filing 没有的 code 不会出现在这里 —— 对照 available_sections 核对。

Show Item 字段

string

required

Item code（如 1A、part1item2）。

string

required

章节名称（如 Risk Factors、MD&A）。

string

required

从 filing 抽取的纯文本正文。

number

本次调用消耗的 credit（固定 1）。

number

账户剩余 credit。

200 OK · sec_filing_read

{
  "data": {
    "ticker": "NVDA",
    "filing_type": "10-K",
    "accession_number": "0001045810-26-000021",
    "year": 2025,
    "quarter": null,
    "available_sections": [
      { "section_key": "1", "section_title": "Business", "ordinal": 1, "char_count": 48578 },
      { "section_key": "1A", "section_title": "Risk Factors", "ordinal": 2, "char_count": 32100 },
      { "section_key": "7", "section_title": "MD&A", "ordinal": 10, "char_count": 25400 }
    ],
    "items": [
      {
        "number": "1A",
        "name": "Risk Factors",
        "text": "Item 1A. Risk Factors\n\nOur business, financial condition and operating results may be materially affected by..."
      }
    ]
  },
  "meta": { "creditsUsed": 1, "remainingCredits": 99 }
}

说明

两步检索是 canonical 模式：先用 sec_filing_browse（免费）拿 filing 列表，挑出想读的 accession_number，再用 sec_filing_read（1 credit）+ 具体 item 抽正文。这样能避开 10-Q 的 period_of_report 和 filed_at 季度不一致问题。

抽更多章节前先看 available_sections[i].char_count —— Risk Factors、MD&A 等长 item 动辄几万字。每次只读一个章节，agent context 才不会爆。

要同一份 filing 的多段？传 items（如 ["item2.02","item9.01"]）一次取回 —— 仍只 1 credit —— 还能跳过没点名的大附件。

10-K、10-Q 和 8-K 使用不同的 item code 体系，参数参考下方表格。混用会返回 400。

请求的 code 缺失时略过、不报错。 格式合法但这份 filing 没有的 item / items code 会从结果里略过（看 available_sections 确认实际有哪些）。如果请求的 code 全都取不到，响应仍是 200，但 items 为空且带 meta.notice；这次 read 仍消耗 1 credit。格式非法的 code（item 体系与 filing type 不匹配）仍返回 400。

10-Q 时单传 year 不够 —— 必须 year + quarter 一起传，或者直接传 accession_number。10-Q 只传 year 会返回 400。

8-K 必须用 accession_number 定位。 它是事件驱动（一年多份），year / quarter 无法唯一锁定 —— 先 browse 再用 accession_number 读。对 8-K 传 year 或 quarter 会返回 400。

仅支持纯文本输出，不返回 HTML / 结构化表格。极新 filing 可能需要稍等片刻才能读取。

直接调用

HTTP / SDK 示例

// 1) Browse 拿 filing 列表
{
  "method": "tools/call",
  "params": {
    "name": "sec_filing_browse",
    "arguments": { "ticker": "NVDA", "filing_type": "10-K", "limit": 5 }
  }
}

// 2) 一次读这份 10-K 的 Risk Factors + MD&A（items 1A、7）
{
  "method": "tools/call",
  "params": {
    "name": "sec_filing_read",
    "arguments": {
      "ticker": "NVDA",
      "filing": {
        "filing_type": "10-K",
        "accession_number": "0001045810-26-000021"
      },
      "items": ["1A", "7"]
    }
  }
}

// 或者不用 accession_number，直接按年份读 2024 年报
{
  "method": "tools/call",
  "params": {
    "name": "sec_filing_read",
    "arguments": {
      "ticker": "NVDA",
      "filing": { "filing_type": "10-K", "year": 2024 },
      "items": ["1A"]
    }
  }
}

import os, requests

base = "https://api.llmquantdata.com"
headers = {"Authorization": f"Bearer {os.environ['LLMQUANT_API_KEY']}"}

# 1) Browse
filings = requests.get(
    f"{base}/api/filings",
    headers=headers,
    params={"ticker": "NVDA", "filing_type": "10-K", "limit": 5},
).json()["data"]

# 2) 一次读最近一份 10-K 的 items 1A + 7
latest = filings[0]
resp = requests.get(
    f"{base}/api/filings/sections",
    headers=headers,
    params={
        "ticker": "NVDA",
        "filing_type": "10-K",
        "accession_number": latest["accession_number"],
        "items": "1A,7",
    },
).json()
print(resp["data"]["items"][0]["text"][:500])

# 1) Browse
curl "https://api.llmquantdata.com/api/filings?ticker=NVDA&filing_type=10-K&limit=5" \
  -H "Authorization: Bearer $LLMQUANT_API_KEY"

# 2) 一次读 items 1A + 7
curl "https://api.llmquantdata.com/api/filings/sections?ticker=NVDA&filing_type=10-K&accession_number=0001045810-26-000021&items=1A,7" \
  -H "Authorization: Bearer $LLMQUANT_API_KEY"

完整参数参考

sec_filing_read — 请求参数

下面的名字和含义是 HTTP query 参数。MCP 工具把 snake_case 定位字段装进一个 filing 对象（filing_type、year、quarter、accession_number），结果字段则是 camelCase —— 见本页开头那条说明。

string

required

美股 ticker（如 AAPL、NVDA、META）。

string

required

文件类型 —— 10-K、10-Q 或 8-K。

integer

period_of_report 的日历年。当 accession_number 省略时：10-K 必填；10-Q 必须与 quarter 一起传。8-K 不使用（用 accession_number 定位）。

integer

period_of_report 的季度（1-4）。仅适用于 10-Q（10-K 和 8-K 会被拒）。10-Q 通过 year 查询且不传 accession_number 时必填。

string[]

一次取多段。HTTP 用逗号分隔（items=item2.02,item9.01），MCP 工具传数组。code 和下面 item 一样。最多 25 个，自动去重，仍只算 1 credit。这份 filing 没有的 code 会跳过；全都对不上时返回 200、空 items 和 notice。不填就返回全部章节。

string

items 的单数别名（仅 HTTP；MCP 工具只暴露 items）—— 等价于 items=[<item>]。省略则返回所有可抽取章节。10-K item code： 1、1A、1B、1C、2、3、4、5、6、7、7A、8、9、9A、9B、10、11、12、13、14、15。10-Q item code： part1item1、part1item2、part1item3、part1item4、part2item1、part2item1a、part2item2、part2item3、part2item4、part2item5、part2item6。8-K item code： 随 filing 变化（事件驱动）—— 如 item2.02（earnings / Results of Operations）、item5.02（高管变动）、item1.01（重大协议）、item8.01（其他事件），外加 ex99.1（press release）这类附件。读响应里的 available_sections 可看到某份 8-K 实际包含的全集。常用组合：10-K 1（Business）· 1A（Risk Factors）· 7（MD&A）· 8（财务报表）· 10（董事/高管）；10-Q part1item1（财务报表）· part1item2（MD&A）· part2item1a（Risk Factors）。

string

精确 SEC 受理号（如 0001045810-26-000021）。在 sec_filing_browse 之后推荐用这种方式，且 8-K 必传。不能与 year / quarter 同时使用。MCP 工具会检查格式（0000000000-00-000000），所以填占位字符串会被直接拒绝，不会被当成真的受理号去查。值请从 sec_filing_browse 的返回里取。

SEC 申报文件浏览

第 1 步 —— 调 read 之前先列出该 ticker 的可用 filing。

13F 按机构查持仓

机构持仓数据 —— 不同的 SEC 申报家族（Form 13F）。

MCP Server 接入

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

快速开始

接入

个人 Context

知识数据

Crypto 行情

预测市场

美股行情

ETF

宏观指标