NACEBridge API & MCP

A NACEBridge az EU NACE Rev 2.1-et leképezi a 27 EU-tagállam, az Egyesült Királyság és Svájc által használt ötödik számjegyű nemzeti alosztályokra (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). Mind a négy webes segédeszköz programozottan is elérhető:

• search — globális + helyi kulcsszavas keresés
• decode — nemzeti kód kibontása a teljes EU-hierarchiába
• cousins — határokon átnyúló ekvivalens alosztályok
• grid — több országos pivot egy NACE-divízióhoz

Minden /api/v1/* kérés X-API-Key fejlécet hordoz. Jelentkezzen be, és hozzon létre kulcsokat az API-kulcs irányítópult. A kulcsokat tároláskor hasheljük — a nyílt szöveget soha nem tároljuk.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

Az MCP-végpont pontosan ugyanazt a fejlécet, ugyanazokat a szintenkénti kéréskorlátokat és ugyanazt a kérésnaplót használja, mint a REST-átjáró — az egyetlen különbség az URL (/mcp a /api/v1/… helyett) és a JSON-RPC boríték. Az anonim webes forgalom engedélyezett a UI-eszközöknél, de IP-alapú találatszámlálóval finoman korlátozott (lásd Kéréskorlátok).

Az ablakon belüli limit feletti burstök HTTP 429-et adnak vissza Retry-After fejléccel.

Öt erőforrás a https://nacebridge.dev/api/v1/* alatt. Minden végpont elfogad GET-et query paraméterekkel vagy POST-ot JSON törzzsel. A válaszok { ok, tier, data } alakúak, X-RateLimit-* fejlécekkel.

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

A NACEBridge a MCP Streamable HTTP transport specifikációt beszéli. Irányítson bármely MCP-klienst ide:

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 mindkét tartalomtípussal az Accept fejlécben:

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): adja hozzá egyedi Connectorként ugyanazzal az URL-lel — a search és fetch eszközök elérhetők Deep Research számára.

Cursor: adja hozzá ugyanezt az URL-t a ~/.cursor/mcp.json fájlhoz.

Bedobható instrukciók, amelyek megtanítják MI-asszisztensének, mikor és hogyan hívja a NACEBridge-et. Töltse le, telepítse a választott asszisztensbe, és amikor a felhasználó legközelebb NACE / CAE / NAF / WZ / SBI kódot illeszt be, az asszisztens találgatás helyett az MCP-szervert használja.

Mindhárom csak a nyilvános MCP és REST URL-ekre hivatkozik. Nem tartalmaznak API-kulcsot — a felhasználók a sajátjukat az API-kulcs irányítópultból adják meg.

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"] });

Az open-source wrapper a public-wrappers/mcp/ alatt található. Ez egy vékony httpx proxy — nulla helyi adat — így a privát átjáró marad az igazság forrása.

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

Géppel olvasható oldaltérképet publikálunk a /llms.txt címen és gazdagabb indexet a /llms-full.txt címen, hogy az MI-asszisztensek önállóan be tudjanak kapcsolódni. A főoldal Ask-an-AI blokkja friss chatet ad át a ChatGPT, Claude, Gemini, Grok vagy Perplexity számára, NACEBridge prompttal, amely az MCP-szerver használatára utasítja az asszisztenst találgatás helyett.

• 401 — hiányzó vagy érvénytelen X-API-Key
• 402 — a szintkvóta kimerült, frissítés szükséges
• 422 — a bemenet nem ment át a Zod-validáción; a válasz mezőszintű részleteket tartalmaz
• 429 — kéréskorlát elérve, tartsa be a Retry-After értéket
• 5xx — incidens; az újrapróbálkozás biztonságos (minden művelet csak olvasás)

NACE Rev 2.1 metaadatok © Európai Unió, a Bizottság újrafelhasználási politikája szerint újrahasználva. Nemzeti alosztály-metaadatok © az illetékes nemzeti statisztikai intézetek (INE, INSEE, DESTATIS, CBS, …). A NACEBridge leképezéseket, normalizált sémát és wrappereket terjeszti TΣKSOMΛ Holding, Lda., készítette TΣKSOMΛ Technologies és működteti TΣKSOMΛ | MΛRKET INTΣLLIGENCE.