NACEBridge API & MCP

NACEBridge mapuje EU NACE Rev 2.1 aż do 5-cyfrowych narodowych podklas używanych przez 27 państw UE, Wielką Brytanię i Szwajcarię (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). Wszystkie cztery narzędzia webowe są dostępne także programatycznie:

• search — globalne i lokalne wyszukiwanie słów kluczowych
• decode — rozwinięcie kodu krajowego do pełnej hierarchii UE
• cousins — transgraniczne podklasy ekwiwalentne
• grid — pivot wielokrajowy dla wybranego działu NACE

Każde żądanie do /api/v1/* niesie nagłówek X-API-Key. Zaloguj się i generuj klucze w swoim panelu kluczy API. Klucze są hashowane w spoczynku — nigdy nie przechowujemy tekstu jawnego.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

Endpoint MCP używa dokładnie tego samego nagłówka, dokładnie tych samych limitów per tier i dokładnie tego samego logu żądań co brama REST — jedyną różnicą jest URL (/mcp zamiast /api/v1/…) oraz koperta JSON-RPC. Anonimowy ruch webowy jest dozwolony dla narzędzi UI, ale jest miękko ograniczony licznikiem strike'ów per IP (zobacz Limity zapytań).

Skoki powyżej limitu okna zwracają HTTP 429 z Retry-After.

Pięć zasobów pod https://nacebridge.dev/api/v1/*. Każdy endpoint przyjmuje GET z parametrami query lub POST z ciałem JSON. Odpowiedzi mają postać { ok, tier, data } z dołączonymi nagłówkami 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 mówi specyfikacją MCP Streamable HTTP transport . Skieruj dowolnego klienta MCP na:

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 z oboma content-type w 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): dodać jako własny Connector z tą samą URL — narzędzia search i fetch są wystawione dla Deep Research.

Cursor: dodać do ~/.cursor/mcp.json z tą samą URL.

Gotowe instrukcje uczące asystenta AI, kiedy i jak wywołać NACEBridge. Pobierz, zainstaluj w wybranym asystencie — przy następnym wklejeniu kodu NACE / CAE / NAF / WZ / SBI asystent sięgnie do serwera MCP zamiast zgadywać.

Wszystkie trzy odwołują się tylko do publicznych URL MCP i REST. Nie zawierają klucza API — użytkownicy dostarczają własny z panelu kluczy 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"] });

Open source'owy wrapper żyje w public-wrappers/mcp/. To cienki proxy httpx — zero danych lokalnych — by prywatna brama pozostała jedynym źródłem prawdy.

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

Publikujemy mapę witryny czytelną maszynowo pod /llms.txt i bogatszy indeks pod /llms-full.txt, aby asystenci AI mogli wdrażać się sami. Blok Ask-an-AI na stronie głównej otwiera świeży czat w ChatGPT, Claude, Gemini, Grok lub Perplexity — przygotowany promptem NACEBridge, który mówi asystentowi, by używał serwera MCP zamiast zgadywać.

• 401 — brakujący lub nieprawidłowy X-API-Key
• 402 — wyczerpana kwota tieru, wymagany upgrade
• 422 — wejście nie przeszło walidacji Zod; odpowiedź niesie szczegóły pól
• 429 — osiągnięty limit zapytań, uszanuj Retry-After
• 5xx — incydent; ponowienia są bezpieczne (wszystkie operacje są tylko do odczytu)

Metadane NACE Rev 2.1 © Unia Europejska, ponownie wykorzystane na warunkach polityki ponownego użycia Komisji. Metadane krajowych podklas © odpowiednie krajowe instytuty statystyczne (INE, INSEE, DESTATIS, CBS, …). Mapowania NACEBridge, znormalizowany schemat i wrappery są dystrybuowane przez TΣKSOMΛ Holding, Lda., zbudowane przez TΣKSOMΛ Technologies i wspierane przez TΣKSOMΛ | MΛRKET INTΣLLIGENCE.