EdgarTools Python library simplifies SEC filing analysis

EdgarTools is an open‑source Python library that lets users retrieve and work with SEC EDGAR filings as structured data, turning complex XBRL documents into ready‑to‑use pandas objects and clean text [1]. The package supports a wide range of filing types—from 10‑K reports to insider Form 4s—and includes tools for AI‑driven queries and a hosted web UI.

Key takeaways

• Provides typed Python objects for over 20 SEC filing forms, converting raw filings into DataFrames and readable text [2].
• Enables extraction of key company metrics such as shares outstanding and public float via simple properties [1].
• Offers built‑in XBRL parsing, local caching, and batch processing for efficient large‑scale analysis [1].
• Integrates with Claude AI via an optional skill, allowing natural‑language queries over SEC data [2].
• Free to install via pip and includes a REST API with a free tier of 100 calls per day [1].

Streamlined access to SEC data

EdgarTools starts with a Company object that represents any public ticker, after users set an email identity required by the SEC [2]. From there, developers can call methods like get_financials() to retrieve standardized income statements, balance sheets, and cash‑flow data directly from XBRL filings [1][2]. Insider transactions are accessible with get_filings(form="4"), returning structured objects that can be concatenated into a single DataFrame for analysis [1]. The library also supports proxy statements, 13F holdings, and a full suite of other forms, making it a one‑stop solution for financial research [2].

AI‑ready and enterprise features

Beyond basic data extraction, EdgarTools includes an MCP server that can be deployed for AI applications, and a dedicated Claude skill (edgartools[ai]) that adds SEC analysis capabilities to Claude Desktop and Claude Code [2]. This integration enables natural‑language queries such as “Which Tesla executives sold more than $1 million in stock in the past six months?” and returns answers backed by the underlying SEC data [2]. The library is optimized for performance with local caching, batch processing, and type hints, and it can be run in production environments at hedge funds and fintech firms [1][2].

Why it matters

By turning the SEC’s massive, unstructured filing archive into easily consumable Python objects, EdgarTools lowers the barrier for analysts, researchers, and developers to perform rigorous financial and governance studies without costly third‑party APIs [1][2]. Its open‑source license, lack of required API keys, and community‑driven support make it a cost‑effective alternative for institutions and academics alike. Ongoing sponsorship and corporate tiers aim to sustain development and keep parsers up‑to‑date with SEC filing changes, ensuring the tool remains relevant as regulatory reporting evolves [2].