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)。