NACEBridge API & MCP

NACEBridge mapează EU NACE Rev 2.1 până la subclasele naționale cu a cincea cifră folosite de 27 de țări UE, Regatul Unit și Elveția (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). Toate cele patru utilitare web sunt disponibile și programatic:

• search — căutare globală + locală după cuvânt-cheie
• decode — extinde un cod național în întreaga sa ierarhie UE
• cousins — subclase echivalente transfrontaliere
• grid — pivot multinațional pentru o divizie NACE

Fiecare cerere către /api/v1/* poartă un header X-API-Key. Autentificați-vă și generați chei în tabloul de bord al cheilor API. Cheile sunt hash-uite în repaus — nu stocăm niciodată plaintext-ul.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

Endpoint-ul MCP folosește exact același header, exact aceleași limite pe nivel și exact același jurnal de cereri ca gateway-ul REST — singura diferență este URL-ul (/mcp în loc de /api/v1/…) și învelișul JSON-RPC. Traficul web anonim este permis pentru utilitarele UI, dar este limitat blând cu un contor pe IP (vezi Limite de cereri).

Vârfurile peste limita ferestrei returnează HTTP 429 cu Retry-After.

Cinci resurse sub https://nacebridge.dev/api/v1/*. Fiecare endpoint acceptă GET cu parametri query sau POST cu corp JSON. Răspunsurile sunt { ok, tier, data } cu headere X-RateLimit-* atașate.

# 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 vorbește specificația MCP Streamable HTTP transport . Direcționați orice client MCP către:

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 cu ambele tipuri de conținut în 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): adăugați ca un Connector personalizat cu același URL — uneltele search și fetch sunt expuse pentru Deep Research.

Cursor: adăugați același URL în ~/.cursor/mcp.json.

Instrucțiuni gata de folosit care vă învață asistentul AI când și cum să apeleze NACEBridge. Descărcați, instalați în asistentul ales, iar data viitoare când utilizatorul lipește un cod NACE / CAE / NAF / WZ / SBI, asistentul va folosi serverul MCP în loc să ghicească.

Toate trei indică doar URL-urile publice MCP și REST. Nu conțin nicio cheie API — utilizatorii o furnizează pe a lor din tabloul de bord al cheilor API.

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

Wrapperul open-source se află în public-wrappers/mcp/. Este un proxy httpx subțire — zero date locale — astfel gateway-ul privat rămâne sursa adevărului.

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

Publicăm o hartă de site citibilă de mașini la /llms.txt și un index mai bogat la /llms-full.txt, astfel încât asistenții AI să se poată auto-onboarda. Blocul Ask-an-AI de pe pagina principală predă un chat nou către ChatGPT, Claude, Gemini, Grok sau Perplexity, preîncărcat cu un prompt NACEBridge care îi spune asistentului să folosească serverul MCP în loc să ghicească.

• 401 — X-API-Key lipsă sau invalid
• 402 — cota nivelului epuizată, upgrade necesar
• 422 — inputul a eșuat validarea Zod; răspunsul conține detalii pe câmpuri
• 429 — limită de cereri atinsă, respectați Retry-After
• 5xx — incident; retry-urile sunt sigure (toate operațiunile sunt doar citire)

Metadatele NACE Rev 2.1 © Uniunea Europeană, reutilizate conform politicii de reutilizare a Comisiei. Metadatele subclaselor naționale © institutele naționale de statistică respective (INE, INSEE, DESTATIS, CBS, …). Mapările NACEBridge, schema normalizată și wrapper-ele sunt distribuite de TΣKSOMΛ Holding, Lda., construit de TΣKSOMΛ Technologies și alimentat de TΣKSOMΛ | MΛRKET INTΣLLIGENCE.