金融与投行

EdgarTools — SEC EDGAR 文件分析技能

用 Python 直接读取 SEC EDGAR 备案文件,把 10-K 财报、Form 4 内幕交易、13F 持仓等变成结构化数据,无需解析原始 XBRL。

67/ 100
推荐

整体可靠,存在已披露的局限;按说明试用并保留回滚路径。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 2.8k
最近更新
11 天前
License
MIT
sec-edgarxbrl10-kform-4
+413f-holdingsfinancial-statementspythonmcp-server

这个 Skill 能做什么,适合哪些场景?

EdgarTools 是一个开源 Python 库,将 SEC EDGAR 备案文件转换为带类型的 Python 对象和 pandas DataFrame,覆盖 20 多种表格类型,历史数据可追溯到 1994 年。它提供标准化财务报表(XBRL)、内幕交易、机构持仓、8-K 事件等数据,并内置 MCP 服务器和面向 LLM 的文本输出。该技能以 SKILL.md 为核心,按 core、financials、reports、holdings、ownership、xbrl 等子目录组织,附有模式示例和常见错误清单。适合在自有代码或 AI 助手中做证券数据分析的团队使用。

  • 通过公司代码(ticker)或 CIK 查找公司,按表格类型、年份检索备案文件,并按 accession 编号定位具体文件
  • 从 10-K/10-Q 提取 XBRL 标准化的利润表、资产负债表、现金流量表
  • 将 Form 3/4/5 内幕交易和 13F 机构持仓解析为结构化对象或 DataFrame
  • 提取 10-K/10-Q/8-K 的章节文本(如风险因素、MD&A),并转为适合 RAG 的干净文本
  • 通过公司 Facts API 查询任意会计概念多年时间序列
适合
  • 量化或研究人员需要批量对比多家公司多年营收、利润等 XBRL 标准化财务指标
  • 合规或投研人员要追踪某公司高管近几个月的 Form 4 内幕买卖记录
  • 分析师想查看对冲基金最新 13F 持仓明细,作为 DataFrame 进一步分析
  • 构建财报问答 RAG 系统的工程师,需要将 10-K 风险因素、MD&A 章节转为干净文本
  • 在 Claude Desktop / Claude Code 中通过自然语言查询 SEC 数据的用户(借助内置 MCP 服务器)
不适合
  • 需要托管 API、由服务商负责运维和 SLA 的团队——开源库需自行运行和维护(作者另有付费托管平台 edgar.tools)
  • 不做 SEC 数据分析、只想泛泛查财报摘要的场景——该技能聚焦 EDGAR 备案文件的结构化解析,不是通用财经资讯工具

如何安装这个 Skill?

使用前请注意
  • 该技能核心功能完全依赖 SEC EDGAR 官方服务,在中国大陆网络环境下可达性差且速率限制严格(429 需等待 10 分钟以上),无镜像配置指引;
  • set_identity 要求提供姓名和邮箱,将随每次 SEC 请求发送,用于 SEC 合规审计,使用前请知悉;
  • 发布者身份未经 FollowSkills 注册库验证,且项目由单人维护,长期维护连续性存在风险;
  • 本次为静态源码评审,未执行任何代码,示例输出的正确性未经独立验证。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 网络访问
  • 本地文件系统
  • MCP Server
需要预先安装
  • Python
  • edgartools package (pip install edgartools)
  • SEC EDGAR identity (name + email)

安装库本身并可选安装 AI 技能:

Claude Code / Claude Desktop(AI Skills,官方推荐)

pip install "edgartools[ai]"
python -c "from edgar.ai import install_skill; install_skill()"

Claude Desktop(MCP 服务器方式)

uvx --from "edgartools[ai]" edgartools-mcp

(需在 claude_desktop_config. 中配置 mcpServers,并设置 EDGAR_IDENTITY 环境变量)

仅作为 Python 库使用

pip install edgartools

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 对比苹果和微软过去 3 年的营收增长率
  • 列出特斯拉高管过去 6 个月卖出超过 100 万美元股票的记录
  • 获取苹果最新 10-K 的利润表和资产负债表
  • 查询最新一份 13F 持仓报告的完整持仓明细

首次使用必须向 SEC 表明身份:from edgar import set_identity; set_identity("Your Name [email protected]"),或在 MCP 部署中设置 EDGAR_IDENTITY 环境变量。核心流程:从 Company 或 Filing 出发,调用 .obj() 得到对应表格类型的带类型对象。常用入口包括 Company("AAPL")、find("accession号")、get_filings(form="10-K", year=2024)。每个对象都有 .docs 属性可搜索 API 用法。技能目录按 core/financials/reports/holdings/ownership/xbrl 划分,各目录含 skill.yaml(模式与示例)和 sharp-edges.yaml(常见错误)。

这个 Skill 有哪些优点和局限?

优点
  • 免费、MIT 许可,无 API key、无配额、无厂商锁定
  • XBRL 标准化财务数据,便于跨公司、跨期间比较
  • 覆盖 20+ 表格类型的带类型对象和 DataFrame 输出
  • 内置 MCP 服务器与 LLM 友好文本输出,适合 RAG 与 AI 工作流
  • 限流感知、智能缓存、支持企业/学术镜像,附 1000+ 测试
