NACEBridge API & MCP

NACEBridge kaardistab EU NACE Rev 2.1 viiekohalisteks riiklikeks alamklassideks, mida kasutavad 27 ELi riiki, Ühendkuningriik ja Šveits (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). Kõik neli veebitööriista on saadaval ka programmiliselt:

• search — globaalne + kohalik märksõnaotsing
• decode — laienda riiklik kood kogu ELi hierarhiaks
• cousins — piiriülesed samaväärsed alamklassid
• grid — mitme riigi pivot NACE divisjoni jaoks

Iga /api/v1/* päring kannab X-API-Key päist. Logige sisse ja looge võtmeid oma API-võtmete paneel. Võtmed salvestatakse räsitult — me ei salvesta kunagi avateksti.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

MCP-otspunkt kasutab täpselt sama päist, samu tasemepõhiseid päringulimiite ja sama päringulogi nagu REST-lüüs — erinevad ainult URL (/mcp /api/v1/… asemel) ja JSON-RPC ümbrik. Anonüümne veebiliiklus on UI-tööriistade jaoks lubatud, kuid IP-põhise löögiloenduriga pehmelt piiratud (vt Päringulimiidid).

Aknalimiiti ületavad puhangud tagastavad HTTP 429 koos Retry-After päisega.

Viis ressurssi aadressil https://nacebridge.dev/api/v1/*. Iga otspunkt aktsepteerib GETi query-parameetritega või POSTi JSON-kehaga. Vastused on kujul { ok, tier, data } ja kaasas on X-RateLimit-* päised.

# Decode a Portuguese CAE-Rev4 code
curl -s "https://nacebridge.dev/api/v1/decode?country_iso=PT&code=62010" \
  -H "X-API-Key: $NACEBRIDGE_API_KEY"

# Or POST JSON
curl -s "https://nacebridge.dev/api/v1/cousins" \
  -H "X-API-Key: $NACEBRIDGE_API_KEY" \
  -H "content-type: application/json" \
  -d '{"country_iso":"DE","code":"62.01.0"}'

NACEBridge kasutab MCP Streamable HTTP transport spetsifikatsiooni. Suunake mis tahes MCP klient aadressile:

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 mõlema sisutüübiga Accept-päises:

POST /mcp HTTP/1.1
Content-Type: application/json
Accept: application/json, text/event-stream

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "nacebridge": {
      "url": "https://nacebridge.dev/mcp",
      "headers": { "X-API-Key": "nb_live_..." }
    }
  }
}

ChatGPT (Plus / Pro / Team): lisage kohandatud Connectorina sama URL-iga — search ja fetch tööriistad on Deep Researchi jaoks saadaval.

Cursor: lisage sama URL faili ~/.cursor/mcp.json.

Valmisjuhised, mis õpetavad teie AI-assistendile, millal ja kuidas NACEBridge’i kutsuda. Laadige alla, installige valitud assistendisse ning järgmisel korral, kui kasutaja kleebib NACE / CAE / NAF / WZ / SBI koodi, kasutab assistent arvamise asemel MCP-serverit.

Kõik kolm viitavad ainult avalikele MCP ja REST URL-idele. Need ei sisalda API-võtit — kasutajad annavad oma võtme API-võtmete paneelist.

npm i @nacebridge/sdk

import { NACEBridge } from "@nacebridge/sdk";
const nb = new NACEBridge({ apiKey: process.env.NACEBRIDGE_API_KEY });

const cousins = await nb.cousins({ country_iso: "NL", code: "6201" });
const grid    = await nb.grid({ division: "62", countries: ["PT","FR","DE","NL"] });

Open-source mähis asub public-wrappers/mcp/ all. See on õhuke httpx proxy — kohalikke andmeid pole — seega jääb privaatne lüüs tõe allikaks.

pip install -e ./public-wrappers/mcp

# Then in your MCP client config:
{
  "mcpServers": {
    "nacebridge-local": {
      "command": "python",
      "args": ["-m", "nacebridge_mcp"],
      "env": {
        "NACEBRIDGE_API_KEY": "nb_live_...",
        "NACEBRIDGE_URL": "https://nacebridge.dev"
      }
    }
  }
}

Avaldame masinloetava saidikaardi aadressil /llms.txt ja rikkalikuma indeksi aadressil /llms-full.txt, et AI-assistendid saaksid end ise sisse seada. Avalehe Ask-an-AI plokk annab värske vestluse ChatGPT-le, Claude’ile, Geminile, Grokile või Perplexityle, NACEBridge’i promptiga, mis ütleb assistendile, et ta kasutaks arvamise asemel MCP-serverit.

• 401 — puuduv või vigane X-API-Key
• 402 — taseme kvoot ammendatud, vaja uuendada
• 422 — sisend ei läbinud Zod-valideerimist; vastus sisaldab väljade üksikasju
• 429 — päringulimiit saavutatud, järgige Retry-After päist
• 5xx — intsident; korduskatsed on ohutud (kõik toimingud on ainult lugemiseks)

NACE Rev 2.1 metaandmed © Euroopa Liit, taaskasutatud komisjoni taaskasutuspoliitika alusel. Riiklike alamklasside metaandmed © vastavad riiklikud statistikaametid (INE, INSEE, DESTATIS, CBS, …). NACEBridge’i kaardistusi, normaliseeritud skeemi ja mähiseid levitab TΣKSOMΛ Holding, Lda., ehitanud TΣKSOMΛ Technologies ja toidab TΣKSOMΛ | MΛRKET INTΣLLIGENCE.