SEC EDGAR

SEC EDGAR MCP 服务 🏛️

通过 SEC EDGAR，为 Claude Desktop 和任何兼容 MCP 的客户端提供美国 SEC 申报文件和财务数据。搜索公司、获取申报文件（10-K、10-Q、8-K、Form 4 等）、读取 XBRL 财务数据，以及对所有申报文件进行全文搜索——只需使用自然语言即可。无需 API 密钥。

npm 包： edgar-mcp  ·  GitHub 仓库： danishashko/edgar-mcp。

🎯 你将获得

• 🔎 按名称或股票代码查找公司 → CIK
• 🗂️ 近期申报文件（任意表格类型），附带文档直达链接
• 📄 最新申报文件：一次调用即可获取某种类型的最新文件（最新 10-K / 10-Q / 8-K）
• 💰 基于 XBRL 的财务要点（营收、净利润、资产、权益、每股收益）
• 📈 概念历史记录——随时间查看任意 GAAP 项目
• 🔬 对近 10 年的申报文件进行全文搜索

默认情况下，每个工具都返回易于阅读的 Markdown，也可按需返回结构化 JSON（response_format: "json"）。轻量级（仅依赖 Python 标准库和 mcp），无需 API 密钥，并会在遇到速率限制时重试。

🚀 快速开始

将以下内容添加到 Claude Desktop 配置中，然后重启 Claude：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "edgar": {
      "command": "npx",
      "args": ["-y", "edgar-mcp"],
      "env": {
        "SEC_USER_AGENT": "your-app-name [email protected]"
      }
    }
  }
}

SEC 要求每个 API 客户端发送带有联系信息的描述性 User-Agent。请将 SEC_USER_AGENT 设置为你自己的姓名和邮箱（已提供默认值，因此开箱即用）。首次启动时，npx 封装程序会创建隔离的 Python 环境并安装依赖项（仅需一次，约一分钟）。你需要 Python 3.10+ 和 Node.js 16+。

更倾向于全局安装？

npm install -g edgar-mcp

{
  "mcpServers": {
    "edgar": {
      "command": "edgar-mcp",
      "env": { "SEC_USER_AGENT": "your-app-name [email protected]" }
    }
  }
}

🔧 可用工具

工具	返回内容	参数
search_company	与名称或股票代码匹配的公司及其 CIK	query、limit
get_recent_filings	近期申报文件（表格类型、日期、链接），可选表格筛选条件	identifier、form_type、limit
get_latest_filing	指定类型的最新申报文件及文档链接	identifier、form_type
get_company_facts	主要财务数据（营收、净利润、资产、权益、现金、每股收益）	identifier
get_concept	单个 XBRL 概念随时间报告的历史记录	identifier、concept、limit
full_text_search	在所有公司的申报文件中查找匹配关键词或短语的内容	query、forms、limit

每个工具也接受 response_format（默认值为 "markdown"，或 "json"）。identifier 可接受股票代码、CIK 或公司名称。

get_concept 的常见 XBRL 概念： Revenues / RevenueFromContractWithCustomerExcludingAssessedTax、NetIncomeLoss、Assets、Liabilities、StockholdersEquity、EarningsPerShareDiluted。

💬 示例提示词

连接服务后，直接向 Claude 提问：

• “Apple 最新的 10-K 是什么？”
• “给我看看 Tesla 近期的 8-K 申报文件。”
• “Microsoft 的主要财务数据有哪些？”
• “给我看看 NVIDIA 过去几年的净利润。”
• “哪些公司的 10-K 提到了‘量子计算’？”
• “查找 Berkshire Hathaway 的 CIK。”

🐛 故障排查

“SEC EDGAR 正在限制请求频率” EDGAR 每秒允许约 10 个请求。服务会自动重试；如果问题仍然存在，请稍等片刻。

“未找到” 先使用 search_company 确认准确的股票代码或 CIK。

“找不到命令”/“找不到 Python” 确保已安装 Python 3.10+ 和 Node.js 16+，并且它们位于 PATH 中。在 macOS/Linux 上，请尝试使用 python3。

Claude 中没有显示工具

1. 确认配置文件是有效的 JSON（没有尾随逗号）。
2. 完全退出并重新打开 Claude Desktop。

使用其他模型或提供商（LiteLLM、OpenRouter、NVIDIA NIM、本地模型） 此服务从不与模型通信。客户端会将其作为本地进程启动，并通过 stdin/stdout 使用 JSON-RPC 进行通信，因此更改 ANTHROPIC_BASE_URL 或替换客户端背后的模型都不会影响它。如果切换后工具停止调用，请检查两点：模型必须支持函数调用；此外，如果代理配置为丢弃不受支持的参数，就可能静默移除工具定义，且完全不会报错。在怀疑服务之前，请先在客户端中运行 /mcp（或运行 claude mcp list），确认服务已连接。

🛠️ 手动安装（替代方式）

如果你更愿意直接运行 Python 文件，而不是通过 npx 运行：

1. 下载服务并安装依赖

pip install mcp

（在 macOS/Linux 上也可以使用 pip3）

2. 将 Claude Desktop 指向该服务

{
  "mcpServers": {
    "edgar": {
      "command": "python3",
      "args": ["/absolute/path/to/edgar_mcp.py"],
      "env": { "SEC_USER_AGENT": "your-app-name [email protected]" }
    }
  }
}

在 Windows 上使用 "command": "python"，路径格式如 "C:\\path\\to\\edgar_mcp.py"。

3. 重启 Claude Desktop。

🔒 隐私与速率限制

• 使用官方 SEC EDGAR API——公开 API，无需密钥。
• 请求直接从你的计算机发送到 SEC。不会存储或代理任何内容。
• SEC 要求使用包含联系信息的描述性 User-Agent，并将请求频率限制为每秒约 10 个请求。
• 适用于个人、教育和研究用途。

📝 备注

• identifier 支持多种格式：股票代码（AAPL）、CIK（320193）或名称（Apple）。
• 财务数据来自 XBRL；SEC 于 2009 年首次要求使用该格式，因此大多数申报者的历史数据都可追溯至该年。
• get_company_facts 返回重点数据；如需获取某项指标的完整序列，请使用 get_concept。

📋 更新日志

完整版本历史请参阅 CHANGELOG.md。

📚 资源

• Model Context Protocol
• SEC EDGAR API 文档
• EDGAR 全文搜索

⚖️ 法律免责声明

此工具使用 SEC EDGAR 公共 API，但与美国证券交易委员会无关联，也未获得其认可。使用须遵守 SEC 的网站政策。所提供的数据按“原样”提供，仅供个人、教育和研究用途；在依赖这些数据之前，请对照原始申报文件进行核实。

👤 作者

Daniel Shashko

• GitHub： @danishashko
• LinkedIn：daniel-shashko
• npm：danielshashko

📄 许可证

MIT © Daniel Shashko