局限
  • SEC 每季度修改备案格式、每年更新 XBRL 分类法,20+ 解析器需持续维护,项目由个人维护者支撑
  • 需自行运行与运维——没有托管方的 SLA(企业支持需付费赞助)
  • EDGAR 强制要求随请求提供身份(姓名+邮箱),虽然无需注册 key

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
EdgarTools — SEC EDGAR 文件分析技能 本页 67 · 推荐 ★ 2.8k 11 天前 MIT
StockValuation.io 本地估值工作流 58 · 推荐 ★ 33 1 个月前 Apache-2.0
财报精读:一手资料深度解读 52 · 谨慎使用 ★ 17k 13 天前 MIT
价值投资分析智能体 55 · 谨慎使用 ★ 23 8 个月前 MIT
投资大师方法论库 50 · 谨慎使用 ★ 634 1 个月前 MIT

源材料将 EdgarTools 与 sec-api.io 对比:EdgarTools 是免费、MIT 许可的 Python 库,在本进程内返回带类型对象和 DataFrame,内置 MCP/AI 支持,可自行检查和 fork;sec-api 是每月 49 美元起的托管 API,返回需自行解析的 JSON,需 key 和限流层级,专有闭源。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
推荐
67/ 100 五分制 3.4 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全20 / 25 · 4.0/5

该技能为只读 SEC EDGAR 查询,无文件写入、无网络外发(仅向 SEC 官方端点请求数据)、无凭据要求(SEC 仅要求署名身份,set_identity 数据流向透明且在文档中明确说明)。sharp-edges.yaml 显式披露速率限制、身份要求与错误语义,数据流向清晰。扣分项:发布者身份未经企业注册库验证;set_identity 收集用户邮箱并随请求发送至 SEC,虽为 SEC 强制要求,但技能未明示此隐私影响;无用户确认/回滚机制(对只读场景影响有限)。未达满分。

2可靠稳定13 / 20 · 3.3/5

文档内部高度自洽:skill.yaml、sharp-edges.yaml、validations.yaml 相互引用一致,错误词汇表(TransportError/NotFoundError/None 语义)明确,失败反馈质量高(429 等待策略、渐进式回退链)。仓库含真实 CI 工作流与大规模测试体系,符合静态校准允许突破 10 分上限的条件;但技能本身主要是文档/模式文件,其具体指导路径(如 get_financials 优先级建议)未见专门的技能级测试直接覆盖,且无法静态验证运行时表现,故不给更高分。

3适用触发8 / 15 · 2.7/5

场景定义清晰(公司查询、财报检索、全文搜索),collaboration.yaml 明确声明了核心技能的处理边界与委派范围,触发词表具体,token 预算披露。扣分项:核心功能完全依赖 SEC EDGAR(sec.gov/data.sec.gov),该服务在中国大陆网络环境下可达性差且速率限制严格,文档未提供镜像或离线方案(仅提企业镜像);无任何中文支持;边界声明部分依赖其他未在本次评审范围内的技能目录。

4规范维护12 / 15 · 4.0/5

信息架构分层良好(SKILL.md 入口 → skill.yaml 模式 → sharp-edges/validations/collaboration),skill.yaml 带版本号 1.1,MIT 许可明确,安装说明与依赖备注详尽(pyproject 注释质量高)。扣分项:无技能级 changelog;维护责任集中于单一维护者(README 自述 'maintained by one person'),更新路径依赖赞助持续性;部分示例数据(如 2025-2026 访问号)可能随时间失效。

5有效结果9 / 15 · 3.0/5

对 AI 代理使用 SEC 数据的边际价值明确:将 XBRL 解析压缩为一行调用,str()/to_context() 针对 LLM 输出优化,README 给出了对比替代方案(sec-api)的成本论证,且 CI+测试体系提供了执行证据,允许超过 7 分。扣分项:静态评审无法验证示例输出的实际正确性与完整性(如财务数据标准化质量),效果主张主要来自作者自述。

6证据核验5 / 10 · 2.5/5

仓库含真实 CI 工作流(含 cassette 安全门、离线审计、覆盖率 65% 门槛、回归测试追踪)和大量测试基础设施,多数关键主张可审计复核;sharp-edges 自称'来自技能测试的产出'但无对应技能级测试记录佐证。事实与推断基本分离。静态评审未执行任何复现,且技能文档路径本身的测试覆盖不可见,故仅达 5 分上限。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年9月9日 审查版本 40fcce88eba7 评估证据[1][2][3][4][5][6][7][8][9][10][11][12][13][14]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

需要注册 API key 吗?
不需要。EDGAR 只要求每次请求附带身份标识,调用 set_identity 设置姓名和邮箱即可,无注册、无费率层级。
费用是多少?
库本身免费且 MIT 许可。生产团队可通过 GitHub Sponsors 购买每月 250–1500 美元的企业支持(含响应 SLA 等);另有付费托管平台 edgar.tools 可选。
数据能覆盖多早?
完整备案历史可追溯到 1994 年,并覆盖 10-K、10-Q、8-K、13F、Form 4、DEF 14A、S-1、N-PORT 等 20+ 表格类型。
在 AI 客户端中怎么用?
两种方式:安装 AI 技能(pip install "edgartools[ai]" 后运行 install_skill()),或作为 MCP 服务器接入 Claude Desktop、Cline 等客户端。

相关 Skills