sec-edgar
US SEC EDGAR filings — list 10-K/10-Q/8-K/Form 4/S-1, fetch filing text, parse insider Form 4 transactions.
npx skills add kansoku-trade/kansoku --skill sec-edgar --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.
# sec-edgar > Response language: match user input. ## When to use Trigger phrases: - 8-K / 10-K / 10-Q / Form 4 / S-1 / proxy / DEF 14A - 美股公告 / SEC filing / EDGAR - insider trading / 内部人交易 / 高管交易 - 财报原文 / 招股书 / 风险因素 / MD&A **Not for**: 13F holdings analysis (this skill lists 13F filings but does not parse them into holdings — deferred to a future skill). ## Workflow 1. **List filings**: `filings.py <TICKER>` (optionally `--type 8-K`). 2. **Read filing text**: pass `primary_doc_url` from the list output to `filing_text.py`. Use `--max-chars` to cap; `--section item1a` for risk factors, `--section mda` (Item 7) for MD&A. 3. **Insider trades**: `insider.py <TICKER>` parses Form 4 XML for the past --days window. Environment auto-loaded; `SEC_USER_AGENT` is mandatory. ## CLI examples ```bash # Latest 5 NVDA 8-Ks python3 .claude/skills/sec-edgar/scripts/filings.py NVDA --type 8-K --limit 5 # All recent NVDA filings python3 .claude/skills/sec-edgar/scripts/filings.py NVDA --limit 20 # Read the most recent 8-K (URL from filings.py) python3 .claude/skills/sec-edgar/scripts/filing_text.py \ "https://www.sec.gov/Archives/edgar/data/1045810/000104581026000051/nvda-20260520.htm" \ --max-chars
- When to use
- Workflow
- CLI examples
- Section keys (10-K)
- Output shapes
- Error handling
- Known limitations
- Related skills
Latest 5 NVDA 8-Ks python3 .claude/skills/sec-edgar/scripts/filings.py NVDA --type 8-K --limit 5 All recent NVDA filings python3 .claude/skills/sec-edgar/scripts/filings.py NVDA --limit 20 Read the most recent 8-K (URL from filings.py) python3 .claude/skills/sec-edgar/scripts/filing_text.py \ Pull Item 1A (Risk Factors) from a 10-K python3 .claude/skills/sec-edgar/scripts/filing_text.py "<10-K URL>" --section item1a Save full text to disk, get metadata only python3 .claude/skills/sec-edgar/scripts/filing_text.py "<URL>" --save-raw /tmp/nvda-10k.txt
What does the sec-edgar skill do?
US SEC EDGAR filings — list 10-K/10-Q/8-K/Form 4/S-1, fetch filing text, parse insider Form 4 transactions.
How do I install it?
Run `npx skills add kansoku-trade/kansoku --skill sec-edgar --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 kansoku-trade/kansoku, a repository with 272 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.