SEC EDGAR Insider Trades & Financials

SEC EDGAR MCP（远程）

一个运行在 Cloudflare Workers 上的远程 Model Context Protocol 服务和美国 SEC EDGAR 数据 JSON API。它以精简的 JSON 格式向 AI Agent 提供 Form 4 内部人交易、全市场集中买入、公司申报文件、XBRL 财务数据和 EDGAR 全文搜索，无需解析 XML 或查询 CIK。

• 远程 MCP 端点（Streamable HTTP，无状态）： https://sec-edgar-api.kidriahx.workers.dev/mcp
• 服务卡片： https://sec-edgar-api.kidriahx.workers.dev/.well-known/mcp/server-card.json
• REST API 规范： https://sec-edgar-api.kidriahx.workers.dev/openapi.yaml
• MCP Registry 名称： io.github.monriah-studio/sec-edgar-mcp
• 教程： 为你的 AI Agent 提供 SEC EDGAR 数据：用于内部人交易和 XBRL 财务数据的免费远程 MCP 服务（dev.to）

数据直接来自 SEC EDGAR（公有领域），并遵循 SEC 公平访问规则：声明 User-Agent、全局速率限制约为 8.7 req/s（低于 SEC 的 10 req/s）以及缓存。本项目与 SEC 无关联。不构成投资建议。

工具

工具	返回内容
get_insider_trades	公司（ticker/CIK）或内部人（申报所有者 CIK）的 Form 4 交易：买入或卖出者、职位、股份数、价格、金额、10b5-1 标记和申报文件链接，以及买卖总额。
get_market_insider_buys	整个市场的公开市场内部人买入，按公司分组，并检测集中买入（2 名或更多内部人）。
get_company_filings	最新的 10-K、10-Q、8-K（含项目编号）、S-1、代理声明及其他申报文件，并提供文档直达链接。
get_company_snapshot	来自 XBRL 的收入、利润率、净收入、EPS、现金流、资产负债表和债务，以及同比增长。
get_company_concept	任意 XBRL 标签（例如 NetIncomeLoss、Revenues）的年度或季度历史数据。
search_filings	支持短语、表格和日期筛选的 EDGAR 全文搜索。
resolve_company	Ticker ↔ CIK 查询。

连接客户端

任何支持 Streamable HTTP 的 MCP 客户端都可以直接使用该 URL。例如：

{
  "mcpServers": {
    "sec-edgar": {
      "type": "http",
      "url": "https://sec-edgar-api.kidriahx.workers.dev/mcp"
    }
  }
}

Claude Code 用户可以运行 claude mcp add --transport http sec-edgar https://sec-edgar-api.kidriahx.workers.dev/mcp。不同客户端的配置格式略有不同，具体文件请参阅下方的 Agent 工具包。

如果运营方设置了 MCP_API_KEYS，请通过 Authorization: Bearer <key>、X-API-Key: <key> 或 ?api_key=<key> 发送密钥。上述公共端点无需密钥。

示例提示词：

• “过去 30 天内，哪些公司出现了内部人集中买入（2 名或更多内部人）？”
• “显示 NVIDIA 最近 10 笔内部人卖出交易，以及这些交易是否依据 10b5-1 计划进行。”
• “比较 Apple 今年与去年同期的收入、净利率和债务权益比。”
• “查找今年提及 ‘share repurchase’ 的 8-K 申报文件。”

更多示例见 prompts/。

Agent 工具包

将服务接入 Agent 所需的一切，均已针对实时端点测试：

• docs/SETUP.md：每种客户端的分步设置指南，以及故障排除说明。
• kit/：可直接复制粘贴的配置，适用于 Claude Desktop（通过 mcp-remote 或自定义连接器）、Claude Code、Cursor、VS Code、Windsurf，以及通用的 Streamable HTTP 示例（curl、Node SDK、Python SDK）。
• skills/：四个 Agent Skills（SKILL.md），用于教会 Agent 可靠的工作流：
  • insider-buying-scan：先扫描全市场的集群买入，再查看各公司的交易详情和背景信息
  • company-financial-snapshot：多年 XBRL 表格（营收、净利润、现金），可正确去重各期数据
  • filing-monitor：监控列表的 8-K 摘要，附带解码后的条目编号
  • earnings-prep：财报发布前的一页简报
