🎯

us-govt-data

🎯Skill

from joshuaroll/research-skills

VibeIndex|
What it does

Retrieves official US government documents from SEC EDGAR and Federal Register, enabling comprehensive financial and regulatory research.

πŸ“¦

Part of

joshuaroll/research-skills(4 items)

us-govt-data

Installation

PythonRun Python server
python3 fetch_filing.py "Google" --type 10-K --section risk
PythonRun Python server
python3 fetch_filing.py TSLA --type 10-Q --clean-text
πŸ“– Extracted from docs: joshuaroll/research-skills
1Installs
-
AddedFeb 4, 2026

Skill Details

SKILL.md

Access official US Government records. Currently supports SEC EDGAR (financial filings) and Federal Register (rule changes). Ensures data provenance from .gov domains.

Overview

# US Government & Legal Data Skill

This skill allows you to retrieve official documents from US government sources, essential for due diligence and regulatory research.

Capabilities

  1. SEC EDGAR: Retrieve 10-K (Annual) and 10-Q (Quarterly) filings for public companies.
  2. Federal Register: (Future) Check for new agency rules.
  3. Text Extraction: Convert HTML filings to raw text for analysis.
  4. Section Targeting: Extract specific sections like "Risk Factors" automatically.
  5. Company Search: Query by name (e.g., "Google" for Alphabet Inc.) if ticker is unknown.

Usage

Run the python script fetch_filing.py to retrieve SEC documents.

Arguments

  • ticker (required): The stock symbol (e.g., AAPL) or partial company name.
  • --type (optional): Form type (default "10-K").
  • --count (optional): Number of filings to retrieve (default 1).
  • --clean-text (optional): Set this flag to download and strip HTML tags.
  • --section (optional): "risk" (Risk Factors) or "mda" (Management Discussion). Implies --clean-text.

Example

```bash

# Get the text of "Risk Factors" for Google

python3 fetch_filing.py "Google" --type 10-K --section risk

# Get text for Tesla 10-Q

python3 fetch_filing.py TSLA --type 10-Q --clean-text

```

Output Format

The script outputs a JSON object containing:

  • cik: Central Index Key
  • company_name
  • filings:

* primaryDocumentUrl: Direct link to the HTML document.

* content: The extracted text (truncated or fully extracted section).

Tips for the Agent

  • HTML takes space: Only use --clean-text if you plan to read the content. It makes the requested slower (extra HTTP call).
  • Name Search: You can now pass "Microsoft" instead of "MSFT".