这个 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 注册库验证,且项目由单人维护,长期维护连续性存在风险;
- 本次为静态源码评审,未执行任何代码,示例输出的正确性未经独立验证。
- Shell / 命令行
- 网络访问
- 本地文件系统
- MCP Server
Pythonedgartools 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?
该技能为只读 SEC EDGAR 查询,无文件写入、无网络外发(仅向 SEC 官方端点请求数据)、无凭据要求(SEC 仅要求署名身份,set_identity 数据流向透明且在文档中明确说明)。sharp-edges.yaml 显式披露速率限制、身份要求与错误语义,数据流向清晰。扣分项:发布者身份未经企业注册库验证;set_identity 收集用户邮箱并随请求发送至 SEC,虽为 SEC 强制要求,但技能未明示此隐私影响;无用户确认/回滚机制(对只读场景影响有限)。未达满分。
文档内部高度自洽:skill.yaml、sharp-edges.yaml、validations.yaml 相互引用一致,错误词汇表(TransportError/NotFoundError/None 语义)明确,失败反馈质量高(429 等待策略、渐进式回退链)。仓库含真实 CI 工作流与大规模测试体系,符合静态校准允许突破 10 分上限的条件;但技能本身主要是文档/模式文件,其具体指导路径(如 get_financials 优先级建议)未见专门的技能级测试直接覆盖,且无法静态验证运行时表现,故不给更高分。
场景定义清晰(公司查询、财报检索、全文搜索),collaboration.yaml 明确声明了核心技能的处理边界与委派范围,触发词表具体,token 预算披露。扣分项:核心功能完全依赖 SEC EDGAR(sec.gov/data.sec.gov),该服务在中国大陆网络环境下可达性差且速率限制严格,文档未提供镜像或离线方案(仅提企业镜像);无任何中文支持;边界声明部分依赖其他未在本次评审范围内的技能目录。
信息架构分层良好(SKILL.md 入口 → skill.yaml 模式 → sharp-edges/validations/collaboration),skill.yaml 带版本号 1.1,MIT 许可明确,安装说明与依赖备注详尽(pyproject 注释质量高)。扣分项:无技能级 changelog;维护责任集中于单一维护者(README 自述 'maintained by one person'),更新路径依赖赞助持续性;部分示例数据(如 2025-2026 访问号)可能随时间失效。
对 AI 代理使用 SEC 数据的边际价值明确:将 XBRL 解析压缩为一行调用,str()/to_context() 针对 LLM 输出优化,README 给出了对比替代方案(sec-api)的成本论证,且 CI+测试体系提供了执行证据,允许超过 7 分。扣分项:静态评审无法验证示例输出的实际正确性与完整性(如财务数据标准化质量),效果主张主要来自作者自述。
仓库含真实 CI 工作流(含 cassette 安全门、离线审计、覆盖率 65% 门槛、回归测试追踪)和大量测试基础设施,多数关键主张可审计复核;sharp-edges 自称'来自技能测试的产出'但无对应技能级测试记录佐证。事实与推断基本分离。静态评审未执行任何复现,且技能文档路径本身的测试覆盖不可见,故仅达 5 分上限。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
查看完整评分方法 →