nordic-data 0.2.0 → 0.4.0

package/README.md

@@ -1,118 +1,160 @@
-# Nordic Data MCP Server
+# Nordic Data
 
-> Live Nordic public-sector and Norwegian + Swedish corporate data, exposed as 29 MCP tools for AI agents.
+> Norwegian, Swedish, and US business intelligence in one terminal — plus a hosted MCP server for AI agents.
 
-**Hosted at:** `https://api.nordicdata.cloud/mcp`
-**Get a free API key:** [nordicdata.cloud](https://nordicdata.cloud)
-**Docs:** [nordicdata.cloud/docs#mcp](https://nordicdata.cloud/docs#mcp)
-**Smithery one-click install:** [smithery.ai/server/sofia-jameson-20/Nordic-Data](https://smithery.ai/server/sofia-jameson-20/Nordic-Data)
+```bash
+npx nordic-data lookup 923609016         # full snapshot of Equinor
+npx nordic-data list elektriker --city Stavanger --employees-min 5
+npx nordic-data nl "Norwegian fintech startups under 20 employees"
+npx nordic-data kyb 918274758            # full due-diligence pack
+npx nordic-data verify-invoice 923609016 DE89370400440532013000
+npx nordic-data us-search Microsoft
+```
 
-This repository contains setup instructions and configuration snippets. The server itself is hosted — no local install required.
+**Get a free key:** [nordicdata.cloud](https://nordicdata.cloud) — 500 requests/month, no card
+**Docs:** [nordicdata.cloud/docs](https://nordicdata.cloud/docs)
 
 ---
 
-## What's covered
+## Install
 
-- **Public procurement** — Nordic tender notices and contract awards across two coverage tiers: an EU-tier (above-EU-threshold notices for Norway, Sweden, Denmark, Finland, Iceland) AND a Norway-tier (Norway-only, **including below-EU-threshold municipal/county tenders that no other API exposes cleanly**)
-- **Norwegian company registry** — full company data + complete shareholder cap tables (3M+ positions across 396K companies)
-- **Swedish company data** — identity (name, address, VAT registration) for any of ~1.6M Swedish companies, plus AI-enriched contact data (verified emails, direct phones, named executives) via the dedicated Sweden contact tool
-- **Danish + Finnish company data** — identity, addresses, basic phone/employees (Denmark) and multilingual name history (Finland)
-- **Officer & ownership network** — board memberships, shortest-path queries, full role history (Norway)
-- **News** — Norwegian-language news mentioning a company
-- **R&D activity** — research-grant history per recipient
-- **Tech intelligence** — find companies using a specific technology
-- **Compliance** — sanctions screening for any name or company + officers (global watchlist coverage)
-- **AI summaries** — executive narratives and peer benchmarks per company
+```bash
+npx nordic-data --help        # zero install
+# or
+npm install -g nordic-data
+nordic-data --help
+```
+
+## Configure your API key
+
+```bash
+export NORDIC_DATA_KEY=nrd_live_…   # or pass --key on each call
+```
+
+Most commands work without a key on the public widget tier (4 lookups per IP per 24h). Discovery, KYB, AI, and US commands all require a key.
 
-## Setup
+---
+
+## Commands
+
+### Core lookup (Norway + Sweden)
+| Command | What it does |
+|---|---|
+| `search <query>` | Search companies by name or org number |
+| `lookup <orgnr>` | Full snapshot of one company (NO 9-digit + SE 10-digit auto-routes) |
+| `contacts <orgnr>` | Emails, phones, and named executives |
+| `board <orgnr>` | Board + leadership |
+| `finances <orgnr>` | Latest financial summary |
+| `procurement <orgnr>` | Public-sector contract aggregates |
+| `grants <orgnr>` | EU R&D grant participations |
+| `sanctions <orgnr>` | Sanctions screening (OFAC + EU) on company + officers |
+| `shareholders <orgnr>` | Shareholder cap-table |
+| `contacts-se <orgnr>` | Sweden: identity + AI-enriched contacts |
+
+### Discovery (v0.4.0)
+| Command | What it does |
+|---|---|
+| `find <q>` | Universal resolver: name / orgnr / domain / email → company |
+| `list <profession>` | Filter NO companies by industry (× `--city` × `--employees-min`) |
+| `nl "<question>"` | Natural-language discovery — LLM parses to filter spec |
+| `near <lat> <lng>` | Geo-radius search (`--radius` km, `--profession` <slug>) |
+| `similar <orgnr>` | Lookalike companies by industry + geo + size |
+| `trades <slug>` | Vertical shortcut: elektriker, rorlegger, snekker, tannlege, etc. |
+| `decision-makers <orgnr>` | CEO + board + named contacts in one call |
+| `resolve <type> <value>` | email / domain / phone / iban / vat / lei / address / person → entity |
+
+### KYB & Compliance & AI (v0.4.0)
+| Command | What it does |
+|---|---|
+| `kyb <orgnr>` | One-call due-diligence pack (identity + sanctions + officers + signals) |
+| `diff <orgnr>` | Typed changelog of recent changes (`--since YYYY-MM-DD`) |
+| `verify-invoice <o> <iban>` | Invoice fraud check via IBAN country-mismatch heuristic |
+| `explain <orgnr>` | AI 3-sentence narrative |
+| `ask <orgnr> "<q>"` | Q&A grounded in the company's data |
+| `pitch <orgnr>` | Sales talking-points referencing concrete facts |
+
+### United States (v0.4.0 — SEC EDGAR + USA Spending)
+| Command | What it does |
+|---|---|
+| `us-search <query>` | Search ~10K US public companies by name / ticker |
+| `us-lookup <q>` | Resolve a US public company by CIK, ticker, or name |
+| `us-filings <cik>` | Recent SEC filings (`--type 10-K`) with direct EDGAR URLs |
+| `us-kyb <cik>` | US KYB pack: identity + filings + sanctions + federal contracts |
+
+### Meta
+| Command | What it does |
+|---|---|
+| `mcp` | Print MCP config snippet for Claude Desktop / Cursor |
+| `signup` | Open the free-tier signup in your browser |
+| `--help`, `-h` | Help (per-command help with `<cmd> --help`) |
+| `--version`, `-v` | Show version |
+
+### Flags
+- `--json` — output raw JSON instead of formatted
+- `--key <api-key>` — API key (or set `NORDIC_DATA_KEY` env var)
+- `--no-color` — disable ANSI colors
+
+---
+
+## MCP server (for AI agents)
 
-### Claude Desktop
+The same backend is also a [Model Context Protocol](https://modelcontextprotocol.io) server with **69 tools** exposed natively for AI agents — no SDK glue required.
 
-Edit `claude_desktop_config.json`:
+### Hosted endpoint
+
+```
+URL:       https://api.nordicdata.cloud/mcp
+Header:    X-API-Key: <your key>
+Transport: Streamable HTTP
+```
+
+### Claude Desktop / Cursor config
+
+Edit `claude_desktop_config.json` (or `~/.cursor/mcp.json`):
 
 ```json
 {
   "mcpServers": {
     "nordic-data": {
       "url": "https://api.nordicdata.cloud/mcp",
-      "headers": {
-        "X-API-Key": "YOUR_API_KEY_HERE"
-      }
+      "headers": { "X-API-Key": "YOUR_API_KEY_HERE" }
     }
   }
 }
 ```
 
-Restart Claude Desktop. The 29 tools appear in the MCP picker.
+Restart the client — all 69 tools appear in the MCP picker.
 
-### Cursor
+### Smithery one-click install
 
-Edit `~/.cursor/mcp.json` with the same JSON.
+[smithery.ai/server/sofia-jameson-20/Nordic-Data](https://smithery.ai/server/sofia-jameson-20/Nordic-Data)
 
-### Any MCP-aware client
+---
 
-```
-URL:       https://api.nordicdata.cloud/mcp
-Header:    X-API-Key: <your key>
-Transport: Streamable HTTP
-```
+## What's covered
+
+- **Norwegian company registry** — full company data + complete shareholder cap tables (3M+ positions across 396K companies)
+- **Swedish company data** — identity (~1.6M companies) + AI-enriched contacts (verified emails, direct phones, named executives)
+- **Danish + Finnish company data** — identity + basic enrichment
+- **United States public companies** — SEC EDGAR (~10K listed entities, full identity + filings) + USA Spending (federal contracts since 2008)
+- **Officer & ownership network (Norway)** — board memberships, shortest-path queries, full role history
+- **Public procurement (5 Nordic countries)** — EU-tier (above-threshold) + Norway-tier (below-EU-threshold municipal/county tenders)
+- **Sanctions / AML** — OFAC SDN + EU consolidated lists, with strict-surname disambiguation to suppress first-name-only false positives
+- **R&D grants** — Horizon Europe participations per recipient
+- **Tech intelligence** — find companies using a specific technology stack
+- **News** — Norwegian-language news mentioning a company
+- **AI / NL** — natural-language search, Q&A, talking-points, narrative for any covered company
+
+## Example prompts (via the MCP server in Claude/Cursor)
 
-## Tools (29 total)
-
-### Procurement
-- `search_tenders` — Nordic procurement notices by country, keyword, CPV, date. Filter by coverage tier (EU-tier across all 5 Nordic countries, or Norway-tier including below-threshold municipal awards). Filter by `buyer_orgnr` to find all tenders from a specific Norwegian buyer.
-- `get_tender` — Full details by ID. Accepts both EU-tier format (`317565-2026`) and Norway-tier format (`2026-108414`).
-- `search_awards` — Search contract awards (who won what)
-- `get_tender_leaderboard` — Top public-sector buyers in a Nordic country
-- `get_company_contract_wins` — Public-sector contracts won by a Norwegian company
-
-### Company data
-- `search_companies` — Search by name, industry, location (Norway: full-text; Denmark + Finland: identity-only; Sweden + Iceland: not yet supported for full-text — use `get_company` for orgnr lookup)
-- `get_company` — Full registry record. `country=NOR` (richest), `SWE` (identity), `DNK` (identity + phone + employees), `FIN` (identity + name history)
-- `get_company_contact` — Norway: public email + phone (with MX-verified email candidates) + named executives
-- **`get_company_se_contact` — Sweden: identity + AI-enriched contacts (MX-verified emails, direct phones, named executives where publicly documented)**
-- `get_company_narrative` — AI-generated executive summary
-- `get_company_peers` — Peer-cohort benchmarks
-- `get_company_snapshot` — One-call snapshot across every data layer
-- `get_company_changes` — Registry change history
-- `get_company_subsidiaries` — Subsidiaries registered under this orgnr
-- `bulk_get_companies` — Enrich a list of up to 100 companies in one call
-
-### Financials & ownership (Norway)
-- `get_company_accounts` — Annual accounts (revenue, profit, equity)
-- `get_company_shareholders` — Full shareholder list — 3M+ positions across 396K companies
-- `get_shareholder_portfolio` — All companies a person/entity owns shares in
-
-### Officer & network graph (Norway)
-- `search_persons` — Search persons in the Norwegian officer network
-- `get_person` — Full role history across Norwegian companies
-- `find_company_path` — Shortest path between two companies through shared officers
-- `get_person_network` — Find who is connected to a person via shared boards
-
-### News
-- `get_company_news` — Recent Norwegian-language news mentioning a company
-- `search_news` — Search Norwegian news headlines
-
-### R&D
-- `search_eu_grants` — Search EU research-grant history
-- `get_company_eu_grants` — Norwegian company's R&D grant participations
-
-### Tech intelligence
-- `find_companies_using_tech` — Norwegian companies using a specific technology
-
-### Compliance
-- `screen_for_sanctions` — Screen any name against international sanctions lists
-- `check_company_sanctions` — Sanctions screening for a Norwegian company + its officers
-
-## Example prompts
-
-- *"Which Norwegian municipalities tendered snow-clearing contracts under 5M NOK with deadlines in the next 30 days?"* (uses below-threshold municipal coverage)
+- *"Find Norwegian electricians in Stavanger with 5+ employees and verified contact emails."*
 - *"Pull the latest accounts and shareholders for orgnr 923609016."*
-- *"Get the verified contact emails and CFO for Klarna AB (Swedish orgnr 5566370985)."*
-- *"Find Norwegian companies using Snowflake."*
-- *"Who sits on the boards of all three of these companies?"*
-- *"Screen this list of suppliers against sanctions lists."*
-- *"Show me R&D grants won by Norwegian SMBs in clean energy."*
+- *"Give me a full KYB pack on this counterparty before we onboard them."*
+- *"Verify this invoice — orgnr 923609016 asking us to pay German IBAN DE89370400440532013000. Is that suspicious?"*
+- *"Which Norwegian municipalities tendered snow-clearing contracts under 5M NOK with deadlines in the next 30 days?"*
+- *"Resolve ceo@equinor.com to a company."*
+- *"Find 20 lookalike companies for Cognite for our prospect list."*
+- *"Look up Tesla's most recent 10-K filing."*
 
 ## Pricing
 
@@ -127,3 +169,7 @@ See [nordicdata.cloud](https://nordicdata.cloud).
 - Docs: [nordicdata.cloud/docs](https://nordicdata.cloud/docs)
 - LLM-friendly site index: [nordicdata.cloud/llms.txt](https://nordicdata.cloud/llms.txt)
 - OpenAPI spec: [api.nordicdata.cloud/openapi.json](https://api.nordicdata.cloud/openapi.json)
+
+## License
+
+MIT — see `LICENSE`.

package/bin/cli.js

@@ -28,8 +28,9 @@ const HELP = `${c('bold', 'nordic-data')} ${c('dim', '— every Norwegian compan
 
 ${c('bold', 'USAGE')}
   nordic-data <command> [args]
+  nordic-data <command> --help    ${c('dim', '# per-command help with examples')}
 
-${c('bold', 'COMMANDS')}
+${c('bold', 'COMMANDS — core lookup (NO + SE)')}
   search <query>             Search companies by name or org number
   lookup <orgnr>             Full snapshot of one company
   contacts <orgnr>           Emails, phones, and named executives
@@ -40,6 +41,32 @@ ${c('bold', 'COMMANDS')}
   sanctions <orgnr>          Sanctions screening (EU/UN/OFAC) hits
   shareholders <orgnr>       Shareholder graph aggregates (Norway)
   contacts-se <orgnr>        Sweden: identity + AI-enriched contacts (10-digit orgnr)
+
+${c('bold', 'COMMANDS — discovery (v0.4.0)')}
+  find <q>                   Universal resolver: name / orgnr / domain / email → company
+  list <profession>          Filter NO companies by industry (× --city × --employees-min)
+  nl "<question>"            Natural-language discovery (LLM parses → filter spec → results)
+  near <lat> <lng>           Geo-radius search (--radius km, --profession <slug>)
+  similar <orgnr>            Lookalike companies by industry + geo + size
+  trades <slug>              Vertical shortcut: elektriker, rorlegger, snekker, tannlege, etc.
+  decision-makers <orgnr>    CEO + board + named contacts in one call
+  resolve <type> <value>     email / domain / phone / iban / vat / lei / address / person → entity
+
+${c('bold', 'COMMANDS — KYB / Compliance / AI')}
+  kyb <orgnr>                One-call due-diligence pack (identity + sanctions + officers + signals)
+  diff <orgnr>               Typed changelog of recent changes (--since YYYY-MM-DD)
+  explain <orgnr>            AI-generated 3-sentence narrative about the company
+  ask <orgnr> "<question>"   Q&A grounded in the company's data
+  pitch <orgnr>              Sales talking-points (referencing concrete facts)
+  verify-invoice <o> <iban>  Invoice fraud check via IBAN country-mismatch heuristic
+
+${c('bold', 'COMMANDS — United States (SEC EDGAR + USA Spending)')}
+  us-search <query>          Search US public companies by name / ticker
+  us-lookup <q>              Resolve a US public company by CIK, ticker, or name
+  us-filings <cik>           Recent SEC filings (--type 10-K to filter)
+  us-kyb <cik>               US KYB pack (identity + filings + sanctions + federal contracts)
+
+${c('bold', 'COMMANDS — meta')}
   mcp                        Show MCP setup snippet for Claude Desktop / Cursor
   signup                     Open the free-tier signup page in your browser
   --help, -h                 Show this help
@@ -51,15 +78,39 @@ ${c('bold', 'FLAGS')}
   --no-color                 Disable ANSI colors
 
 ${c('bold', 'EXAMPLES')}
-  ${c('dim', '# Look up Equinor (no key — uses the public widget tier)')}
+  ${c('dim', '# Core lookup')}
   nordic-data search equinor
   nordic-data lookup 923609016
   nordic-data contacts 923609016
-
-  ${c('dim', '# Sweden: lookup + AI-enriched contacts (10-digit orgnr)')}
-  nordic-data contacts-se 5566370985
-
-  ${c('dim', '# Use your API key for higher limits')}
+  nordic-data contacts-se 5566370985        ${c('dim', '# Sweden (10-digit orgnr)')}
+
+  ${c('dim', '# Discovery — find a list of companies')}
+  nordic-data list elektriker --city Stavanger --employees-min 5
+  nordic-data nl "dentists in Bergen with 10+ employees"
+  nordic-data trades snekker --city Tromsø
+  nordic-data near 58.97 5.73 --radius 5 --profession rorlegger
+
+  ${c('dim', '# Universal resolver')}
+  nordic-data find Cognite                  ${c('dim', '# name → company')}
+  nordic-data resolve email ceo@equinor.com ${c('dim', '# email → company')}
+  nordic-data resolve domain cognite.com    ${c('dim', '# domain → company')}
+
+  ${c('dim', '# KYB / Compliance')}
+  nordic-data kyb 923609016
+  nordic-data verify-invoice 923609016 DE89370400440532013000
+  nordic-data diff 923609016 --since 2026-01-01
+
+  ${c('dim', '# AI / NL')}
+  nordic-data explain 923609016
+  nordic-data ask 923609016 "who chairs the board"
+  nordic-data pitch 923609016
+
+  ${c('dim', '# United States (SEC EDGAR + USA Spending)')}
+  nordic-data us-search Microsoft
+  nordic-data us-kyb 0000789019
+  nordic-data us-filings 0000320193 --type 10-K
+
+  ${c('dim', '# Use your API key for full access (most v0.4.0 commands require a key)')}
   export NORDIC_DATA_KEY=nrd_live_...
   nordic-data lookup 923609016 --json | jq
 
@@ -72,22 +123,241 @@ ${c('bold', 'FREE TIER')}
   ${c('dim', 'Without a key, this CLI uses the public widget tier (4 lookups/IP/24h).')}
 `;
 
+// Per-command help text. Shown when user runs `nordic-data <cmd> --help`.
+const COMMAND_HELP = {
+  search: `${c('bold', 'nordic-data search')} ${c('dim', '<query> [--json]')}
+
+Search Norwegian companies by name or organisation number.
+
+${c('bold', 'EXAMPLES')}
+  ${c('dim', '# Fuzzy name search')}
+  nordic-data search equinor
+
+  ${c('dim', '# JSON for scripting')}
+  nordic-data search "telenor" --json | jq '.results[0].orgnr'
+
+  ${c('dim', '# Lookup by orgnr also works as a single-result search')}
+  nordic-data search 923609016
+`,
+  lookup: `${c('bold', 'nordic-data lookup')} ${c('dim', '<orgnr> [--json]')}
+
+Full snapshot of one company. Includes identity, address, key personnel,
+contacts, and a sanctions hit count.
+
+${c('bold', 'ORGNR FORMATS')}
+  9 digits   ${c('dim', '— Norway (e.g. 923609016)')}
+  10 digits  ${c('dim', '— Sweden (e.g. 5566370985 or 556637-0985) — auto-routes to Sweden command')}
+
+${c('bold', 'EXAMPLES')}
+  ${c('dim', '# Norway')}
+  nordic-data lookup 923609016
+
+  ${c('dim', '# Sweden (10-digit orgnr — auto-detected)')}
+  nordic-data lookup 5566370985
+
+  ${c('dim', '# Raw JSON')}
+  nordic-data lookup 923609016 --json | jq .identity.name
+`,
+  contacts: `${c('bold', 'nordic-data contacts')} ${c('dim', '<orgnr> [--json]')}
+
+Verified emails, phones, and named executives for a Norwegian company.
+Cached 30 days. Empty when no public contact info is available.
+
+${c('bold', 'EXAMPLES')}
+  nordic-data contacts 923609016
+  nordic-data contacts 923609016 --json
+`,
+  'contacts-se': `${c('bold', 'nordic-data contacts-se')} ${c('dim', '<orgnr> [--json]')}
+
+Sweden: identity + AI-enriched contacts (verified emails, phones, named executives).
+
+${c('bold', 'EXAMPLES')}
+  nordic-data contacts-se 5566370985
+  nordic-data contacts-se 556637-0985   ${c('dim', '# dash is accepted')}
+`,
+  board: `${c('bold', 'nordic-data board')} ${c('dim', '<orgnr> [--json]')}
+
+Current board + leadership for a Norwegian company. Shows role category
+(styre / ledelse / other) and full role description.
+
+${c('bold', 'EXAMPLES')}
+  nordic-data board 923609016
+`,
+  finances: `${c('bold', 'nordic-data finances')} ${c('dim', '<orgnr> [--json]')}
+
+Latest annual accounts for a Norwegian company: revenue, operating profit,
+net result, balance sheet totals, equity, and computed ratios.
+
+${c('bold', 'EXAMPLES')}
+  nordic-data finances 923609016
+  nordic-data finances 923609016 --json | jq .ratios
+`,
+  procurement: `${c('bold', 'nordic-data procurement')} ${c('dim', '<orgnr> [--json]')}
+
+Public-sector contract aggregates for a Norwegian company — count of
+contracts won, estimated total value, top buyers.
+
+${c('bold', 'EXAMPLES')}
+  nordic-data procurement 923609016
+`,
+  grants: `${c('bold', 'nordic-data grants')} ${c('dim', '<orgnr> [--json]')}
+
+EU R&D grant participations for a Norwegian company. Returns each grant
+with role (coordinator/participant), EU contribution, project budget.
+
+${c('bold', 'EXAMPLES')}
+  nordic-data grants 923609016
+`,
+  sanctions: `${c('bold', 'nordic-data sanctions')} ${c('dim', '<orgnr> [--json]')}
+
+Sanctions / AML / KYC check. Screens the company AND its officers against
+international watchlists (OFAC SDN; EU + UN forthcoming). Auto-fetches
+officers if not yet cached — one call gives you the full picture.
+
+${c('bold', 'EXAMPLES')}
+  nordic-data sanctions 923609016
+`,
+  shareholders: `${c('bold', 'nordic-data shareholders')} ${c('dim', '<orgnr> [--json]')}
+
+Shareholder cap table for a Norwegian AS — ownership %, share count, identity
+of each holder.
+
+${c('bold', 'EXAMPLES')}
+  nordic-data shareholders 923609016
+`,
+  mcp: `${c('bold', 'nordic-data mcp')}
+
+Print the MCP server config snippet to drop into Claude Desktop / Cursor.
+Set NORDIC_DATA_KEY first to embed your key in the snippet.
+
+${c('bold', 'EXAMPLES')}
+  ${c('dim', '# Print the snippet')}
+  nordic-data mcp
+
+  ${c('dim', '# Wire your key in the printed snippet')}
+  export NORDIC_DATA_KEY=nrd_live_...
+  nordic-data mcp
+`,
+  signup: `${c('bold', 'nordic-data signup')}
+
+Open the free-tier signup page in your browser. 500 requests/month, no card.
+`,
+  // v0.4.0 — Discovery + KYB + AI/NL + US
+  find: `${c('bold', 'nordic-data find')} ${c('dim', '<query>')}
+Universal resolver. Pass anything (name, orgnr, domain, email); get the best company match plus alternates.
+  nordic-data find Cognite
+  nordic-data find 918274758
+  nordic-data find cognite.com
+  nordic-data find ceo@equinor.com
+`,
+  list: `${c('bold', 'nordic-data list')} ${c('dim', '<profession> [--city <city>] [--employees-min N] [--employees-max N] [--limit N]')}
+Filter Norwegian companies by plain-text profession (auto-mapped to NACE) + city + size.
+  nordic-data list elektriker --city Stavanger --employees-min 5
+  nordic-data list tannlege --city Bergen
+  nordic-data list snekker --city Tromsø --limit 20
+`,
+  nl: `${c('bold', 'nordic-data nl')} ${c('dim', '"<natural-language query>"')}
+LLM parses your sentence into a filter spec and runs the search. Returns the parsed filter plus matching companies.
+  nordic-data nl "electricians in Stavanger with 5+ employees"
+  nordic-data nl "Norwegian fintech startups under 20 employees"
+`,
+  kyb: `${c('bold', 'nordic-data kyb')} ${c('dim', '<orgnr>')}
+One-call due-diligence bundle: identity + officers + sanctions (company + all officers) + bankruptcy + sister companies + recent changes + shell-likelihood signals.
+  nordic-data kyb 923609016
+`,
+  explain: `${c('bold', 'nordic-data explain')} ${c('dim', '<orgnr>')}
+AI-generated 3-sentence narrative: who the company is, who runs it, where they're going. Uses only structured registry data — no invented facts.
+  nordic-data explain 923609016
+`,
+  ask: `${c('bold', 'nordic-data ask')} ${c('dim', '<orgnr> "<question>"')}
+Q&A grounded in the company's registry + contact + contract data. Answers "Not available in the data provided" when the answer isn't in the data.
+  nordic-data ask 923609016 "who chairs the board"
+  nordic-data ask 923609016 "how many employees and where are they based"
+`,
+  pitch: `${c('bold', 'nordic-data pitch')} ${c('dim', '<orgnr>')}
+Sales talking points (4-5 numbered items) referencing concrete facts: recent contract wins, new execs, growth signals.
+  nordic-data pitch 923609016
+`,
+  'verify-invoice': `${c('bold', 'nordic-data verify-invoice')} ${c('dim', '<orgnr> <iban>')}
+Invoice fraud heuristic via IBAN-country-mismatch check. If a supposed Norwegian supplier asks you to pay a German IBAN, that's a classic CEO-fraud pattern.
+  nordic-data verify-invoice 923609016 DE89370400440532013000
+  nordic-data verify-invoice 923609016 NO9386011117947
+`,
+  resolve: `${c('bold', 'nordic-data resolve')} ${c('dim', '<type> <value>')}
+Resolvers — anything → entity. Types: email, domain, phone, iban, vat, lei, address, person, wikipedia.
+  nordic-data resolve email ceo@equinor.com
+  nordic-data resolve domain cognite.com
+  nordic-data resolve phone "+47 519 90 000"
+  nordic-data resolve iban DE89370400440532013000
+`,
+  near: `${c('bold', 'nordic-data near')} ${c('dim', '<lat> <lng> [--radius 5] [--profession <slug>] [--limit N]')}
+Geo-radius search around a coordinate. Optional industry filter.
+  nordic-data near 58.97 5.73 --radius 5 --profession rorlegger
+`,
+  similar: `${c('bold', 'nordic-data similar')} ${c('dim', '<orgnr>')}
+Find up to 20 lookalike companies (same industry + country, prioritised by same-city and closest employee count).
+  nordic-data similar 918274758
+`,
+  'decision-makers': `${c('bold', 'nordic-data decision-makers')} ${c('dim', '<orgnr>')}
+Synthesised list of key roles (CEO, CFO, chair, board) plus role-labelled named contacts.
+  nordic-data decision-makers 923609016
+`,
+  trades: `${c('bold', 'nordic-data trades')} ${c('dim', '<slug> [--city <city>] [--limit N]')}
+Vertical shortcut for common Norwegian trades. Slugs include: elektriker, rorlegger, snekker, tomrer, maler, murer, tannlege, lege, advokat, frisor, restaurant, kafe, etc.
+  nordic-data trades elektriker --city Oslo
+`,
+  diff: `${c('bold', 'nordic-data diff')} ${c('dim', '<orgnr> [--since YYYY-MM-DD]')}
+Typed changelog: board changes, ownership transfers, bankruptcy events etc. since a given date (default 30 days ago).
+  nordic-data diff 923609016 --since 2026-01-01
+`,
+  'us-search': `${c('bold', 'nordic-data us-search')} ${c('dim', '<query>')}
+Search ~10,000 US public companies (SEC EDGAR) by name or ticker.
+  nordic-data us-search Microsoft
+  nordic-data us-search AAPL
+`,
+  'us-lookup': `${c('bold', 'nordic-data us-lookup')} ${c('dim', '<query>')}
+Resolve a US public company by CIK, ticker, or name. Returns SEC identity (SIC, state, city, address).
+  nordic-data us-lookup Tesla
+  nordic-data us-lookup 0000789019
+`,
+  'us-filings': `${c('bold', 'nordic-data us-filings')} ${c('dim', '<cik> [--type 10-K]')}
+Recent SEC filings for a US public company with direct EDGAR URLs.
+  nordic-data us-filings 0000320193 --type 10-K
+`,
+  'us-kyb': `${c('bold', 'nordic-data us-kyb')} ${c('dim', '<cik>')}
+US KYB pack: SEC identity + recent filings + sanctions screen + recent federal contracts (USA Spending).
+  nordic-data us-kyb 0000789019
+`,
+};
+
 const args = process.argv.slice(2);
 let useJson = false;
 let useColor = isTTY;
+let wantsHelp = false;
 const cleanArgs = [];
 for (let i = 0; i < args.length; i++) {
   const a = args[i];
   if (a === '--json') useJson = true;
   else if (a === '--no-color') useColor = false;
   else if (a === '--key') { process.env.NORDIC_DATA_KEY = args[++i] || ''; }
-  else if (a === '--help' || a === '-h') { console.log(HELP); process.exit(0); }
+  else if (a === '--help' || a === '-h') wantsHelp = true;
   else if (a === '--version' || a === '-v') {
     const { version } = require('../package.json');
     console.log(version);
     process.exit(0);
   } else cleanArgs.push(a);
 }
+
+// Resolve per-command help: `nordic-data <cmd> --help` shows command-specific help.
+// `nordic-data --help` (no command) shows the global help.
+if (wantsHelp) {
+  if (cleanArgs.length > 0 && COMMAND_HELP[cleanArgs[0]]) {
+    console.log(COMMAND_HELP[cleanArgs[0]]);
+  } else {
+    console.log(HELP);
+  }
+  process.exit(0);
+}
 if (cleanArgs.length === 0) { console.log(HELP); process.exit(0); }
 
 const [cmd, ...rest] = cleanArgs;
@@ -104,10 +374,26 @@ async function publicRequest(path) {
 
   const res = await fetch(`${API_BASE}${path}`, { headers });
   if (!res.ok) {
-    if (res.status === 429) die('Rate limited. Free tier is 4 lookups per IP per 24h. Set NORDIC_DATA_KEY=... for higher limits.');
-    if (res.status === 401) die('Auth required. Set NORDIC_DATA_KEY=... or use --key. Sign up at https://nordicdata.cloud/?signup=free');
-    if (res.status === 404) die('Not found.');
-    die(`API error ${res.status}: ${await res.text()}`);
+    if (res.status === 429) die('Rate limited. Free tier is 4 lookups per IP per 24h. Set NORDIC_DATA_KEY=... for higher limits.\n  Sign up at https://nordicdata.cloud/?signup=free (500 requests/month, no card).');
+    if (res.status === 401) die('Auth required. Set NORDIC_DATA_KEY=... or pass --key <key>.\n  Sign up at https://nordicdata.cloud/?signup=free (500 requests/month, no card).');
+    // Try to parse a structured JSON error and surface a useful message + hint.
+    let body = null;
+    try { body = await res.json(); } catch {}
+    const errCode = body && body.error;
+    const errMsg = body && body.message;
+    if (res.status === 404) {
+      if (errCode === 'not_found' && body.orgnr) {
+        die(`Company ${body.orgnr} not found in the official register.\n  ${c('dim', 'If you do not know the orgnr, try:')} nordic-data search <name>`);
+      }
+      die(`Not found.\n  ${c('dim', 'Tip:')} nordic-data search <name>  ${c('dim', 'to find the orgnr first.')}`);
+    }
+    if (res.status === 400 && errCode === 'invalid_orgnr') {
+      die(`Invalid Norwegian organisation number — must be 9 digits.\n  ${c('dim', 'Tip:')} nordic-data search <name>  ${c('dim', 'to find the orgnr.')}`);
+    }
+    if (res.status === 400 && errMsg) die(errMsg);
+    if (res.status === 402) die(`Payment required. ${errMsg || 'Plan does not include this endpoint.'}\n  See plans: https://nordicdata.cloud/#pricing`);
+    if (res.status >= 500) die(`Server error (${res.status}). Try again in a moment. If it persists, email support@nordicdata.cloud.`);
+    die(`API error ${res.status}: ${errMsg || (body && JSON.stringify(body)) || 'unknown error'}`);
   }
   return res.json();
 }
@@ -153,7 +439,16 @@ async function search(query) {
 }
 
 async function lookup(orgnr) {
-  if (!orgnr) die('Usage: nordic-data lookup <orgnr>');
+  if (!orgnr) die('Usage: nordic-data lookup <orgnr>\n  Norway: 9-digit orgnr. Sweden: 10-digit orgnr (with or without dash).');
+  // Auto-route Swedish orgnrs (10 digits, with or without dash) to the SE flow.
+  const cleaned = String(orgnr).replace(/[-\s]/g, '');
+  if (/^\d{10}$/.test(cleaned)) {
+    console.log(c('dim', `(10-digit orgnr detected — routing to Sweden command)\n`));
+    return contactsSe(orgnr);
+  }
+  if (!/^\d{9}$/.test(cleaned)) {
+    die(`Invalid orgnr "${orgnr}".\n  Norway uses 9 digits (e.g. 923609016).\n  Sweden uses 10 digits (e.g. 5566370985 or 556637-0985).\n  ${c('dim', 'Tip:')} nordic-data search <name>  ${c('dim', 'to find it.')}`);
+  }
   const snap = await publicRequest(`/_/look/${orgnr}`);
   if (useJson) return console.log(JSON.stringify(snap, null, 2));
 
@@ -384,6 +679,296 @@ function fmt(n, currency) {
   return `${cur} ${n.toLocaleString('nb-NO')}`;
 }
 
+// ── v0.4.0 — Discovery + KYB + AI/NL + US ─────────────────
+// Helper to parse --flag value args from a sub-array.
+function flag(arr, name, def) {
+  const i = arr.indexOf(`--${name}`);
+  if (i < 0 || i === arr.length - 1) return def;
+  return arr[i + 1];
+}
+function bool(arr, name) { return arr.includes(`--${name}`); }
+
+// Find: universal lookup (resolves name / orgnr / domain / email)
+async function find(q) {
+  if (!q) die('Usage: nordic-data find <query>\n  Pass anything — name, orgnr, domain, or email.');
+  const data = await publicRequest(`/companies/lookup?q=${encodeURIComponent(q)}`);
+  if (useJson) return console.log(JSON.stringify(data, null, 2));
+  if (!data.resolved) {
+    console.log(c('dim', `No match for "${q}".`));
+    if (data.note) console.log(c('dim', '  ' + data.note));
+    return;
+  }
+  const r = data.resolved;
+  header(`${r.name || 'Match'}${r.orgnr ? c('dim', `  (${r.orgnr})`) : ''}`);
+  pretty('Resolved by', data.resolved_by);
+  pretty('Country', r.country || (r.business_address && r.business_address.country_code) || '');
+  pretty('Status', r.status || '');
+  pretty('City', (r.business_address && r.business_address.city) || r.city || '');
+  if (r.nace && r.nace[0]) pretty('NACE', `${r.nace[0].code} ${r.nace[0].description || ''}`);
+  pretty('Employees', r.employees);
+  pretty('Website', r.website);
+  if (data.alternates && data.alternates.length) {
+    console.log(c('dim', `\n  ${data.alternates.length} alternate match(es):`));
+    for (const a of data.alternates.slice(0, 5)) console.log(`    ${c('dim', a.orgnr || '')}  ${a.name}`);
+  }
+}
+
+// List: filter Norwegian companies by industry × city × size
+async function list(args) {
+  const profession = args[0];
+  if (!profession) die('Usage: nordic-data list <profession> [--city <city>] [--employees-min N] [--employees-max N] [--limit N]\n  Examples:\n    nordic-data list elektriker --city Stavanger --employees-min 5\n    nordic-data list tannlege --city Bergen\n    nordic-data list snekker --city Tromsø');
+  const params = new URLSearchParams({ profession });
+  if (flag(args, 'city')) params.set('city', flag(args, 'city'));
+  if (flag(args, 'employees-min')) params.set('min_employees', flag(args, 'employees-min'));
+  if (flag(args, 'employees-max')) params.set('max_employees', flag(args, 'employees-max'));
+  if (flag(args, 'limit')) params.set('limit', flag(args, 'limit'));
+  if (bool(args, 'active')) params.set('active', 'true');
+  const data = await publicRequest(`/companies/no/list?${params}`);
+  if (useJson) return console.log(JSON.stringify(data, null, 2));
+  header(`${data.count} ${profession}${data.filter && data.filter.city ? ` in ${data.filter.city}` : ''}`);
+  for (const r of (data.results || []).slice(0, 50)) {
+    const city = (r.business_address && r.business_address.city) || '';
+    const emp = r.employees != null ? c('dim', ` · ${r.employees} emp`) : '';
+    console.log(`  ${c('orange', r.orgnr)}  ${r.name}${city ? c('dim', `  · ${city}`) : ''}${emp}`);
+  }
+}
+
+// NL: natural-language discovery
+async function nl(query) {
+  if (!query) die('Usage: nordic-data nl "<natural language query>"\n  Examples:\n    nordic-data nl "electricians in Stavanger with 5+ employees"\n    nordic-data nl "dentists in Bergen"');
+  const data = await publicRequest(`/companies/nl-search?q=${encodeURIComponent(query)}`);
+  if (useJson) return console.log(JSON.stringify(data, null, 2));
+  if (data.filter_spec) {
+    console.log(c('dim', `Interpreted as: ${JSON.stringify(data.filter_spec)}`));
+  }
+  header(`${data.count} match(es)`);
+  for (const r of (data.results || []).slice(0, 50)) {
+    const city = (r.business_address && r.business_address.city) || '';
+    const emp = r.employees != null ? c('dim', ` · ${r.employees} emp`) : '';
+    console.log(`  ${c('orange', r.orgnr)}  ${r.name}${city ? c('dim', `  · ${city}`) : ''}${emp}`);
+  }
+}
+
+// KYB: one-call due-diligence bundle
+async function kyb(orgnr) {
+  if (!orgnr) die('Usage: nordic-data kyb <orgnr>\n  Returns: identity + officers + sanctions on company AND officers + sister companies + recent changes + shell-likelihood.');
+  const data = await publicRequest(`/companies/${orgnr}/kyb-pack`);
+  if (useJson) return console.log(JSON.stringify(data, null, 2));
+  const i = data.identity || {};
+  header(`KYB pack — ${i.name || orgnr}`);
+  pretty('Orgnr', data.orgnr);
+  pretty('Status', i.status);
+  pretty('Employees', i.employees);
+  pretty('Generated', data.generated_at);
+  if (data.officers && data.officers.all) {
+    console.log(c('bold', `\n  Officers (${data.officers.all.length}):`));
+    for (const o of data.officers.all.slice(0, 10)) {
+      console.log(`    ${c('orange', (o.role || '').padEnd(20))} ${c('bold', (o.person && o.person.name) || o.name || '')}`);
+    }
+  }
+  const sa = data.sanctions || {};
+  console.log(c('bold', '\n  Sanctions:'));
+  console.log(`    Company matches:  ${(sa.company_matches || []).length}`);
+  const om = (sa.officer_matches || []).filter(x => (x.matches || []).length).length;
+  console.log(`    Officers with hits: ${om}`);
+  if (data.sister_companies && data.sister_companies.length) pretty('Sister cos', data.sister_companies.length);
+  if (data.recent_changes && data.recent_changes.length) pretty('Recent changes', data.recent_changes.length);
+  const sh = data.shell_signals || {};
+  const shell = [sh.no_employees && 'no employees', sh.fresh && 'fresh<1y', sh.no_website && 'no website'].filter(Boolean).join(', ');
+  if (shell) pretty('Shell signals', c('yellow', shell));
+}
+
+// Explain: AI 3-sentence narrative
+async function explain(orgnr) {
+  if (!orgnr) die('Usage: nordic-data explain <orgnr>');
+  const data = await publicRequest(`/companies/${orgnr}/explain`);
+  if (useJson) return console.log(JSON.stringify(data, null, 2));
+  header(`Narrative for ${orgnr}`);
+  console.log(`  ${data.narrative || c('dim', '(no narrative)')}`);
+}
+
+// Ask: Q&A about a company
+async function ask(args) {
+  const orgnr = args[0];
+  const question = args.slice(1).join(' ');
+  if (!orgnr || !question) die('Usage: nordic-data ask <orgnr> <question>\n  Example: nordic-data ask 923609016 "who chairs the board"');
+  const data = await publicRequest(`/companies/${orgnr}/q?question=${encodeURIComponent(question)}`);
+  if (useJson) return console.log(JSON.stringify(data, null, 2));
+  header(`Q: ${question}`);
+  console.log(`  ${data.answer || c('dim', '(no answer)')}`);
+}
+
+// Pitch: sales talking points
+async function pitch(orgnr) {
+  if (!orgnr) die('Usage: nordic-data pitch <orgnr>\n  Returns 4-5 sales talking points referencing concrete facts.');
+  const data = await publicRequest(`/companies/${orgnr}/talking-points`);
+  if (useJson) return console.log(JSON.stringify(data, null, 2));
+  header(`Sales talking points for ${orgnr}`);
+  console.log(data.talking_points || c('dim', '(none)'));
+}
+
+// Verify invoice
+async function verifyInvoice(args) {
+  const orgnr = args[0];
+  const iban = args[1];
+  if (!orgnr || !iban) die('Usage: nordic-data verify-invoice <orgnr> <iban>\n  Flags fraud risk if IBAN country mismatches the company’s registered country.');
+  const data = await publicRequest(`/verify/invoice?orgnr=${encodeURIComponent(orgnr)}&iban=${encodeURIComponent(iban)}`);
+  if (useJson) return console.log(JSON.stringify(data, null, 2));
+  header(`Invoice check — orgnr ${orgnr} → IBAN ${iban}`);
+  const risk = data.risk === 'high' ? c('red', 'HIGH') : data.risk === 'low' ? c('green', 'LOW') : data.risk;
+  pretty('Risk', risk);
+  pretty('IBAN country', data.iban_country);
+  pretty('Company country', data.company_country);
+  console.log('\n  ' + c('dim', data.reason || ''));
+}
+
+// Universal /resolve/* — type one of: email, domain, phone, iban, vat, lei, address, person, wikipedia
+async function resolve(args) {
+  const type = args[0];
+  const value = args[1];
+  const validTypes = ['email','domain','phone','iban','vat','lei','address','person','wikipedia'];
+  if (!type || !validTypes.includes(type)) die(`Usage: nordic-data resolve <type> <value>\n  Type: ${validTypes.join(' | ')}\n  Examples:\n    nordic-data resolve email ceo@equinor.com\n    nordic-data resolve domain cognite.com\n    nordic-data resolve phone "+47 519 90 000"\n    nordic-data resolve iban DE89370400440532013000`);
+  if (!value) die(`Usage: nordic-data resolve ${type} <value>`);
+  const param = type === 'email' ? 'address' : type === 'iban' ? 'iban' : type === 'vat' ? 'vat' : type === 'lei' ? 'lei' : type === 'wikipedia' ? 'title' : type === 'address' ? 'street' : type === 'person' ? 'name' : type === 'phone' ? 'number' : 'domain';
+  const data = await publicRequest(`/resolve/${type}?${param}=${encodeURIComponent(value)}`);
+  if (useJson) return console.log(JSON.stringify(data, null, 2));
+  console.log(JSON.stringify(data, null, 2));
+}
+
+// Near: geo-radius search
+async function near(args) {
+  const lat = args[0];
+  const lng = args[1];
+  if (!lat || !lng) die('Usage: nordic-data near <lat> <lng> [--radius 5] [--profession <profession>] [--limit N]');
+  const params = new URLSearchParams({ lat, lng });
+  params.set('radius_km', flag(args, 'radius', '5'));
+  if (flag(args, 'profession')) params.set('profession', flag(args, 'profession'));
+  if (flag(args, 'limit')) params.set('limit', flag(args, 'limit'));
+  const data = await publicRequest(`/companies/near?${params}`);
+  if (useJson) return console.log(JSON.stringify(data, null, 2));
+  header(`${data.count} companies within ${params.get('radius_km')} km of ${lat},${lng}`);
+  for (const r of (data.results || []).slice(0, 50)) {
+    console.log(`  ${c('orange', r.orgnr)}  ${r.name}${c('dim', `  · ${r.distance_km} km`)}`);
+  }
+}
+
+// Similar companies
+async function similar(orgnr) {
+  if (!orgnr) die('Usage: nordic-data similar <orgnr>\n  Returns 20 lookalike companies based on industry + geo + size.');
+  const data = await publicRequest(`/companies/similar/${orgnr}?limit=20`);
+  if (useJson) return console.log(JSON.stringify(data, null, 2));
+  header(`Similar to ${orgnr}`);
+  for (const r of (data.similar || []).slice(0, 30)) {
+    console.log(`  ${c('orange', r.orgnr)}  ${r.name}${r.city ? c('dim', `  · ${r.city}`) : ''}${r.employees ? c('dim', ` · ${r.employees} emp`) : ''}`);
+  }
+}
+
+// Decision makers
+async function decisionMakers(orgnr) {
+  if (!orgnr) die('Usage: nordic-data decision-makers <orgnr>');
+  const data = await publicRequest(`/companies/${orgnr}/decision-makers`);
+  if (useJson) return console.log(JSON.stringify(data, null, 2));
+  header(`Decision-makers for ${orgnr}`);
+  for (const o of (data.key_officers || [])) {
+    console.log(`  ${c('orange', (o.role || '').padEnd(24))} ${c('bold', (o.person && o.person.name) || '')}`);
+  }
+  if ((data.named_contacts || []).length) {
+    console.log(c('dim', '\n  Named contacts:'));
+    for (const n of data.named_contacts) {
+      console.log(`    ${c('orange', n.role)}  ${c('bold', n.name)}${n.email ? c('dim', ` · ${n.email}`) : ''}`);
+    }
+  }
+}
+
+// Trades vertical shortcut
+async function trades(args) {
+  const slug = args[0];
+  if (!slug) die('Usage: nordic-data trades <slug> [--city <city>]\n  Examples: nordic-data trades elektriker --city Oslo\n            nordic-data trades rorlegger --city Stavanger\n            nordic-data trades snekker --city Tromsø');
+  const params = new URLSearchParams();
+  if (flag(args, 'city')) params.set('city', flag(args, 'city'));
+  if (flag(args, 'limit')) params.set('limit', flag(args, 'limit'));
+  const data = await publicRequest(`/trades/${slug}/directory?${params}`);
+  if (useJson) return console.log(JSON.stringify(data, null, 2));
+  header(`${data.count} ${slug}${flag(args, 'city') ? ` in ${flag(args, 'city')}` : ''}`);
+  for (const r of (data.results || []).slice(0, 50)) {
+    const city = (r.business_address && r.business_address.city) || '';
+    console.log(`  ${c('orange', r.orgnr)}  ${r.name}${city ? c('dim', `  · ${city}`) : ''}`);
+  }
+}
+
+// Diff: typed changelog
+async function diff(args) {
+  const orgnr = args[0];
+  if (!orgnr) die('Usage: nordic-data diff <orgnr> [--since YYYY-MM-DD]');
+  const params = new URLSearchParams();
+  if (flag(args, 'since')) params.set('since', flag(args, 'since'));
+  const data = await publicRequest(`/companies/${orgnr}/diff?${params}`);
+  if (useJson) return console.log(JSON.stringify(data, null, 2));
+  header(`Changes for ${orgnr} since ${data.since}`);
+  for (const ch of (data.changes || []).slice(0, 50)) {
+    console.log(`  ${c('orange', ch.change_date || '')}  ${ch.change_type || ''}`);
+  }
+  if (!data.changes || !data.changes.length) console.log(c('dim', '  (no changes)'));
+}
+
+// US: search public companies
+async function usSearch(query) {
+  if (!query) die('Usage: nordic-data us-search <query>');
+  const data = await publicRequest(`/companies/us/search?q=${encodeURIComponent(query)}`);
+  if (useJson) return console.log(JSON.stringify(data, null, 2));
+  header(`${data.count} US public company matches for "${query}"`);
+  for (const r of (data.results || []).slice(0, 25)) {
+    console.log(`  ${c('orange', r.cik)}  ${r.name}${r.ticker ? c('dim', `  · ${r.ticker}`) : ''}`);
+  }
+}
+
+async function usLookup(query) {
+  if (!query) die('Usage: nordic-data us-lookup <query>\n  Resolves a US public company by CIK, ticker, or name.');
+  const data = await publicRequest(`/companies/us/lookup?q=${encodeURIComponent(query)}`);
+  if (useJson) return console.log(JSON.stringify(data, null, 2));
+  if (!data.resolved) return console.log(c('dim', data.note || 'No match.'));
+  const r = data.resolved;
+  header(`${r.name} ${c('dim', `(CIK ${r.cik}${r.tickers && r.tickers[0] ? ' · ' + r.tickers[0] : ''})`)}`);
+  pretty('SIC', `${r.sic || ''} ${r.sic_description || ''}`.trim());
+  pretty('State', r.state);
+  pretty('City', r.city);
+  pretty('Address', r.address);
+}
+
+async function usFilings(args) {
+  const cik = args[0];
+  if (!cik) die('Usage: nordic-data us-filings <cik> [--type 10-K]');
+  const params = new URLSearchParams();
+  if (flag(args, 'type')) params.set('type', flag(args, 'type'));
+  const data = await publicRequest(`/companies/us/${cik}/filings?${params}`);
+  if (useJson) return console.log(JSON.stringify(data, null, 2));
+  header(`${data.company} — ${data.count} filing(s)`);
+  for (const f of (data.filings || []).slice(0, 25)) {
+    console.log(`  ${c('orange', f.date.padEnd(11))} ${c('bold', f.form.padEnd(8))} ${c('dim', f.url)}`);
+  }
+}
+
+async function usKyb(cik) {
+  if (!cik) die('Usage: nordic-data us-kyb <cik>');
+  const data = await publicRequest(`/companies/us/${cik}/kyb-pack`);
+  if (useJson) return console.log(JSON.stringify(data, null, 2));
+  const i = data.identity || {};
+  header(`US KYB pack — ${i.name || cik}`);
+  pretty('CIK', i.cik);
+  pretty('SIC', `${i.sic || ''} ${i.sic_description || ''}`.trim());
+  pretty('State', i.state);
+  pretty('City', i.city);
+  if (data.recent_filings && data.recent_filings.length) {
+    console.log(c('bold', '\n  Recent filings:'));
+    for (const f of data.recent_filings) console.log(`    ${c('orange', f.date)}  ${f.form}`);
+  }
+  const sa = data.sanctions || {};
+  pretty('Sanctions matches', (sa.company_matches || []).length);
+  if (data.recent_federal_contracts && data.recent_federal_contracts.length) {
+    pretty('Recent federal contracts', data.recent_federal_contracts.length);
+  }
+}
+
 // ── Dispatch ───────────────────────────────────────────────
 
 (async () => {
@@ -398,6 +983,28 @@ function fmt(n, currency) {
       case 'grants':       await grants(rest[0]); break;
       case 'sanctions':    await sanctions(rest[0]); break;
       case 'shareholders': await shareholders(rest[0]); break;
+      case 'contacts-se':  await contactsSe(rest[0]); break;
+      // v0.4.0 — Discovery, KYB, AI/NL, US
+      case 'find':         await find(rest.join(' ')); break;
+      case 'list':         await list(rest); break;
+      case 'nl':           await nl(rest.join(' ')); break;
+      case 'kyb':          await kyb(rest[0]); break;
+      case 'explain':      await explain(rest[0]); break;
+      case 'ask':          await ask(rest); break;
+      case 'pitch':        await pitch(rest[0]); break;
+      case 'talking-points': await pitch(rest[0]); break;
+      case 'verify-invoice': await verifyInvoice(rest); break;
+      case 'resolve':      await resolve(rest); break;
+      case 'near':         await near(rest); break;
+      case 'similar':      await similar(rest[0]); break;
+      case 'decision-makers': await decisionMakers(rest[0]); break;
+      case 'trades':       await trades(rest); break;
+      case 'diff':         await diff(rest); break;
+      case 'us-search':    await usSearch(rest.join(' ')); break;
+      case 'us-lookup':    await usLookup(rest.join(' ')); break;
+      case 'us-filings':   await usFilings(rest); break;
+      case 'us-kyb':       await usKyb(rest[0]); break;
+      // Meta
       case 'mcp':          mcp(); break;
       case 'signup':       signup(); break;
       default:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nordic-data",
-  "version": "0.2.0",
-  "description": "CLI for Nordic Data \u2014 every Norwegian and Swedish company as one API. Look up companies, board members, owners, sanctions, public procurement, R&D grants, AI-enriched contacts (NO + SE), and financial summaries from your terminal.",
+  "version": "0.4.0",
+  "description": "CLI for Nordic Data \u2014 Norwegian, Swedish, and US business intelligence in one terminal. Discovery (filter by industry \u00d7 city \u00d7 size, natural-language search, geo-radius, similar-companies, trades verticals), universal resolvers (email / domain / phone / IBAN / VAT / LEI \u2192 company), KYB / compliance (one-call due-diligence pack, typed changelog, invoice-fraud heuristic), AI / NL (explain, Q&A, sales talking-points, risk narrative), United States coverage (SEC EDGAR + USA Spending federal contracts), plus the original Nordic core: identity, accounts, officers, sanctions, public procurement, R&D grants, shareholders, AI-enriched contacts.",
   "bin": {
     "nordic-data": "./bin/cli.js"
   },
@@ -16,14 +16,31 @@
     "sweden",
     "swedish",
     "nordic",
+    "united-states",
+    "us",
+    "sec-edgar",
     "company",
     "data",
     "cli",
     "kyb",
+    "kyc",
     "aml",
     "sanctions",
+    "ofac",
     "procurement",
+    "tenders",
+    "lookup",
+    "resolver",
+    "enrichment",
+    "discovery",
+    "natural-language",
     "mcp",
+    "model-context-protocol",
+    "agent",
+    "ai",
+    "fraud",
+    "invoice-fraud",
+    "due-diligence",
     "nordic-data"
   ],
   "homepage": "https://nordicdata.cloud",