推荐开源项目：edgartools —— 全球最易用、功能最强大的EDGAR库

推荐开源项目：edgartools —— 全球最易用、功能最强大的EDGAR库

edgartools Python library for working with SEC Edgar 项目地址: https://gitcode.com/gh_mirrors/ed/edgartools

项目介绍

edgartools 是一个开源项目，旨在为开发者提供最简单、最强大的EDGAR库。它能够轻松访问和处理美国证券交易委员会（SEC）自1994年以来的所有文件，包括10-K和10-Q财务报告、内部交易记录等。项目以其简洁易用的API和丰富的功能，成为金融数据分析、投资研究和数据科学领域的必备工具。

项目技术分析

edgartools 采用Python编写，利用了多个优秀的开源库，如rich来美化终端输出，提供直观的数据展示。项目支持多种数据格式（如HTML、XML、文本），并能够解析XBRL数据，将其转换为易于操作的数据结构。

主要技术亮点：

• Python语言：广泛使用，易于集成到现有项目中。
• rich库：提供美观的终端输出，提升用户体验。
• 自动化下载与解析：自动下载并解析文件，生成数据对象，简化数据处理流程。
• CLI与库双重模式：既可作为库集成到代码中，也可作为命令行工具独立使用。

项目及技术应用场景

edgartools 适用于多种应用场景，包括但不限于：

• 金融数据分析：获取公司财务报告，进行财务指标分析。
• 投资研究：追踪内部交易，评估公司管理层信心。
• 数据科学项目：构建数据管道，自动化获取和处理SEC文件。
• 学术研究：分析历史财务数据，支持经济和金融领域的研究。
• 合规检查：监控公司披露信息，确保合规性。

项目特点

edgartools 拥有以下显著特点，使其在众多EDGAR库中脱颖而出：

• 全面访问：支持访问自1994年以来的所有SEC文件。
• 财务数据：提供详尽的公司财务数据，支持10-K和10-Q报告。
• 内部交易：轻松获取内部交易记录。
• 灵活筛选：支持按年份、季度、日期范围等多种方式筛选文件。
• 美观展示：使用rich库，终端输出美观大方。
• 简洁易用：API设计简洁，易于上手。
• 双重模式：既可作为库使用，也可作为CLI工具。
• 高效分页：支持分页浏览文件。
• 数据管道：支持构建数据管道，自动化处理文件。
• 多格式支持：支持HTML、文本等多种格式查看文件。
• 搜索功能：支持在文件内搜索关键词。
• XBRL解析：提取XBRL数据，转换为直观的数据结构。
• 自动限流：自动限流请求，避免被EDGAR封禁。
• 批量下载：支持批量下载文件，提升处理效率。
• 公司信息查询：支持通过股票代码或CIK获取公司信息。

开始使用

安装

pip install edgartools

示例代码

from edgar import *

# 设置EDGAR身份
set_identity("Michael Mccallum mike.mccalum@indigo.com")

# 获取文件列表
filings = get_filings()

关键概念

查找文件：

# 通过 accession number 查找
filing = find("0001065280-23-000273")

# 通过公司股票代码或CIK查找
filings = Company("NFLX").get_filings(form="10-Q").latest(1)

操作文件：

# 查看文件
filing.view()

# 获取文件内容
html_content = filing.html()
text_content = filing.full_text_submission()

操作公司：

# 获取公司文件
company = Company("AAPL")
filings = company.get_filings()

# 获取公司财务数据
financials = company.get_financials()

结语

edgartools 是一个功能强大且易于使用的EDGAR库，适用于广泛的金融数据分析和研究场景。无论你是数据科学家、金融分析师还是学术研究者，edgartools都能为你提供强大的支持。立即尝试，开启高效的数据处理之旅！

点击这里访问项目GitHub页面

edgartools Python library for working with SEC Edgar 项目地址: https://gitcode.com/gh_mirrors/ed/edgartools