SEC-Edgar：轻松下载 SEC 文件

对于需要从美国证券交易委员会（SEC）获取财务数据的人来说，浏览 EDGAR 数据库可能是一项艰巨的任务。然而，开源项目 sec-edgar 旨在大幅简化这一过程。

什么是 SEC-Edgar？

SEC-Edgar 是一个 Python 库，旨在让用户能够极其轻松地从 EDGAR 数据库下载定期报告、申报文件和表格。无论您是需要某家公司的最新 10-Q 表格，还是多公司的历史申报文件，该工具都提供了一个简化的解决方案。

主要特性和功能：

• 单一命令下载： SEC-Edgar 的核心优势在于其能够通过一个简单的命令获取申报文件。这省去了手动搜索和下载的麻烦。
• 公司特定申报文件： 通过公司的股票代码或 CIK（中央索引号）即可轻松检索特定公司的申报文件。
• 支持多家公司： 可同时下载多家公司的申报文件，从而提高比较分析的效率。
• 每日申报文件： 可访问特定日期提交的申报文件。
• 广泛的申报文件类型支持： 该库支持各种申报文件类型，并鼓励用户提交对任何缺失类型的请求。

开始使用 SEC-Edgar：

安装非常简单，可以通过 pip 进行：

pip install secedgar

或者，您可以克隆仓库并在本地安装：

git clone https://github.com/sec-edgar/sec-edgar.git
cd sec-edgar
python setup.py install

对于 Jupyter Notebook 用户，请确保异步操作顺利运行，这需要 nest-asyncio 包：

import nest_asyncio
nest_asyncio.apply()

用法示例：

下载苹果公司（股票代码“aapl”）的所有 10-Q 表格：

from secedgar import filings, FilingType

my_filings = filings(cik_lookup="aapl",
filing_type=FilingType.FILING_10Q,
user_agent="您的姓名 (您的邮箱)")
my_filings.save('/path/to/dir')

贡献与社区：

SEC-Edgar 在 GitHub 上拥有超过 1.3k 的星标和 319 个 fork，是一个不断发展且活跃的开源项目。该项目欢迎贡献，其开发者对问题和功能请求响应迅速。该项目已获得宽松的 Apache-2.0 许可证，鼓励广泛采用和修改。

无论您是数据科学家、金融分析师还是对市场趋势感兴趣的学生，SEC-Edgar 都提供了一种强大且易于获取的方式来收集重要的财务文件。请查阅官方文档，了解其功能的更多详细信息和如何贡献。