Skip to content

SEC EDGAR Filings Fetcher

Look up US public companies and pull their SEC filings and XBRL financial figures

Stars
37,433
Licence
MIT
Files
6 files

What it does

This skill teaches an AI agent how to fetch official U.S. company data from the Securities and Exchange Commission's free EDGAR system. Once installed, the agent can turn a stock ticker like AAPL into its SEC identifier, list recent filings such as annual (10-K) or quarterly (10-Q) reports with links to the documents, and pull reported financial figures such as revenue or net income over time. It is a data-retrieval guide, not an analysis method, and it covers U.S. companies only.

Great for

  • Analysts or students who want recent SEC filings or reported financials for a U.S.-listed company
  • Developers building research tools on top of the Vibe-Trading agent who need a throttled EDGAR client
  • Researchers who need quick links to a company's 10-K or 8-K documents

Skip it if

  • Non-U.S. companies or markets such as A-shares or Hong Kong stocks, because EDGAR does not cover them
  • Investment decisions on their own, since the skill states its data is for research only and not investment advice
  • Real-time trading signals, because filings and XBRL data trail the actual submission and are not live market prices

Try asking

  • “Get the last 5 10-K filings for Apple and give me the links to the primary documents”
  • “Pull Microsoft's Revenues series from SEC XBRL data for the last 8 reporting periods”
  • “Find the CIK for NVIDIA and list its most recent 8-K filings”
  • “Show me the StockholdersEquity trend for a U.S. company from its companyfacts data”
Step-by-step guide: how to use SEC EDGAR Filings FetcherInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 6 original files, the MIT licence and an attribution note.

    sec-edgar.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip sec-edgar.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip sec-edgar.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Set VIBE_TRADING_SEC_UA to your real name or organisation and contact email so the SEC can reach you if your client misbehaves.
  • Use the get_sec_filings tool path rather than raw scripts; it is read-only and returns structured JSON.
  • Metric names are case-sensitive US-GAAP taxonomy names such as Revenues or NetIncomeLoss, so check the common concepts reference first.

What's inside

  • references/endpoints_and_limits.md
  • references/forms_and_concepts.md
  • references/get_sec_filings_tool.md
  • references/sec_edgar_client.md
  • scripts/sec_filings_example.py
  • SKILL.md

Redistributed unmodified from HKUDS/Vibe-Trading under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.