SuperAPI AI 工具集

alterlab-edgartools

数据与分析

查看项目

更新于 10-15 19:56

技能介绍

用途:通过 edgartools Python 库访问、分析并提取 SEC EDGAR 申报数据,覆盖 1994 年以来全部申报文件及结构化数据。

主要能力:按公司或期间检索 10-K、10-Q、8-K、DEF 14A、S-1、13F、Form 4、SC 13D/G、Form D 等文件;按原样提取财务报表或 XBRL 事实并支持多期拼接;获取申报人层面的内幕交易、机构持仓、代理与薪酬数据;读取公司元数据(CIK、SIC、财年结束日、filer 状态)。

使用方式:先做身份认证,from edgar import set_identity;set_identity("Your Name your.email@example.com"),也可用环境变量 EDGAR_IDENTITY。安装:uv pip install edgartools;AI/MCP 功能用 uv pip install "edgartools[ai]"。查找公司用 Company("AAPL") 或 Company(320193) 或 find("Apple");取文件用 company.get_filings(form="10-K").latest()、get_filings(2024, 1, form="10-K") 或 get_by_accession_number(...);结构化数据用 filing.obj(),财务报表用 company.get_financials()/get_quarterly_financials() 及 income_statement()、balance_sheet()、cash_flow_statement();XBRL 用 filing.xbrl().statements.income_statement();内容读取用 filing.text()/html()/markdown()/open()。API 示例对应 edgartools 5.58.0;5.x 中 cashflow_statement() 已弃用,改用 cash_flow_statement()。

限制与注意:filing.financials 不存在,须用 filing.obj().financials;get_filings() 无 limit 参数,用 .head(n) 或 .latest(n);多期分析建议 amendments=False,访问可选数据前先判 None;默认限速 9 次/秒(EDGAR_RATE_LIMIT_PER_SEC),低于 SEC 的 10 次/秒上限,对 sec.gov 保持默认,否则可能被封 IP;报告每个数字时须引用申报(公司、表格、accession number、申报日期)。不含市场价格、宏观 FRED 序列、Form PF 统计及联邦财政数据,需改用其他技能。