sec-edgar-parser

Download and parse SEC EDGAR filings into text and table data.

203|27|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/franklee16/academic-research-skills --skill sec-edgar-parser
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sec-edgar-parser
Source: https://github.com/franklee16/academic-research-skills/tree/main/data-sourcing/sec-edgar-parser
Command: npx skills add https://github.com/franklee16/academic-research-skills --skill sec-edgar-parser

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, pandas, bs4, json, time, and includes scripts (resource) components.

What problem does it solve?

It eliminates the time-consuming work of finding, downloading, and extracting financial filing content from the SEC EDGAR site so you can quickly analyze company disclosures.

Core Features & Use Cases

  • CIK and filing discovery: Finds a company’s CIK from a ticker and pulls the relevant recent submissions metadata for forms like 10-K, 10-Q, and 8-K.
  • Filing URL construction and retrieval: Builds the correct SEC Archives document URL from accession numbers and downloads filing text/HTML.
  • Content parsing and structured extraction: Extracts readable text from HTML using BeautifulSoup and converts HTML tables into Pandas DataFrames with pd.read_html().
  • Use case: You need to extract “Item 1A. Risk Factors” and key tables from the latest 10-K for a list of tickers, then standardize the data for downstream analysis.

Quick Start

Use the sec-edgar-parser skill to fetch and parse the latest 10-K filing for AAPL into extracted text and tables.

Frequently Asked Questions about sec-edgar-parser

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I download and parse SEC EDGAR filings into Pandas DataFrames?

To parse SEC EDGAR filings, the skill retrieves documents via the SEC submissions JSON endpoint and extracts HTML tables into Pandas DataFrames using pd.read_html, while converting text content with BeautifulSoup. It handles CIK lookup, URL construction from accession numbers, and document retrieval automatically.

Can I extract specific sections like Item 1A from a 10-K filing using BeautifulSoup?

Yes, you can extract specific sections like Item 1A Risk Factors from 10-K filings. The skill parses HTML content using BeautifulSoup to extract readable text and structured table data, standardizing disclosures for downstream analysis by company ticker and form type.

What's the best way to automate financial data extraction from 10-K and 10-Q forms by company ticker?

The best way to automate financial data extraction is using the SEC submissions JSON endpoint with CIK padding to discover filings by ticker. The skill constructs Archives document URLs from accession numbers, downloads the HTML, and parses tables into DataFrames for analysis.

Do I need a User-Agent header to download SEC EDGAR filing data programmatically?

Yes, SEC-compliant User-Agent headers are required to download EDGAR filing data programmatically. The skill enforces this requirement when querying the submissions JSON endpoint and retrieving filing documents, ensuring compliant access to SEC EDGAR corporate filings.

Does this SEC filing parser support XBRL data or only HTML table extraction?

This SEC filing parser focuses on HTML table extraction via Pandas and text parsing via BeautifulSoup. While XBRL is listed as a related keyword, the core implementation retrieves filing HTML and converts tables to DataFrames rather than parsing XBRL tags directly.

How do I find a company's CIK from a ticker symbol to retrieve recent SEC submissions?

To find a company's CIK from a ticker symbol, the skill queries the SEC submissions JSON endpoint with CIK padding. It pulls recent submissions metadata for form types like 10-K, 10-Q, and 8-K, enabling filing discovery and document URL construction.