NACEBridge API & MCP

NACEBridge mapuje EU NACE Rev 2.1 až na päťmiestne národné podtriedy používané 27 krajinami EÚ, Spojeným kráľovstvom a Švajčiarskom (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). Všetky štyri webové nástroje sú dostupné aj programovo:

• search — globálne a miestne vyhľadávanie podľa kľúčového slova
• decode — rozbaľte národný kód do celej hierarchie EÚ
• cousins — cezhraničné ekvivalentné podtriedy
• grid — pivot pre viac krajín pre divíziu NACE

Každá požiadavka na /api/v1/* nesie hlavičku X-API-Key. Prihláste sa a generujte kľúče vo svojom panel API kľúčov. Kľúče sú pri uložení hashované — plaintext nikdy neukladáme.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

Endpoint MCP používa presne tú istú hlavičku, rovnaké limity podľa úrovne a rovnaký denník požiadaviek ako REST brána — jediný rozdiel je URL (/mcp namiesto /api/v1/…) a obálka JSON-RPC. Anonymná webová prevádzka je pre UI nástroje povolená, ale jemne obmedzená počítadlom zásahov podľa IP (pozri Limity požiadaviek).

Špičky nad limit okna vracajú HTTP 429 s Retry-After.

Päť zdrojov pod https://nacebridge.dev/api/v1/*. Každý endpoint prijíma GET s query parametrami alebo POST s JSON telom. Odpovede sú { ok, tier, data } s pripojenými hlavičkami 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 používa špecifikáciu MCP Streamable HTTP transport . Nasmerujte ľubovoľného MCP klienta na:

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 s oboma typmi obsahu 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): pridajte ako vlastný Connector s rovnakou URL — nástroje search a fetch sú dostupné pre Deep Research.

Cursor: pridajte tú istú URL do ~/.cursor/mcp.json.

Hotové inštrukcie, ktoré naučia vášho AI asistenta, kedy a ako volať NACEBridge. Stiahnite, nainštalujte do zvoleného asistenta a keď používateľ nabudúce vloží kód NACE / CAE / NAF / WZ / SBI, asistent použije MCP server namiesto hádania.

Všetky tri odkazujú iba na verejné MCP a REST URL. Neobsahujú žiadny API kľúč — používatelia dodajú svoj vlastný z panela API kľúčov.

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 wrapper sa nachádza v public-wrappers/mcp/. Je to tenký httpx proxy — nulové lokálne dáta — takže súkromná brána zostáva zdrojom pravdy.

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

Publikujeme strojovo čitateľnú mapu webu na /llms.txt a bohatší index na /llms-full.txt, aby sa AI asistenti vedeli sami zorientovať. Blok Ask-an-AI na domovskej stránke odovzdá nový chat do ChatGPT, Claude, Gemini, Grok alebo Perplexity s promptom NACEBridge, ktorý asistentovi povie, aby použil MCP server namiesto hádania.

• 401 — chýbajúci alebo neplatný X-API-Key
• 402 — kvóta úrovne vyčerpaná, vyžaduje sa upgrade
• 422 — vstup neprešiel validáciou Zod; odpoveď obsahuje detaily polí
• 429 — dosiahnutý limit požiadaviek, rešpektujte Retry-After
• 5xx — incident; opakovania sú bezpečné (všetky operácie sú iba na čítanie)

Metadáta NACE Rev 2.1 © Európska únia, opätovne použité podľa politiky opätovného použitia Komisie. Metadáta národných podtried © príslušné národné štatistické inštitúty (INE, INSEE, DESTATIS, CBS, …). Mapovania NACEBridge, normalizovanú schému a wrappery distribuuje TΣKSOMΛ Holding, Lda., postavené TΣKSOMΛ Technologies a poháňané TΣKSOMΛ | MΛRKET INTΣLLIGENCE.