NACEBridge API & MCP

NACEBridge mapuje EU NACE Rev 2.1 až na pětimístné národní podtřídy používané 27 státy EU, Spojeným královstvím a Švýcarskem (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). Všechny čtyři webové nástroje jsou dostupné také programově:

• search — globální a místní vyhledávání podle klíčového slova
• decode — rozbalení národního kódu do celé hierarchie EU
• cousins — přeshraniční ekvivalentní podtřídy
• grid — vícezemská kontingenční tabulka pro divizi NACE

Každý požadavek na /api/v1/* nese hlavičku X-API-Key. Přihlaste se a generujte klíče ve svém panelu API klíčů. Klíče jsou v úložišti hashované — plaintext nikdy neukládáme.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

Endpoint MCP používá stejnou hlavičku, stejné limity podle tarifu a stejný protokol požadavků jako REST brána — liší se pouze URL (/mcp místo /api/v1/…) a obálka JSON-RPC. Anonymní webový provoz je pro UI nástroje povolen, ale jemně omezen počítadlem zásahů podle IP (viz Limity požadavků).

Špičky nad limit okna vracejí HTTP 429 s hlavičkou Retry-After.

Pět zdrojů pod https://nacebridge.dev/api/v1/*. Každý endpoint přijímá GET s query parametry nebo POST s JSON tělem. Odpovědi mají tvar { ok, tier, data } a obsahují hlavičky 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žívá specifikaci transportu MCP Streamable HTTP . Nasměrujte libovolného MCP klienta na:

https://nacebridge.dev/mcp

Odesílejte POST JSON-RPC 2.0 s oběma typy 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): přidejte jako vlastní Connector se stejnou URL — nástroje search a fetch jsou dostupné pro Deep Research.

Cursor: přidejte stejnou URL do ~/.cursor/mcp.json.

Hotové instrukce, které vašeho AI asistenta naučí, kdy a jak volat NACEBridge. Stáhněte je, nainstalujte do zvoleného asistenta a při příštím vložení kódu NACE / CAE / NAF / WZ / SBI asistent použije MCP server místo hádání.

Všechny tři odkazují pouze na veřejné URL MCP a REST. Neobsahují žádný API klíč — uživatelé použijí vlastní z panelu API klíčů.

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 žije v public-wrappers/mcp/. Je to tenký httpx proxy — bez lokálních dat — takže soukromá brána zůstává zdrojem 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 strojově čitelnou mapu webu na /llms.txt a bohatší index na /llms-full.txt, aby se AI asistenti mohli sami zorientovat. Blok Ask-an-AI na domovské stránce předá nový chat do ChatGPT, Claude, Gemini, Grok nebo Perplexity s promptem NACEBridge, který asistentovi říká, aby použil MCP server místo hádání.

• 401 — chybějící nebo neplatný X-API-Key
• 402 — vyčerpaná kvóta tarifu, je vyžadován upgrade
• 422 — vstup neprošel validací Zod; odpověď obsahuje detaily polí
• 429 — dosažen limit požadavků, respektujte Retry-After
• 5xx — incident; opakování je bezpečné (všechny operace jsou pouze pro čtení)

Metadata NACE Rev 2.1 © Evropská unie, znovu použitá podle politiky opětovného použití Komise. Metadata národních podtříd © příslušné národní statistické úřady (INE, INSEE, DESTATIS, CBS, …). Mapování NACEBridge, normalizované schéma a wrappery distribuuje TΣKSOMΛ Holding, Lda., postaveno od TΣKSOMΛ Technologies a poháněno od TΣKSOMΛ | MΛRKET INTΣLLIGENCE.