NACEBridge API & MCP

NACEBridge susieja EU NACE Rev 2.1 su penkiaženkliais nacionaliniais poklasiais, naudojamais 27 ES šalyse, Jungtinėje Karalystėje ir Šveicarijoje (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). Visi keturi žiniatinklio įrankiai taip pat pasiekiami programiškai:

• search — globali + vietinė raktinių žodžių paieška
• decode — išskleisti nacionalinį kodą į visą ES hierarchiją
• cousins — tarpvalstybiniai ekvivalentūs poklasiai
• grid — kelių šalių pivot NACE skyriui

Kiekviena užklausa į /api/v1/* turi X-API-Key antraštę. Prisijunkite ir generuokite raktus savo API raktų skydelį. Raktai saugomi maišos pavidalu — niekada nesaugome atviro teksto.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

MCP galinis taškas naudoja tą pačią antraštę, tas pačias lygio užklausų ribas ir tą patį užklausų žurnalą kaip REST vartai — skiriasi tik URL (/mcp vietoj /api/v1/…) ir JSON-RPC apvalkalas. Anoniminis žiniatinklio srautas leidžiamas UI įrankiams, bet švelniai ribojamas IP smūgių skaitikliu (žr. Užklausų ribos).

Virš lango ribos esantys pikai grąžina HTTP 429 su Retry-After.

Penki ištekliai po https://nacebridge.dev/api/v1/*. Kiekvienas galinis taškas priima GET su query parametrais arba POST su JSON kūnu. Atsakymai yra { ok, tier, data } su X-RateLimit-* antraštėmis.

# 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 naudoja MCP Streamable HTTP transport specifikaciją. Nukreipkite bet kurį MCP klientą į:

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 su abiem turinio tipais Accept antraštėje:

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): pridėkite kaip pasirinktinį Connector su tuo pačiu URL — search ir fetch įrankiai pasiekiami Deep Research.

Cursor: pridėkite tą patį URL į ~/.cursor/mcp.json.

Paruoštos instrukcijos, mokančios jūsų DI asistentą, kada ir kaip kviesti NACEBridge. Atsisiųskite, įdiekite pasirinktame asistente, ir kitą kartą naudotojui įklijavus NACE / CAE / NAF / WZ / SBI kodą asistentas naudos MCP serverį, o ne spėlios.

Visi trys nurodo tik viešuosius MCP ir REST URL. Juose nėra API rakto — naudotojai pateikia savąjį iš API raktų skydelio.

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 yra public-wrappers/mcp/. Tai plonas httpx proxy — be vietinių duomenų — todėl privatus vartai lieka tiesos šaltiniu.

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

Skelbiame mašinai skaitomą svetainės žemėlapį /llms.txt ir turtingesnį indeksą /llms-full.txt, kad DI asistentai galėtų patys įsijungti. Pradžios puslapio Ask-an-AI blokas perduoda naują pokalbį ChatGPT, Claude, Gemini, Grok arba Perplexity su NACEBridge promptu, kuris nurodo asistentui naudoti MCP serverį, o ne spėlioti.

• 401 — trūksta arba negalioja X-API-Key
• 402 — lygio kvota išnaudota, reikia atnaujinti
• 422 — įvestis nepraėjo Zod validavimo; atsakyme yra laukų detalės
• 429 — pasiekta užklausų riba, laikykitės Retry-After
• 5xx — incidentas; pakartojimai saugūs (visos operacijos tik skaitymui)

NACE Rev 2.1 metaduomenys © Europos Sąjunga, pakartotinai naudojami pagal Komisijos pakartotinio naudojimo politiką. Nacionalinių poklasių metaduomenys © atitinkami nacionaliniai statistikos institutai (INE, INSEE, DESTATIS, CBS, …). NACEBridge susiejimus, normalizuotą schemą ir wrapperius platina TΣKSOMΛ Holding, Lda., sukurta TΣKSOMΛ Technologies ir maitinama TΣKSOMΛ | MΛRKET INTΣLLIGENCE.