Skip to main content
Glama

SEC EDGAR — 上市公司申报文件

美国证券交易委员会的申报文件数据库。美国每一家上市公司都在这里申报,每份申报文件都带有时间戳且不可更改,每项披露(收入、债务、风险因素、高管薪酬、并购活动、内幕交易)都经过结构化处理,可供机器检索。免费且权威。

属于 Pipeworx 的一部分——一个将 AI 智能体连接到 1476+ 个实时数据源的 MCP 网关。

为什么这对 AI 智能体很重要

如果你的智能体要回答任何关于美国上市公司的问题——财务数据、法律风险敞口、知识产权、高管变动、近期重大事件——答案都在 EDGAR 里。数据是结构化的(XBRL),所以你不需要解析 PDF。

两个关键流程:

1. 申报文件流程。 "显示苹果公司最近的 10-Q。" → edgar_ticker_to_cik("AAPL") → edgar_company_filings(cik) → 带有受理编号、表格类型、申报日期的申报文件列表。

2. 概念流程。 "苹果公司过去 4 个季度的收入趋势如何?" → edgar_company_concept(cik, "Revenues") → 跨期间的 XBRL 标记值时间序列。

两者通常都以 edgar_ticker_to_cik 或 resolve_entity({type: "company", value: "AAPL"}) 开头,以获取规范的 10 位 CIK。

Related MCP server: edgar-mcp

认证

无需认证。SEC EDGAR 是免费、公开、无需认证的服务。Pipeworx 会转发一个礼貌的 User-Agent 头,以遵守 SEC 的 API 指南。

可引用的 URI

pipeworx://edgar/company/{cik}/filings
pipeworx://edgar/company/{cik}/facts

嵌入到你的输出中。在重组中保持稳定——公司会改名,但它们的 CIK 不会变。

值得了解的申报表格类型

表格

内容

时间

10-K

年度报告

财年结束后约 60 天

10-Q

季度报告

季度结束后约 45 天

8-K

重大事件(并购、高管变动、财报等)

4 个工作日内

DEF 14A

委托书(高管薪酬、公司治理)

年度股东大会前约 6 周

Form 4

内幕交易披露

交易后 2 个工作日内

13F

机构持仓(AUM 超过 1 亿美元的基金)

季度结束后 45 天

S-1

IPO 注册

上市时

13D / 13G

超过 5% 实益所有权披露

达到门槛后 10 天内

对于内幕交易,请特别参阅专门的 insider-trading 包——它以更清晰的模式呈现 Form 4 / 13D / 13G 的变动。

常见陷阱

  • 概念名称漂移。 SEC 申报人偶尔会更改他们为收入标记的 XBRL 概念。默认的 Revenues 概念对于较新的财年可能已过时;请尝试使用 RevenueFromContractWithCustomerExcludingAssessedTax 作为备选。

  • 期间不匹配。 各公司的财年结束时间不同(苹果 = 9 月,微软 = 6 月,谷歌 = 12 月)。进行比较时,务必披露期间。

  • CIK 格式。 某些端点需要零填充的 10 位数字(0000320193),某些需要未填充的(320193)。Pipeworx 两种都接受;edgar_ticker_to_cik 中的 cik_padded 字段是资源 URI 的规范形式。

  • 近似实时,而非实时。 申报文件在提交后几分钟内就会出现在 EDGAR 上,但 Pipeworx 会缓存结果。如需突发新闻级别的时效性,请设置 Cache-Control: no-cache(适用匿名限制),或查看 _meta.cache.fresh_until 字段。

  • 概念可用性不同。 较小的申报人标记的 XBRL 概念比大公司少。edgar_company_concept 可能会对该公司确实不报告的合法概念返回空数组。请使用 edgar_company_facts 查看公司实际报告哪些概念。

快速开始

添加到你的 MCP 客户端(Claude Desktop、Cursor、Windsurf 等):

{
  "mcpServers": {
    "edgar": {
      "url": "https://gateway.pipeworx.io/edgar/mcp"
    }
  }
}

这个端点实际提供什么

tools/list 在 https://gateway.pipeworx.io/edgar/mcp 返回上表中的工具,以及共享的 Pipeworx 元工具——ask_pipeworx、discover_tools、search_within、remember/recall 以及其余网关级工具集。因此你看到的工具数量比这个表要多:一个单包端点目前会列出大约 30 个共享工具以及该包自己的工具。连接的 initialize 响应会说明其确切范围,并且是特定日期的权威答案。

这是有意为之,而不是意外的多路复用。元工具正是让限定范围的连接能够回答该包未涵盖的问题——通过 ask_pipeworx,它会在整个目录中路由——而无需你添加第二个 MCP 服务器。目前没有办法在不包含元工具的情况下挂载包端点;如果额外模式消耗的上下文比路由带来的价值还多,请一次性连接到完整网关,而不是连接到多个包端点。

或者连接到完整的 Pipeworx 网关,直接列出每个包的工具,而不仅仅是这一个:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都到达同一个网关和相同的 1476+ 个数据源。唯一的区别是哪个包的工具被直接列出;ask_pipeworx 从两者中的任何一个都能访问所有工具。

与 ask_pipeworx 一起使用

无需直接调用工具,你可以用纯英语提问——这在上面的包端点和完整网关上都可以使用:

ask_pipeworx({ question: "your question about Edgar data" })

网关会自动选择正确的工具并填写参数。

更多

许可证

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables to search and retrieve SEC EDGAR filings, insider transactions, major shareholders, and executive compensation data through natural language.
    13 npm
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables querying of SEC EDGAR filings and financial data via natural language, offering tools for company lookup, filing retrieval, XBRL data, and full-text search.
    72 npm
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides access to SEC EDGAR data through natural language, including company filings, financial statements, and company info, without requiring an API key.
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides free SEC filing fundamentals for US public companies, including financial statements, 10-K/10-Q summaries, and 8-K event histories. No API key or signup required.
    MIT