us-sec-edgarlisted
Install: claude install-skill techhorizonlabs/gearlist
# US SEC EDGAR
A company's record in EDGAR, the SEC's filing system, found by name, ticker or CIK (Central Index Key, the number EDGAR gives each filer).
`scripts/sec_edgar.py` makes the calls below and prints Markdown, or JSON with `--json`. It uses the Python 3 standard library only, sends read-only GET requests and writes nothing to disk.
## What EDGAR covers
EDGAR holds the filings of companies and others that file with the SEC: mostly public companies, plus some private companies. For example, a company files a Form D, a notice of an exempt offering of securities, within 15 days after it first sells securities under an exemption. Most private businesses never file. A business that is not in EDGAR can still be real and trading. Say this whenever a search finds nothing.
EDGAR also gives a CIK to people who file as company insiders. The SEC's own list of CIKs "includes funds and individuals".
## Sign-in: a declared user agent
The data.sec.gov APIs need no key. The SEC's fair access rules ask every automated request to declare who is asking in the `User-Agent` header, with a name and a contact email, for example `Sample Company Name AdminContact@<sample company domain>.com`, and they set a maximum of 10 requests a second.
1. Ask the human which name and email to declare. Use their organisation's name and a contact address they read.
2. They set it in the `SEC_USER_AGENT` environment variable, for example `export SEC_USER_AGENT="Example Pty Ltd ops@example.com"`.
3. T