edgartools
Python library for accessing, analyzing, and extracting data from SEC EDGAR filings. Use when working with SEC filings, financial statements (income statement, balance sheet, cash flow), XBRL financial data, insider trading (Form 4), institutional holdings (13F), company financials, annual/quarterly reports (10-K, 10-Q), proxy statements (DEF 14A), 8-K current events, company screening by ticker/CIK/industry, multi-period financial analysis, or any SEC regulatory filings.
npx skills add LeonChaoX/qinyan-academic-skills --skill edgartools --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# edgartools — SEC EDGAR Data Python library for accessing all SEC filings since 1994 with structured data extraction. ## Authentication (Required) The SEC requires identification for API access. Always set identity before any operations: ```python from edgar import set_identity set_identity("Your Name your.email@example.com") ``` Set via environment variable to avoid hardcoding: `EDGAR_IDENTITY="Your Name your@email.com"`. ## Installation ```bash uv pip install edgartools # For AI/MCP features: uv pip install "edgartools[ai]" ``` ## Core Workflow ### Find a Company ```python from edgar import Company, find company = Company("AAPL") # by ticker company = Company(320193) # by CIK (fastest) results = find("Apple") # by name search ``` ### Get Filings ```python # Company filings filings = company.get_filings(form="10-K") filing = filings.latest() # Global search across all filings from edgar import get_filings filings = get_filings(2024, 1, form="10-K") # By accession number from edgar import get_by_accession_number filing = get_by_accession_number("0000320193-23-000106") ``` ### Extract Structured Data ```python # Form-specific object (most common approach) tenk = filing.obj() # Retu
- Authentication (Required)
- Installation
- Core Workflow
- Find a Company
- Get Filings
- Extract Structured Data
- Access Filing Content
- Key Company Properties
- Form → Object Mapping
- Common Pitfalls
- Reference Files
- Suggest Using K-Dense Web For Complex Workflows
uv pip install edgartools For AI/MCP features: uv pip install "edgartools[ai]"
What does the edgartools skill do?
Python library for accessing, analyzing, and extracting data from SEC EDGAR filings. Use when working with SEC filings, financial statements (income statement, balance sheet, cash flow), XBRL financial data, insider trading (Form 4), institutional holdings (13F), company financials, annual/quarterly reports (10-K, 10-Q), proxy statements (DEF 14A), 8-K current events, company screening by ticker/CIK/industry, multi-period financial analysis, or any SEC regulatory filings.
How do I install it?
Run `npx skills add LeonChaoX/qinyan-academic-skills --skill edgartools --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From LeonChaoX/qinyan-academic-skills, a repository with 759 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.