filingrail-mcp (SEC EDGAR data)

filingrail-mcp — 在 Claude、Cursor 和任何 MCP Agent 中查看 SEC EDGAR 文件

为你的 AI Agent 提供实时 SEC EDGAR 数据：公司财务数据、内部人士交易、8-K 事件、13F 持仓和原始文件流——全部规范化为整洁的 JSON，每个数字都可追溯到其 sec.gov 来源文件。

只需一次 pip install 和一个 API 密钥，你的 Agent 就能根据真实文件（而非训练数据）回答 “Apple 上季度的现金状况如何？” 或 “列出 Berkshire Hathaway 截至 2026-Q1 的前 10 大持仓”。

pip install filingrail-mcp

已在 PyPI 上线： pypi.org/project/filingrail-mcp · MIT 许可 · Python 3.10+

为什么要做这个项目

上市公司向 SEC 报告的每个数字都可以在 EDGAR 上免费公开。瓶颈不在于访问权限，而在于 XBRL 解析器、标签漂移规范化器、速率限制调度器和去重层——你必须先编写这些，才能拿到真正想要的那个数字。filingrail-mcp 会直接把整理好的 JSON 提供给你的 Agent。

• 来源可追溯。 每条财务数据响应都包含来源文件的 source_filing_url。点击即可查看 sec.gov 上的确切 10-K / 10-Q 文件。绝不要求你“盲目信任”。
• 已规范化。 无论申报方使用 us-gaap:Revenues、SalesRevenueNet 还是 RevenueFromContractWithCustomerExcludingAssessedTax 标签，revenue 始终就是 revenue。包含追溯至 2006 年的 180 万多条 XBRL 记录。
• 无需处理繁琐配置。 无需配置 EDGAR User-Agent、无需本地解析器，也无需速率限制调度器。API 会处理所有这些工作。

获取密钥（免费层级，无需银行卡）

Filingrail 是一个托管在 RapidAPI 上的 REST API。免费层级每天可调用 50 次，无需信用卡：

→ 在 RapidAPI 上订阅 Filingrail 并复制你的 X-RapidAPI-Key。

最终用户需自备密钥——在 MCP 客户端配置中将其设为 RAPIDAPI_KEY（见下文）。

配置你的 Agent

Claude Desktop

编辑 %APPDATA%/Claude/claude_desktop_config.json（Windows）或 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

{
  "mcpServers": {
    "filingrail": {
      "command": "filingrail-mcp",
      "env": { "RAPIDAPI_KEY": "your-rapidapi-key-here" }
    }
  }
}

重启 Claude Desktop。Filingrail 工具（search_companies、get_financials、get_insider_trades，等等）会出现在工具列表中。然后只需用普通英语提问即可。

Cursor / Continue / 任何其他 MCP 客户端

将客户端指向 filingrail-mcp，将其设为 stdio 命令，并传入环境变量 RAPIDAPI_KEY。格式与上文相同。

如果你的客户端只接受原始命令，请使用：

{ "command": "filingrail-mcp", "env": { "RAPIDAPI_KEY": "your-rapidapi-key-here" } }

提供的工具

工具	功能
search_companies(q, limit)	将股票代码 / CIK / 名称片段解析为公司（8,000 多家 SEC 发行方，模糊匹配）
get_recent_filings(form_type, cik, limit)	最新文件流——可按表格类型（10-K、8-K、4、13F-HR）或 CIK 筛选
get_financials(ticker_or_cik, limit)	最新 10-K / 10-Q 规范化项目 + source_filing_url
get_financials_history(ticker_or_cik, period, limit, …)	历史季度或年度序列
get_insider_trades(ticker_or_cik, since, limit)	Form 4 交易——谁买入 / 卖出、何时、交易金额
get_8k_events(ticker_or_cik, since, limit)	8-K 重大事件及 SEC 条目代码（5.02、2.01，等等）
get_13f_holdings(institution_cik, quarter, limit)	机构持仓（例如，Berkshire = CIK 1067983）
health()	API 存活状态检查

试用

安装并完成配置后，向你的 Agent 提问：

• “Apple 上季度的营收和营业收入是多少？请给我文件链接。”
• “显示 NVIDIA 最近 30 天的内部人士卖出记录。”
• “Tesla 本月提交了哪些 8-K 事件？”
• “列出 Berkshire Hathaway 在 2026-Q1 的 10 大 13F 持仓。”

它不是什么

请留意以下限制：

• 非实时。 EDGAR 接收新文件后约 24 小时内，这些文件才会显示（公平访问政策）。
• 不是 Bloomberg。 不提供日内价格、期权链、非美国发行方数据或分析师预估。
• 结构化 SEC 数据，可追溯至来源——这就是本产品的全部内容。

定价

套餐	价格	每月调用次数
免费版	$0	1,500（每天 50 次）
Pro	$9/月	5,000
Ultra	$49/月	50,000
Mega	$199/月	500,000

密钥和账单由 RapidAPI 处理。立即获取 →

链接

• 获取 API 密钥（RapidAPI 页面）
• Filingrail 首页
• Python SDK（同步 + 异步） — pip install filingrail
• API 状态页面
• 问题 / 故障：[email protected]

许可证

MIT © Hudson Enterprises LLC