SEC 美股 EDGAR 公告检索与年报下载工具

解决什么问题

美股审计、合规和财务分析中，经常需要从 SEC EDGAR 获取特定公司某段时间的公告，手动找 CIK、翻索引、下载 PDF/HTM 很碎。该技能把 Ticker、日期范围、表单类型转成可重复执行的检索与下载流程。

工作方式

• 基于 SEC 公开 JSON API：先用 company_tickers.json 将 AAPL 等映射为 CIK，再查 submissions/CIK...json。
• 支持 search 与 download 两个子命令：搜索元数据或搜索并下载主文档。
• 可按 --form 过滤 10-K、10-Q、8-K、20-F 等，并用 --max-records 控制返回量。
• 输出结构化 JSON 或 .xlsx，包含 document_url、index_url、filing_date、report_date 等字段。

边界与注意

它面向公开披露文件的检索和下载，不解析财报指标，也不做审计结论。SEC API 要求 User-Agent，脚本需内置限速（10 req/s）。下载格式取决于原始文件，常见为 .htm、.html、部分 .pdf。