@this-npm-test-org/connection-sec-edgar
v0.1.3
Published
SEC filings, company data, and full-text search via the EDGAR EFTS and company APIs.
Readme
SEC EDGAR Connection
Connects your agent to the SEC EDGAR system for public company filings. Pull 10-K, 10-Q, 8-K filings, proxy statements, insider transactions, and financial statements. No authentication required — public data.
Authentication
No authentication required. The SEC EDGAR API is public.
user_agent— Required: your company name and email for SEC rate limit compliance
Endpoints
Company Search
GET /cgi-bin/browse-edgar?action=getcompany&company={name}— Search companies by nameGET /cgi-bin/browse-edgar?action=getcompany&CIK={cik}— Lookup by CIK number
Filings
GET /cgi-bin/browse-edgar?action=getcompany&type={type}&CIK={cik}— Get filings by type (10-K, 10-Q, 8-K)GET /Archives/edgar/data/{cik}/{accession}— Get specific filing document
XBRL Financial Data
GET /api/xbrl/companyfacts/CIK{cik}.json— Get structured financial data (revenue, net income, etc.)
Full-Text Search
GET /efts/current/search-index?q={query}&dateRange=custom— Full-text search across filings
Insider Transactions
GET /cgi-bin/browse-edgar?action=getcompany&type=4&CIK={cik}— Form 4 insider transactions
Rules
- Rate limit: 10 requests/second (SEC fair use policy)
- The agent extracts key financial metrics from XBRL data when available
- Filing documents can be very large — the agent dispatches task agents for parsing
- The agent identifies material changes in 8-K filings (executive changes, M&A, restatements)
- All EDGAR data is public — no privacy restrictions
