SEC EDGAR数据访问工具

一个通过MCP协议为LLM提供直接访问SEC EDGAR数据的服务,支持搜索文件、提取章节、获取结构化财务数据和跟踪内幕交易。

  • by cmanohar
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 cmanohar/mcp-edgar

使用说明

麦克普·埃德加

一 MCP(模型上下文协议) 该服务器使LLM可以直接访问SEC EDGAR——搜索文件、提取部分、提取结构化财务数据和跟踪内幕交易。

不需要API密钥。 SEC EDGAR完全公开。

快速开始

添加到您的MCP客户端配置(Claude Code、Cursor、Windsurf等):

{
  "mcpServers": {
    "sec-edgar": {
      "command": "npx",
      "args": ["-y", "mcp-edgar"]
    }
  }
}

就是这样。不需要配置。

工具

归档发现

工具 说明
edgar_search 按股票代码+表格类型搜索文件(10-K、10-Q、8-K、DEF 14A、S-1、20-F、6-K)
edgar_full_text_search 在所有SEC文件中进行全文关键字搜索——查找提及特定药物、技术、风险等的文件。
edgar_company_info 公司元数据——名称、SIC代码、行业、公司注册地、财政年度末、最近的备案摘要

备案内容

工具 说明
edgar_get_filing 获取特定归档的文件索引(证物清单、主要文件等)
edgar_get_section 从文件中提取MD&A、风险因素、业务或财务信息(最多12K个字符)

结构化财务数据(XBRL)

工具 说明
edgar_company_facts 所有关键财务数据——收入、净收入、每股收益、资产、负债、研发、现金、债务。跨时期的时间序列。
edgar_company_concept 深入了解所有申请期的单一指标(如收入)。完整的时间序列,包括财政年度/季度细分。

内幕交易

工具 说明
edgar_insider_transactions 最近内部人士从表格4的文件中购买、出售、奖励、行使。官员姓名、职务、股份、价格。

示例提示

连接后,您可以询问您的法学硕士:

  • “NVIDIA最近提交的10-K文件是什么?”
  • “从苹果最新年报中提取风险因素部分”
  • “给我看看特斯拉过去5年的收入趋势”
  • “最近谁在买卖微软股票?”
  • “查找2024年所有提及‘GLP-1受体激动剂’的SEC文件”
  • “比较亚马逊和谷歌过去3年的研发支出”
  • “辉瑞的SIC行业代码和财政年度结束时是什么?”

典型工作流程

大多数分析都遵循这种模式:

1. edgar_company_info    → Get company overview and CIK
2. edgar_search          → Find specific filings (10-K, 10-Q, 8-K)
3. edgar_get_section     → Read MD&A, Risk Factors, etc.
4. edgar_company_facts   → Pull structured financials for comparison
5. edgar_insider_transactions → Check insider activity

环境变量

变量 默认值 描述
SEC_EDGAR_USER_AGENT mcp-edgar/0.1.0 (github url) SEC要求用户代理提供公司名称和电子邮件。覆盖此项以识别您自己。

速率限制

服务器包括一个内置的速率限制器(10个请求/秒),以符合sec的 公平准入政策。无需配置。

发展

git clone https://github.com/cmanohar/mcp-edgar.git
cd mcp-edgar
npm install
npm run build
node dist/index.js  # runs on stdio

运作原理

此服务器封装了三个SEC EDGAR API:

  • 提交API (data.sec.gov/submissions/)--公司信息、归档历史
  • API XBRL (data.sec.gov/api/xbrl/)--结构化财务数据
  • EFTS (efts.sec.gov/LATEST/)--对所有文件进行全文搜索
  • 档案 (sec.gov/Archives/edgar/)--原始归档文档(HTML、XML)

所有API都是免费的、公开的,不需要身份验证,只需要一个描述性的User-Agent标头。

许可证

麻省理工学院