用途:该技能用于通过 EdgarTools 访问和分析美国 SEC EDGAR 申报文件,适合查询公司财报、10-K/10-Q 分析、内部人交易、收入趋势等场景。
必要准备:SEC 要求身份识别,任何操作前须先运行 from edgar import set_identity 并调用 set_identity("Your Name your.email@example.com"),否则操作会失败。需安装依赖:pip install edgartools。
主要能力:提供三种访问方式——get_filings 批量跨公司查询、get_current_filings 实时监控当日申报、Company 按股票代码或 CIK 查询单一公司。可获取 Entity Facts API 的多期财务数据(income_statement、balance_sheet、cash_flow_statement),或通过 filing.xbrl() 获取单期详细 XBRL 数据。支持在申报文件内搜索文本,以及 filing.items() 获取风险因素、MD&A 等章节。
使用方式:优先调用 .to_context() 获取摘要以节省 token,再按需深入。例如 company = Company("AAPL");income = company.income_statement(periods=5)。常见工作流包括跨公司收入对比、最新 10-K 分析、Form 4 内部人交易跟踪、多年度财务趋势。
限制与注意:不要从原始文本解析财务数据,应使用结构化 XBRL;filing.text() 开销大(约 5 万 token 以上),仅在必要时使用。filing.search() 搜索文件内容,filing.docs.search() 搜索 API 文档,二者不可混淆。资料未提供具体收费、价格或平台支持信息。