🏛️

美股 SEC 报告分析 MCP

v0.1.2

事实提取已验证本地运行最近验证 2026-06-15

该 MCP 服务支持通过 EDGAR 接口发现并下载美股上市公司的 SEC 报告（如 10-K 和 10-Q），然后使用 edgartools 库在本地将其解析为分页的 JSON 格式，最后提供跨页面的全文关键字检索和原始文本按页读取能力，助力智能体分析美股事实。

📖 文档 🔗 源码

§ 快速开始

通过 uvx 运行 (推荐)

{
  "mcpServers": {
    "mcp-sec": {
      "command": "uvx",
      "args": ["agentladle-mcp-sec"],
      "env": {
        "SEC_EMAIL": "your.email@example.com"
      }
    }
  }
}

通过 pip 安装运行

{
  "mcpServers": {
    "mcp-sec": {
      "command": "agentladle-mcp-sec",
      "env": {
        "SEC_EMAIL": "your.email@example.com"
      }
    }
  }
}

§ 工具参考

6 个工具

list_sec_filings

发现公司可用的 SEC 报告文件。仅当用户未提供任何年份/日期信息，或尝试下载因日期错误失败时，才使用此工具查询可用列表。

参数	类型	必填	说明
ticker	string	✓	股票代码，例如 "AAPL"
form	string	—	报告类型过滤，例如 "10-K"。省略则列出所有财务报告类型（10-K、10-Q、20-F、6-K、8-K、40-F）
limit	number	—	最大返回数量，默认 5，最大 20

返回值:FilingInfo[]

download_sec_report

从 EDGAR 下载指定的 SEC 报告（HTML 格式）。每次调用下载一份报告。幂等操作（文件已存在且有效时会跳过）。

参数	类型	必填	说明
ticker	string	✓	股票代码，例如 "AAPL"
form	string	✓	报告类型："10-K"、"10-Q"、"20-F"、"6-K"
report_date	string	✓	报告日期（财政年度截止日期），例如 "2025-01-31"

返回值:string

parse_sec_report

将已下载的 HTML 报告解析为分页 JSON。使用 edgartools 进行专业的 SEC 文档解析（包含分页检测与节点树提取）。

参数	类型	必填	说明
ticker	string	✓	股票代码
form	string	✓	报告类型
report_date	string	✓	报告日期（财政年度截止日期）

返回值:string

keyword_search

跨已解析报告所有页面的全文关键词搜索，结果按 TF-IDF 及位置加权评分排序。

参数	类型	必填	说明
ticker	string	✓	股票代码
form	string	✓	报告类型
report_date	string	✓	报告日期（财政年度截止日期）
keywords	array	✓	1-5 个搜索关键词
match_mode	string	—	"ANY"（默认，任一关键词匹配即可）/ "ALL"（所有关键词都须匹配）
max_results	number	—	最大返回结果数，默认 5，最大 50

返回值:SearchResult[]

get_report_pages

按页码范围读取完整的页面文本内容。

参数	类型	必填	说明
ticker	string	✓	股票代码
form	string	✓	报告类型
report_date	string	✓	报告日期（财政年度截止日期）
start_page	number	✓	起始页码（从 1 开始）
page_count	number	—	返回页数，默认 3，最大 5

返回值:PageContent[]

get_report_toc

在前 10 页中搜索 "Table of Contents" 并获取目录内容，以便进行章节快速定位。

参数	类型	必填	说明
ticker	string	✓	股票代码
form	string	✓	报告类型
report_date	string	✓	报告日期（财政年度截止日期）

返回值:string

§ 使用场景示例

完成配置后，直接向 AI 提问即可：

美股财报研发投入解析

分析 Apple 2024 年报中关于研发支出的段落

使用 list_sec_filings 发现可用文件，通过 keyword_search 跨页搜索 "research and development"，再利用 get_report_pages 提取对应的原版页码内容以深度分析。

财务指标跨回退链查询

特斯拉 2024 年度的营业收入是多少？

首先直接使用 keyword_search。若因本地没有该报告文件而报错，则通过 download_sec_report 触发下载并调用 parse_sec_report 进行解析，最后重新搜索以获取并核实数字。

目录快速导航定位

获取 Microsoft 最新季报 of Contents 以定位风险因素部分

利用 get_report_toc 提取 10-Q 的目录，确定 Risk Factors（风险因素）对应的页码，再使用 get_report_pages 提取该页内容。