EdgarParser MCP

edgar-mcp

面向 AI Agent 的 SEC EDGAR 财务数据，通过 MCP 标准输入/输出服务提供。

安装

pip install edgar-mcp

配置

变量	必需	用途
EDGAR_API_KEY	托管工具	托管 EDGAR API 的 API 密钥；get_issuer_submissions_meta 不使用此密钥。
EDGAR_API_URL	否	覆盖 API 基础 URL。默认值为 https://www.edgarparser.com。
EDGAR_MCP_OUTPUT_DIR	否	output="file" 工具响应的目录。

Claude Desktop / Claude Code 配置：

{
  "mcpServers": {
    "edgar-financials": {
      "type": "stdio",
      "command": "edgar-mcp",
      "env": {
        "EDGAR_API_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}

工具清单

此软件包提供 32 个公开 MCP 工具。以下清单由驱动托管 API 文档的同一份清单生成。

工具	概要	层级	缓存行为
get_filings	返回一个股票代码指定期间的申报元数据和 SEC accession 详情。	public	cache_only
get_event_filings	按股票代码、CIK、日期范围、表单类型或查询发现事件申报。	public	cold_allowed
describe_filing	显示一份申报中财务数据、章节、表格、Markdown 和提取内容的缓存可用情况。	public	cache_only
get_filing_document	返回可读的 Markdown 申报文档，并支持章节筛选和分页。	registered	cold_allowed
get_filing_sections	提取选定的定性申报章节以及可选的嵌入表格。	public	cold_allowed
get_filing_cover_facts	返回带引用的精确 DEI 封面事实，例如流通股数。	registered	cold_allowed
get_filing_evidence	为 SEC 定性问题规划并检索可直接引用的申报证据。	paid	llm_call
get_issuer_submissions_meta	直接从 SEC 公共 JSON 端点返回发行人的 SEC 申报标题元数据。	public	cold_allowed
get_operational_kpi_drivers	研究申报叙述和 Markdown 表格，获取运营 KPI 数值及驱动因素背景。	paid	llm_call
get_operational_kpi_driver_rows	返回严格的、由生产方负责的运营 KPI 驱动因素行 DTO，不进行传输层重新解释。	paid	cold_allowed
get_filing_extractions	返回一份申报的缓存 langextract 片段，或在缓存未命中时运行付费提取。	paid	llm_call
search_extractions	使用结构化筛选条件搜索多份申报中的缓存 langextract 片段。	paid	cache_only
get_extraction_series	返回缓存 langextract 片段按期间统计的数量和可选命中项。	paid	cache_only
extract_filing_file	对由 get_filing_sections 签发的短期有效申报文件运行选定的提取架构。	internal	llm_call
list_extraction_schemas	列出内部文档 API 可用的文档提取架构。	internal	cache_only
get_filing_tables	返回申报表格元数据或一份已填充的结构化表格。	public	cold_allowed
search_filing_tables	跨股票代码和期间范围搜索缓存的申报表格元数据。	public	cache_only
compare_filing_tables	比较多个股票代码中相匹配的申报表格。	public	cache_only
search_filing_text	搜索一份申报中的缓存 Markdown，并返回匹配片段。	registered	cache_only
get_financials	返回一个财年申报期间中由匹配器生成的数值财务数据行。	public	cache_only
get_filing_facts	从一个确切的 SEC 申报 accession 中检索精确 QName 事实，或整份报表及披露的列报实例。	registered	cold_allowed
get_metric	返回一个已发现的指标或 XBRL 标签及其当前值、前期值和同比值。	public	cache_only
get_metric_series	返回一个指标在多个期间的数值，并附带每个期间的缓存和覆盖状态。	public	cache_only
list_metrics	列出一个申报期间内可用的精确指标候选项。	public	cache_only
search_metrics	根据自然语言查询搜索申报指标，并返回按相关性排序的精确候选项。	public	cold_allowed
get_statement	根据缓存概念返回由模板支持的利润表、资产负债表或现金流量表。	public	cache_only
get_concept	从缓存的申报事实中解析一个由注册表支持的财务概念。	public	cache_only
compare_concept	在调用方提供的一组股票代码中比较一个由注册表支持的概念。	public	cache_only
concept_trend	返回指定期间范围内仅从缓存读取的概念时间序列。	public	cache_only
cite_concept	将由注册表支持的概念值与申报正文及可选的提取证据关联起来。	paid	cache_only
warm_metric_cache	将付费层级的指标期间后台预热任务加入队列，以供后续读取。	paid	cold_allowed
warm_metric_cache_status	轮询由 warm_metric_cache 返回的后台缓存预热任务。	paid	cache_only

工具类别

申报元数据和文件

get_filings、get_event_filings、describe_filing、get_filing_document、get_filing_sections、get_filing_cover_facts、get_filing_evidence、get_issuer_submissions_meta

运营 KPI

get_operational_kpi_drivers、get_operational_kpi_driver_rows

LangExtract

get_filing_extractions、search_extractions、get_extraction_series、extract_filing_file、list_extraction_schemas

申报表格

get_filing_tables、search_filing_tables、compare_filing_tables

申报文本

search_filing_text

XBRL 和概念

get_financials、get_filing_facts、get_metric、get_metric_series、list_metrics、search_metrics、get_statement、get_concept、compare_concept、concept_trend、cite_concept、warm_metric_cache、warm_metric_cache_status

运行说明

• 这是托管 EDGAR API 和 SEC 公开提交接口的轻量客户端；不会在本地解析申报文件。
• 缺少或无效的 EDGAR_API_KEY 不会阻止服务启动，但调用托管 API 工具时会返回身份验证错误；get_issuer_submissions_meta 无需密钥。
• 大型负载工具支持 output="file"，并会将文件写入 EDGAR_MCP_OUTPUT_DIR 或本地备用目录。
• API 速率限制和付费工具访问权限由托管服务执行。

链接

• 托管 API：https://www.edgarparser.com
• 文档：https://docs.edgarparser.com
• MCP 设置：https://docs.edgarparser.com/mcp
• 工具参考：https://docs.edgarparser.com/tools
• 更新日志 RSS：https://docs.edgarparser.com/rss.xml
• 应用内开发者页面：https://www.edgarparser.com/developers
• 开源解析器包：https://github.com/henrysouchien/edgar-parser
• 源代码包：https://github.com/henrysouchien/edgar-mcp