用途:从美国政府官方来源检索正式文件,用于尽职调查与监管研究,并保证数据来源可追溯。
主要能力:SEC EDGAR 可获取上市公司的 10-K(年报)与 10-Q(季报)申报文件;Federal Register 用于查询机构新规则(资料标注为未来功能);可将 HTML 申报文件转换为纯文本以便分析;支持按章节定向提取,如自动抽取“Risk Factors”;在未知股票代码时可按公司名称查询(例如用 Google 查 Alphabet Inc.)。
使用方式:运行 Python 脚本 fetch_filing.py 获取 SEC 文档。参数包括:ticker(必填,股票代码或部分公司名)、--type(可选,表单类型,默认 10-K)、--count(可选,获取数量,默认 1)、--clean-text(可选,下载并去除 HTML 标签)、--section(可选,risk 表示风险因素,mda 表示管理层讨论,隐含启用 --clean-text)。示例:python3 fetch_filing.py "Google" --type 10-K --section risk;python3 fetch_filing.py TSLA --type 10-Q --clean-text。
输出格式:脚本输出 JSON 对象,包含 cik(Central Index Key)、company_name、filings(含 primaryDocumentUrl 指向 HTML 文档的直链,以及 content 提取的文本,可能被截断或为完整章节)。
限制与提示:HTML 占用空间较大,仅在需要阅读内容时使用 --clean-text,因为它会额外发起 HTTP 请求而变慢;名称搜索可直接传公司名而非股票代码。Federal Register 支持情况、收费与价格、平台要求等资料暂未提供。