edgartools 是用于访问、分析和提取 SEC EDGAR 申报文件数据的 Python 库，可获取 1994 年以来的全部 SEC 申报并做结构化提取。
用途：处理 SEC 申报、财务报表（利润表、资产负债表、现金流量表）、XBRL 数据等。
认证：SEC 要求 API 访问需身份标识，操作前须设置：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]"。
主要能力：按 ticker、CIK 或名称查找公司（Company、find）；获取公司或全局申报（company.get_filings、get_filings、get_by_accession_number）；提取结构化数据（filing.obj() 返回 TenK、EightK、Form4、ThirteenF 等）；获取财务报表（get_financials、get_quarterly_financials、income_statement、balance_sheet、cashflow_statement）；解析 XBRL（filing.xbrl()）；访问内容（text、html、markdown、open）。
常见陷阱：filing.financials 不存在，应使用 filing.obj().financials；get_filings() 无 limit 参数，用 .head(n) 或 .latest(n)；多期分析建议 amendments=False；访问可选数据前先检查 None。
限制：资料未提供收费、价格、平台与效果信息。