NACEBridge API & MCP

NACEBridge preslika EU NACE Rev 2.1 do peteštevilčnih nacionalnih podrazredov, ki jih uporablja 27 držav EU, Združeno kraljestvo in Švica (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). Vsa štiri spletna orodja so na voljo tudi programsko:

• search — globalno + lokalno iskanje po ključni besedi
• decode — razširi nacionalno kodo v celotno hierarhijo EU
• cousins — čezmejni ekvivalentni podrazredi
• grid — večdržavni pivot za divizijo NACE

Vsak zahtevek na /api/v1/* nosi glavo X-API-Key. Prijavite se in ustvarite ključe v svoji nadzorno ploščo API ključev. Ključi so v mirovanju zgoščeni — plaintexta nikoli ne shranjujemo.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

MCP končna točka uporablja natanko isto glavo, iste omejitve po stopnjah in isti dnevnik zahtevkov kot REST prehod — edina razlika sta URL (/mcp namesto /api/v1/…) in ovojnica JSON-RPC. Anonimni spletni promet je dovoljen za UI orodja, vendar je mehko omejen s števcem zadetkov po IP (glejte Omejitve zahtevkov).

Presežki nad omejitvijo okna vrnejo HTTP 429 z Retry-After.

Pet virov pod https://nacebridge.dev/api/v1/*. Vsaka končna točka sprejme GET s query parametri ali POST z JSON telesom. Odgovori so { ok, tier, data } s priloženimi glavami X-RateLimit-*.

# 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 uporablja specifikacijo MCP Streamable HTTP transport . Usmerite kateregakoli MCP odjemalca na:

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 z obema vrstama vsebine v Accept:

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): dodajte kot prilagojen Connector z istim URL-jem — orodji search in fetch sta izpostavljeni za Deep Research.

Cursor: dodajte isti URL v ~/.cursor/mcp.json.

Pripravljena navodila, ki vašega AI pomočnika naučijo, kdaj in kako poklicati NACEBridge. Prenesite, namestite v izbranega pomočnika, in ko uporabnik naslednjič prilepi kodo NACE / CAE / NAF / WZ / SBI, bo pomočnik uporabil MCP strežnik namesto ugibanja.

Vsi trije se sklicujejo samo na javne MCP in REST URL-je. Ne vsebujejo API ključa — uporabniki dodajo svojega iz nadzorne plošče API ključev.

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 ovojnica živi v public-wrappers/mcp/. Je tanek httpx proxy — brez lokalnih podatkov — zato zasebni prehod ostaja vir resnice.

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"
      }
    }
  }
}

Objavljamo strojno berljiv zemljevid mesta na /llms.txt in bogatejši indeks na /llms-full.txt, da se lahko AI pomočniki sami vključijo. Blok Ask-an-AI na domači strani preda svež klepet ChatGPT, Claude, Gemini, Grok ali Perplexity, opremljen s promptom NACEBridge, ki pomočniku pove, naj uporabi MCP strežnik namesto ugibanja.

• 401 — manjkajoč ali neveljaven X-API-Key
• 402 — kvota stopnje izčrpana, potrebna je nadgradnja
• 422 — vhod ni prestal validacije Zod; odgovor vsebuje podrobnosti polj
• 429 — dosežena omejitev zahtevkov, upoštevajte Retry-After
• 5xx — incident; ponovni poskusi so varni (vse operacije so samo za branje)

Metapodatki NACE Rev 2.1 © Evropska unija, ponovno uporabljeni po politiki ponovne uporabe Komisije. Metapodatki nacionalnih podrazredov © ustrezni nacionalni statistični inštituti (INE, INSEE, DESTATIS, CBS, …). Preslikave NACEBridge, normalizirano shemo in ovojnice distribuira TΣKSOMΛ Holding, Lda., zgradil TΣKSOMΛ Technologies in poganja TΣKSOMΛ | MΛRKET INTΣLLIGENCE.