• prompts/：10 个示例提示词，以及每个提示词应触发的工具。
• test/skills.mjs：运行 node test/skills.mjs，即可针对实时端点执行每个技能工作流（Node 18+，无需安装）。

需要批量或定时获取数据？

此 MCP 服务免费，面向交互式、适合 Agent 使用的小规模查询：每次调用查询一家公司或少量文件。如果你有更大规模的需求，例如获取全市场每日 8-K 提醒、数百个股票代码的文件、指定日期范围内的关键词扫描，或按计划将结果发送到数据集、Webhook 或电子表格，我们还发布了一个基于相同 SEC 数据源构建的付费 Apify Actor：

SEC EDGAR Filings & Financials API（Apify）

• companyFilings：按股票代码获取 8-K 或任何表格类型的文件
• marketFilings：按日期范围获取所有公司所选表格类型的全部文件，并支持 8-K 条目和全文关键词筛选
• financials：获取股票代码列表的 XBRL 快照
• 支持定时运行和变更检测（onlyNewSinceLastRun），因此你只会收到之前未见过的文件
• 按结果付费：每条文件记录 $0.002，每家公司快照 $0.005，并可设置 maxResults 上限。Apify 的免费计划包含每月平台额度。

使用此仓库中的任何内容都不需要它。MCP 服务仍然免费，而 Actor 可供批量和定时任务选用。该 Actor 不包含内部人交易；如需获取此类数据，请使用此服务的 get_insider_trades 和 get_market_insider_buys。

REST 端点

同一个 Worker 还提供 REST API（参见 openapi.yaml）： /v1/insider-trades/{tickerOrCik}、/v1/insider-buys、/v1/filings/{tickerOrCik}、/v1/company/{tickerOrCik}/snapshot、/v1/company/{tickerOrCik}/facts、/v1/company/{tickerOrCik}/concept/{taxonomy}/{tag}、/v1/search、/v1/resolve/{tickerOrCik}，以及 /health。

在本地运行

需要 Node.js 18+。本地开发无需 Cloudflare 账户。

npm install
npx wrangler dev --test-scheduled          # serves http://localhost:8787 (MCP at /mcp)
node test/unit.mjs                         # unit tests
node test/harness.mjs http://localhost:8787   # REST against live EDGAR
node test/mcp.mjs http://localhost:8787       # MCP: lists tools and calls each one
curl "localhost:8787/__scheduled?cron=*/10+*+*+*+*"   # run the insider-buy cron once

可选的本地密钥放在 .dev.vars 中（已被 git 忽略；参见 .dev.vars.example）。

部署你自己的版本（Cloudflare Workers Free）

1. npx wrangler login
2. npx wrangler kv namespace create CACHE，然后将输出的 id 填入 wrangler.toml（[[kv_namespaces]]）。
3. 在 wrangler.toml 中将 SEC_USER_AGENT 设置为你自己的名称和一个受监控的电子邮箱（SEC 公平访问要求）。
4. npx wrangler deploy
5. 可选：npx wrangler secret put MCP_API_KEYS（保护 /mcp）和 npx wrangler secret put RAPIDAPI_PROXY_SECRET（保护 REST）。

Durable Object 速率限制器（SecRateLimiter）和 */10 * * * * cron 会自动创建。

项目结构

• src/index.js：路由器和 REST 端点
• src/sec.js：SEC 客户端、全局速率限制器（Durable Object）、缓存
• src/form4.js：Form 4 XML 解析器
• src/mcp/：MCP 服务（tools.js 定义了 7 个工具）
• test/：单元测试、实时测试框架、MCP 测试、技能工作流冒烟测试（skills.mjs）和示例响应
• kit/：客户端配置；skills/：Agent Skills；prompts/：示例提示词；docs/SETUP.md：设置指南
• server.json：MCP Registry 元数据

许可证

MIT © 2026 MonRiah Studio。详见 LICENSE。