SuperAPI AI 工具集

edgartools

编程与开发

查看项目

更新于 10-15 23:42

技能介绍

edgartools 是访问 SEC EDGAR 备案的 Python 库,支持自1994年以来的备案检索与结构化数据提取。

用途:查找公司、获取备案、提取财务报表(利润表、资产负债表、现金流量表)和 XBRL 数据,适合金融分析与 LLM 处理。

主要能力:按代码、CIK 或名称查找公司;获取公司或全局备案;通过 filing.obj() 得到表单对象(TenK、EightK、Form4、ThirteenF、ProxyStatement、Schedule13、FormD 等);导出财务数据;读取文本、HTML、Markdown;查看公司属性如行业、流通股等。

使用方式:先安装 uv pip install edgartools,AI/MCP 功能用 uv pip install "edgartools[ai]"。SEC 要求身份识别,须先执行 from edgar import set_identity; set_identity("Your Name your.email@example.com"),或用环境变量 EDGAR_IDENTITY。

注意:filing.financials 不存在,应使用 filing.obj().financials;get_filings() 没有 limit 参数,用 .head(n) 或 .latest(n);多期分析建议 amendments=False;访问可选数据前检查 None。

限制:资料未提供收费、价格、平台和实际效果信息;仅面向 SEC EDGAR 数据。复杂多步工作流可考虑 K-Dense Web(www.k-dense.ai)。