The only SEC EDGAR library built from the ground up for AI agents and LLMs. Extract financial data in 3 lines of code instead of 100+. Production-ready MCP server included.

_{Built with AI-assisted development • 3-10x faster velocity • Support this project}

EdgarTools is the fastest, most powerful open-source library for SEC EDGAR data extraction. Built for financial analysts, data scientists, and AI developers who need reliable, production-ready access to SEC filings.

Lightning Fast 10-30x faster than alternatives Optimized with lxml & PyArrow	AI Native Built-in MCP server for Claude LLM-optimized text extraction	Production Quality 1000+ tests, type hints Battle-tested by analysts
XBRL Native Full XBRL standardization Cross-company comparisons	Rich Data Objects Smart parsing for every form Pandas-ready DataFrames	Open Source MIT license, community-driven Transparent & auditable

EdgarTools provides a clean abstraction layer over the SEC EDGAR database, handling all the complexity of SEC data access, parsing, and transformation:

%%{init: {'theme':'base', 'themeVariables': { 'primaryColor':'#FFD700', 'primaryTextColor':'#3d5875', 'primaryBorderColor':'#3d5875', 'lineColor':'#3d5875', 'secondaryColor':'#f8f9fa', 'tertiaryColor':'#ffffff'}}}%%

graph LR
    A[Your Code] -->|Simple API| B[EdgarTools]
    B -->|Fetches| C[SEC EDGAR]
    B -->|Parses| D[Structured Data]
    D -->|Returns| E[DataFrames]
    D -->|Returns| F[Objects]
    D -->|Returns| G[Clean Text]

    style A fill:#FFD700,stroke:#3d5875,stroke-width:2px,color:#3d5875
    style B fill:#3d5875,stroke:#FFD700,stroke-width:2px,color:#FFD700
    style C fill:#3d5875,stroke:#3d5875,stroke-width:2px,color:#FFD700
    style D fill:#f8f9fa,stroke:#3d5875,stroke-width:2px,color:#3d5875
    style E fill:#ffffff,stroke:#FFD700,stroke-width:2px,color:#3d5875
    style F fill:#ffffff,stroke:#FFD700,stroke-width:2px,color:#3d5875
    style G fill:#ffffff,stroke:#FFD700,stroke-width:2px,color:#3d5875

# 1. Install
pip install edgartools

# 2. Set your identity (required by SEC regulations)
from edgar import *
set_identity("[email protected]")

# 3. Get company financials in 1 line
balance_sheet = Company("AAPL").get_financials().balance_sheet()

# 4. Explore with interactive documentation
company = Company("MSFT")

# 5. Or explore insider transactions
filings = company.get_filings(form="4")
form4_filing = filings[0]
form4 = form4_filing.obj()

Feature	EdgarTools	sec-api (paid)	OpenEDGAR	Manual Scraping
AI/MCP Integration
Cost	Free	$150+/mo	Free	Free
Speed	10-30x baseline	Fast (API)	Slow	Slow
XBRL Support	Full	Partial
Financial Statements	Parsed	Parsed	Basic	DIY
LLM-Ready Output
Type Hints
Rate Limiting	Auto	N/A (API)	Manual	Manual
Open Source	MIT	Proprietary	Apache	N/A

EdgarTools provides AI Skills that enable Claude and other AI assistants to perform sophisticated SEC filing analysis. Once configured, you can ask Claude questions like:

• "Compare Apple and Microsoft's revenue growth rates over the past 3 years"
• "Which Tesla executives sold more than $1 million in stock in the past 6 months?"
• "Find all technology companies that filed proxy statements with executive compensation changes"

Claude will write the Python code, execute it, and explain the results - all powered by EdgarTools.

pip install edgartools[ai]
python -c "from edgar.ai import install_skill; install_skill()"

pip install edgartools[ai]
python -m edgar.ai

{
  "mcpServers": {
    "edgartools": {
      "command": "python",
      "args": ["-m", "edgar.ai"],
      "env": {
        "EDGAR_IDENTITY": "Your Name [email protected]"
      }
    }
  }
}

I build and maintain EdgarTools solo using AI-assisted development. Your support directly funds the Claude Max subscription that makes this extraordinary velocity possible.

What your support enables:

• ✅ Claude Max subscription (AI agents that write, test, and document code)
• ✅ Continued 3-10x development velocity (features in days, not weeks)
• ✅ Rapid response to SEC format changes and bug reports
• ✅ New features based on community needs
• ✅ Free access for everyone, forever (no API keys, no rate limits)

Alternative ways to support:

• ⭐ Star the repo on GitHub
• 🐛 Report bugs and contribute fixes
• 📖 Improve documentation
• 💬 Answer questions in Discussions
• 🔗 Share EdgarTools with colleagues

Corporate users: If your organization depends on EdgarTools for SEC compliance or regulatory reporting, GitHub Sponsors offers strategic sponsorship options designed for mission-critical dependencies.

• User Journeys / Examples
• Quick Guide
• Full API Documentation
• EdgarTools Blog

• GitHub Issues - Bug reports and feature requests
• Discussions - Questions and community discussions

We welcome contributions from the community! Here's how you can help:

• Code: Fix bugs, add features, improve documentation
• Examples: Share interesting use cases and examples
• Feedback: Report issues or suggest improvements
• Spread the Word: Star the repo, share with colleagues

See our Contributing Guide for details.

EdgarTools is distributed under the MIT License