sec-edgar-downloader 是一个轻量级 Python 包,专门用于从 SEC EDGAR 数据库批量下载公司公告文件。它支持按 ticker 或 CIK 搜索,可以下载 10-K、10-Q、8-K、13-F、S-1、DEF 14A 等几乎所有 SEC 表单类型,并自动保存为本地文件目录结构。GitHub 660+ 星,长期维护。 sec-edgar-downloader 的设计哲学是“只做下载、做好下载”:它不试图解析文件内容,而是提供可靠、合规、可配置的批量下载能力。通过 Downloader 类的 get() 方法,可以指定表单类型、ticker/CIK、下载数量(最近 N 份或全部)、日期范围,文件自动保存到本地目录。它遵守 SEC 的 User-Agent 要求和速率限制。 对银行而言,sec-edgar-downloader 适合作为 RAG(检索增强生成)管道的数据采集前端。例如,银行合规团队想构建一个“SEC 披露问答系统”,第一步就是用 sec-edgar-downloader 批量下载目标公司的历史 10-K/10-Q,然后用 LangChain + 向量数据库建索引。与 edgartools 相比,sec-edgar-downloader 更轻量、更专注于文件下载而非结构化解析。 实际使用中,它通常与 sec-parser(解析语义树)、edgartools(结构化 Python 对象)或自定义 NLP pipeline 搭配,形成完整的“SEC 数据采集 → 解析 → 分析”流水线。 局限性:只做下载、不做解析——下载后的 HTML/XML 文件需要用其他工具处理;仅覆盖 SEC EDGAR;大规模下载需注意 SEC 速率限制(10 请求/秒)和磁盘空间。
项目主要介绍
sec-edgar-downloader 是一个轻量级 Python 包,专门用于从 SEC EDGAR 数据库批量下载公司公告文件。它支持按 ticker 或 CIK 搜索,可以下载 10-K、10-Q、8-K、13-F、S-1、DEF 14A 等几乎所有 SEC 表单类型,并自动保存为本地文件目录结构。GitHub 660+ 星,长期维护。
sec-edgar-downloader 的设计哲学是“只做下载、做好下载”:它不试图解析文件内容,而是提供可靠、合规、可配置的批量下载能力。通过 Downloader 类的 get() 方法,可以指定表单类型、ticker/CIK、下载数量(最近 N 份或全部)、日期范围,文件自动保存到本地目录。它遵守 SEC 的 User-Agent 要求和速率限制。
对银行而言,sec-edgar-downloader 适合作为 RAG(检索增强生成)管道的数据采集前端。例如,银行合规团队想构建一个“SEC 披露问答系统”,第一步就是用 sec-edgar-downloader 批量下载目标公司的历史 10-K/10-Q,然后用 LangChain + 向量数据库建索引。与 edgartools 相比,sec-edgar-downloader 更轻量、更专注于文件下载而非结构化解析。
实际使用中,它通常与 sec-parser(解析语义树)、edgartools(结构化 Python 对象)或自定义 NLP pipeline 搭配,形成完整的“SEC 数据采集 → 解析 → 分析”流水线。
局限性:只做下载、不做解析——下载后的 HTML/XML 文件需要用其他工具处理;仅覆盖 SEC EDGAR;大规模下载需注意 SEC 速率限制(10 请求/秒)和磁盘空间。
金融 + AI 核心特点
- 支持几乎所有 SEC 表单类型的批量下载
- 按 ticker/CIK、日期范围、数量灵活配置
- 自动生成目录结构,方便后续解析
- 合规 User-Agent 和速率限制
可学习内容
- 理解 SEC EDGAR 的文件体系和表单分类
- 学习如何构建合规的公告数据采集管道
应用方向
- SEC 披露 RAG 系统的数据采集层
- 投研团队的历史公告批量归档
- 合规审计中的 SEC 披露留档
- 金融 NLP 训练数据采集
风险与局限
仅下载不解析,需搭配解析工具;SEC 速率限制对大规模采集有制约;仅覆盖美股 SEC;大量文件下载需要可观磁盘空间。
- 项目地址:https://github.com/jadchaar/sec-edgar-downloader ↗
- 开源协议:MIT
原始来源与整理依据
文字分析来自内容源;业务分类、技术标签由 SeekingDAO 按规则整理。披露效果保留原有时间、范围和预测口径,未作独立审计。开源项目与 Skill 的当前许可、兼容性及依赖请以其上游为准。