sec-edgar

v0.1.0Verified publisher
Report a problem

Finds a company in the SEC's EDGAR filings by name or ticker: CIK, industry, addresses and its latest filings

Run

Through ot mcp, an agent calls run_tool with this; ot asks you before anything that goes online or touches a target. Set it up: ot mcp install claude (or cursor, vscode, codex, gemini).

{"tool":"osintverse-community/sec-edgar","target":"Apple","input_type":"company"}

Or just say: "Run osintverse-community/sec-edgar on Apple with OTInstaller." The registry's read-only MCP server at api.otinstaller.com/mcp can find tools without installing anything.

ot run osintverse-community/sec-edgar --company Apple --format table
ot install osintverse-community/sec-edgar

Docker image in a read-only container · talks to www.sec.gov, data.sec.gov · needs EDGAR_IDENTITY · up to 2 min. The first ot run installs the tool after asking once. The example value is the registry's own test input, so this command has run. Drop --format table for JSON.

Don't have ot? Install it in one line
curl -fsSL https://get.otinstaller.com/ot | sh
What this script does
  1. Downloads the latest ot release for your machine from GitHub Releases.
  2. Checks its SHA-256 against checksums.txt, and the Ed25519 signature on that file against the key built into the script.
  3. Puts ot in /usr/local/bin or ~/.local/bin. Nothing else is written. Read the script.
irm https://get.otinstaller.com/ot.ps1 | iex
What this script does
  1. Downloads the latest ot release for your machine from GitHub Releases.
  2. Checks its SHA-256 against checksums.txt, and the Ed25519 signature on that file against the key built into the script.
  3. Puts ot in %LOCALAPPDATA%\Programs\ot, and adds it to your PATH. Nothing else is written. Read the script.
  • Pinnedimage sha256:5f097259…4b7009. The same bytes on every install; ot pulls by digest, never by tag.
  • Signedby https://github.com/osintverse-community/sec-edgar/.github/workflows/otinstaller-release.yml@refs/heads/main via token.actions.githubusercontent.com, verified by the registry on 24 Oct 2026. ot checks the same identity before every install and refuses another signer.
  • Scanned24 Oct 2026: 0 critical, 44 high, 63 medium, 62 low vulnerabilities; 0 embedded secrets, 0 malware heuristics; SBOM with 132 packages.
  • Workssmoke test passed on 24 Oct 2026 (exit 3 in 5.9 s, offline sandbox); the nightly health check has not run yet.
  • No public copythe registry keeps no public copy of this artifact yet (copies of non-OSI licences are private, and new releases are copied after their scan).
  • Reviewedosintverse-community is a verified publisher: the registry confirmed who runs it, and a person reviewed its first release against the acceptable-use rules.

From the community

Issues →

Not health-checked yet; 0.1.0 came out today; nobody has said yet whether it works.

0.1.0 is in its first week. Nobody has said whether it works yet.

Used 0.1.0?It's broken for me

What you get back

Result envelope →
{
  "envelope": 1,
  "tool": "osintverse-community/sec-edgar@0.1.0",
  "runtime": "docker",
  "input": {
    "company": "Apple"
  },
  "started_at": "2026-10-21T09:00:00Z",
  "duration_ms": 4100,
  "exit_code": 0,
  "entities": [
    {
      "type": "organization",
      "value": "Example Ltd"
    },
    {
      "type": "location",
      "value": "51.5074,-0.1278",
      "attrs": {
        "city": "London"
      }
    },
    {
      "type": "document",
      "value": "report.pdf",
      "attrs": {
        "author": "Jane Doe"
      }
    }
  ],
  "warnings": []
}

Every tool returns this shape, shaped here from what this tool declares it finds. --format table to read it; ot extract and ot auto to continue.

sec-edgar

Finds a company in the SEC's EDGAR filings by name or ticker. The best match comes back in full: its CIK, tickers and exchanges, industry (SIC code and description), state of incorporation, fiscal year end, business and mailing addresses, and its latest filings with form, date, accession number and a link to each. Other close matches are listed with their CIK, ticker and match score. Uses the edgartools library for the SEC's free EDGAR data. Only the SEC's public data is read, so the company is not contacted.

ot run osintverse-community/sec-edgar --company Apple

Inputs

Input Required
company yes Company name or ticker
limit no How many matching companies to list: 5 by default, up to 25
filings no How many of the best match's latest filings to list: 10 by default, up to 100

Keys

EDGAR_IDENTITY, set with ot keys set EDGAR_IDENTITY. It isn't a secret: the SEC asks every program that reads EDGAR to say who is behind it, so set your name and email address, such as Jane Doe jane@example.com (https://www.sec.gov/os/accessing-edgar-data). Without it the tool exits with code 3.

Notes

Names are matched against the SEC's list of companies with tickers, so a company that files with the SEC but has no listed shares may not be found by name. The SEC allows at most ten requests a second per client, which one run stays well under.

Next steps

Look the company up in osintverse-community/gleif for its Legal Entity Identifier.

Development

pip install edgartools==5.62.1
python -m unittest
ot validate

Releases are built, signed and published by the otinstaller release workflow (Actions tab, with the version to release).

License

MIT

What next

sec-edgar finds organization, location, document. Tools that take those:

organization → 6 toolsot auto, with a saved result

Other company tools

All company tools →

Alternatives to sec-edgar that also take a company; ot auto runs every installed one on the same value.

osintverse-community/asnmap

Maps an organisation name to its autonomous systems and the network ranges they announce

Takes company → finds ip, organization
Key required · Docker
Worked todayVerified publisher

osintverse-community/handelsregister

Looks up a German company's commercial register entry through handelsregister.ai: officers, filings, financials

Takes company → finds document, location, organization, person
Key required · Python wheel
Not health-checkedVerified publisher

osintverse-community/gleif

Searches GLEIF's register of Legal Entity Identifiers for a company: LEI, legal name, addresses and status

Takes company → finds location, organization
No key · Docker
Not health-checkedVerified publisher

osintverse-community/companies-house

Searches the UK Companies House register: companies, their status and office, officers and controlling owners

Takes company → finds location, organization, person
Key required · Docker
Not health-checkedVerified publisher

osintverse-community/opensanctions

Screens a person's or company's name against OpenSanctions: sanctions lists, politically exposed persons, watch lists

Takes company, name → finds organization, other, person
Key required · Docker
Not health-checkedVerified publisher
Esc

Try

↑ ↓ to move↵ to open