Skill

sec-edgar

Every SEC filing, every XBRL fact, every insider trade — synced into a local SQLite store you can pivot, search,...

Verified: 2026-05-13 (printing-press-ingest-2026-05-13+enrich-capability-skill)

When to use sec-edgar

Choose if

You need read-only SEC EDGAR access from an agent loop with a local SQLite mirror for cross-entity SQL, XBRL fact pivots, insider-trade cluster detection, and 8-K Item-4.02 surveillance. Pick this over hand-rolling EDGAR fetches when you want built-in SEC rate-limit compliance, User-Agent handling, and offline pivots — and because the upstream is fully free.

Avoid if

You need non-US filings or real-time fundamentals from a paid data vendor (XBRL coverage gaps mean older or foreign-private-issuer filings have sparse facts). Also avoid if you only need a single one-off filing — the SEC's own EDGAR search UI is faster than setting up the local SQLite store.

Risk Flags

  • MEDIUM rate_limit SEC enforces a 10 req/sec rate cap per host; the CLI self-caps at 8 req/sec with jitter. Agents bypassing the CLI or running multiple instances on one IP can trip SEC rate limiting.
  • MEDIUM auth SEC mandates a User-Agent header identifying the caller; missing or generic headers cause HTTP 403 rejection. The CLI sets one but bare HTTP integrations must comply.
  • LOW scope Read-only by design — no create/update/delete mutations. Not all filers report XBRL (older filings, foreign private issuers on 20-F). CIK formatting must be 10-digit zero-padded.
  • LOW data_quality XBRL coverage gaps mean some fact pivots return sparse rows for pre-2009 filings or foreign issuers; flagging logic should not assume universal coverage.

Cost

Type: Free · Free tier: SEC EDGAR is fully free — the SEC issues no API key. The CLI binary is free to install. Only operational cost is local disk for the SQLite mirror and bandwidth for sync.

Install

Default

npx -y @mvanhorn/printing-press install sec-edgar
# No API key needed — SEC is fully free.
# Optional: tune concurrency below SEC's 10 req/sec cap (CLI defaults to 8):
sec-edgar-pp-cli sync filings --concurrency 4

Setup docs →

Estimated time to first success: ~5 min

Dependencies

Minimum runtime: Node.js (npx) or Go 1.26.3+; pre-built binaries for macOS and Unix

Distribution

Repository
https://github.com/mvanhorn/printing-press-library
License
MIT