sec-edgar

Resolve U.S. equity tickers to CIK identifiers and retrieve SEC EDGAR filings and XBRL metrics.

Updated Jun 30, 2026
One-click install
npx skills add https://github.com/20YN04/vibe-trading-macos --skill sec-edgar-20yn04
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sec-edgar
Source: https://github.com/20YN04/vibe-trading-macos/tree/main/agent/src/skills/sec-edgar
Command: npx skills add https://github.com/20YN04/vibe-trading-macos --skill sec-edgar-20yn04

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill eliminates the manual effort of navigating the SEC EDGAR website by providing a direct, throttled interface to fetch company filings and XBRL financial metrics programmatically.

Core Features & Use Cases

  • Ticker-to-CIK Resolution: Automatically maps U.S. equity symbols to their official SEC Central Index Key.
  • Filing Retrieval: Lists recent 10-K, 10-Q, 8-K, and other regulatory filings with direct access to primary document URLs.
  • Financial Data Extraction: Pulls structured XBRL us-gaap metrics like Revenues, Net Income, and Assets for historical financial analysis.

Quick Start

Use the get_sec_filings tool to retrieve the five most recent 10-K filings and the revenue history for Apple using the ticker AAPL.

Frequently Asked Questions about sec-edgar

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

FAQPage Schema
How do I retrieve SEC EDGAR filings using a stock ticker?

To retrieve SEC EDGAR filings, you must first resolve the U.S. equity ticker to its official Central Index Key (CIK). This skill automates that ticker-to-CIK resolution to fetch 10-K, 10-Q, and 8-K regulatory filings directly.

Can I extract XBRL financial metrics like revenues and assets from SEC filings?

Yes, you can extract structured XBRL us-gaap financial metrics like Revenues, Net Income, and Assets from the SEC EDGAR database. This allows you to pull historical financial data for automated analysis.

How do I get recent 10-K filings for a U.S. equity without manual EDGAR searches?

You can get recent 10-K filings by using automated scripts to query public SEC JSON endpoints. This eliminates manual website navigation and returns primary document URLs directly.

Does accessing SEC EDGAR JSON endpoints require specific rate limiting?

Accessing SEC EDGAR JSON endpoints requires IP-throttled requests and compliant User-Agent headers. This ensures reliable, rate-limited access to the public financial database without getting blocked.

What is the best way to automate financial research for U.S. market equities?

The best way to automate U.S. market financial research is programmatically resolving tickers to CIK identifiers and querying SEC JSON endpoints. This provides structured filing discovery and historical XBRL metric extraction.

Do I need the requests library to fetch SEC financial data?

Yes, you need the requests library to execute the HTTP calls that fetch SEC financial data. It handles the IP-throttled requests required to access the public EDGAR JSON endpoints.