NACEBridge API & MCP

NACEBridge kortlægger EU NACE Rev 2.1 ned til de femcifrede nationale underklasser, der bruges af 27 EU-lande, Storbritannien og Schweiz (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). Alle fire webværktøjer er også tilgængelige programmatisk:

• search — global + lokal søgeordssøgning
• decode — udvid en national kode til hele dens EU-hierarki
• cousins — grænseoverskridende ækvivalente underklasser
• grid — flerlands-pivot for en NACE-division

Hver anmodning til /api/v1/* har en X-API-Key-header. Log ind og generér nøgler i dit API-nøgle-dashboard. Nøgler hashes i lageret — vi gemmer aldrig klartekst.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

MCP-endpointet bruger præcis samme header, samme rate limits pr. niveau og samme anmodningslog som REST-gatewayen — den eneste forskel er URL’en (/mcp i stedet for /api/v1/…) og JSON-RPC-konvolutten. Anonym webtrafik er tilladt for UI-værktøjerne, men blødt begrænset med en IP-baseret tæller (se Rate limits).

Bursts over vinduets grænse returnerer HTTP 429 med Retry-After.

Fem ressourcer under https://nacebridge.dev/api/v1/*. Hvert endpoint accepterer GET med query-parametre eller POST med en JSON-body. Svar er { ok, tier, data } med X-RateLimit-*-headers.

# 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 taler MCP Streamable HTTP-transport specifikationen. Peg enhver MCP-klient på:

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 med begge indholdstyper i 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): tilføj som en brugerdefineret Connector med samme URL — search- og fetch-værktøjer er eksponeret til Deep Research.

Cursor: tilføj samme URL til ~/.cursor/mcp.json.

Klar-til-brug-instruktioner, der lærer din AI-assistent, hvornår og hvordan den skal kalde NACEBridge. Download, installer i den valgte assistent, og næste gang brugeren indsætter en NACE / CAE / NAF / WZ / SBI-kode, bruger assistenten MCP-serveren i stedet for at gætte.

Alle tre refererer kun til de offentlige MCP- og REST-URL’er. De indeholder ingen API-nøgle — brugere angiver deres egen fra API-nøgle-dashboardet.

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-wrapperen ligger i public-wrappers/mcp/. Den er en tynd httpx-proxy — nul lokale data — så den private gateway forbliver sandhedskilden.

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

Vi udgiver et maskinlæsbart sitemap på /llms.txt og et rigere indeks på /llms-full.txt, så AI-assistenter kan onboarde sig selv. Ask-an-AI-blokken på forsiden sender en frisk chat videre til ChatGPT, Claude, Gemini, Grok eller Perplexity med en NACEBridge-prompt, der beder assistenten bruge MCP-serveren i stedet for at gætte.

• 401 — manglende eller ugyldig X-API-Key
• 402 — niveaukvoten er opbrugt, opgradering kræves
• 422 — input bestod ikke Zod-validering; svaret indeholder feltdetaljer
• 429 — rate limit ramt, respekter Retry-After
• 5xx — hændelse; retries er sikre (alle operationer er read-only)

NACE Rev 2.1-metadata © Den Europæiske Union, genbrugt under Kommissionens genbrugspolitik. Nationale underklasse-metadata © respektive nationale statistikmyndigheder (INE, INSEE, DESTATIS, CBS, …). NACEBridge-mappinger, normaliseret skema og wrappers distribueres af TΣKSOMΛ Holding, Lda., bygget af TΣKSOMΛ Technologies og drevet af TΣKSOMΛ | MΛRKET INTΣLLIGENCE.