NACEBridge API & MCP

NACEBridge mapira EU NACE Rev 2.1 do peteroznamenkastih nacionalnih podrazreda koje koristi 27 država EU-a, Ujedinjeno Kraljevstvo i Švicarska (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). Sva četiri web alata dostupna su i programski:

• search — globalna i lokalna pretraga po ključnoj riječi
• decode — proširi nacionalnu šifru u cijelu EU hijerarhiju
• cousins — prekogranični ekvivalentni podrazredi
• grid — višedržavni pivot za NACE odjeljak

Svaki zahtjev prema /api/v1/* nosi zaglavlje X-API-Key. Prijavite se i generirajte ključeve u svojoj nadzornu ploču API ključeva. Ključevi se pohranjuju hashirani — nikada ne spremamo otvoreni tekst.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

MCP endpoint koristi isto zaglavlje, ista ograničenja po razini i isti dnevnik zahtjeva kao REST gateway — jedina razlika su URL (/mcp umjesto /api/v1/…) i JSON-RPC omotnica. Anonimni web promet dopušten je za UI alate, ali je blago ograničen IP brojačem pogodaka (vidi Ograničenja zahtjeva).

Pikovi iznad ograničenja prozora vraćaju HTTP 429 s Retry-After.

Pet resursa pod https://nacebridge.dev/api/v1/*. Svaki endpoint prihvaća GET s query parametrima ili POST s JSON tijelom. Odgovori su { ok, tier, data } s priloženim X-RateLimit-* zaglavljima.

# 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 govori MCP Streamable HTTP transport specifikaciju. Usmjerite bilo koji MCP klijent na:

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 s obje vrste sadržaja u 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): dodajte kao prilagođeni Connector s istim URL-om — alati search i fetch izloženi su za Deep Research.

Cursor: dodajte isti URL u ~/.cursor/mcp.json.

Gotove upute koje uče vašeg AI asistenta kada i kako pozvati NACEBridge. Preuzmite ih, instalirajte u odabranog asistenta i sljedeći put kad korisnik zalijepi NACE / CAE / NAF / WZ / SBI šifru, asistent će posegnuti za MCP poslužiteljem umjesto nagađanja.

Sva tri upućuju samo na javne MCP i REST URL-ove. Ne sadrže API ključ — korisnici unose vlastiti iz nadzorne ploče API ključeva.

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 nalazi se u public-wrappers/mcp/. To je tanki httpx proxy — bez lokalnih podataka — pa privatni gateway ostaje izvor istine.

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

Objavljujemo strojno čitljivu mapu weba na /llms.txt i bogatiji indeks na /llms-full.txt kako bi se AI asistenti mogli sami uključiti. Blok Ask-an-AI na početnoj stranici predaje svježi razgovor ChatGPT-u, Claudeu, Geminiju, Groku ili Perplexityju, s NACEBridge promptom koji asistentu kaže da koristi MCP poslužitelj umjesto nagađanja.

• 401 — nedostaje ili je nevažeći X-API-Key
• 402 — kvota razine je iscrpljena, potrebna je nadogradnja
• 422 — ulaz nije prošao Zod validaciju; odgovor sadrži detalje polja
• 429 — dosegnuto ograničenje zahtjeva, poštujte Retry-After
• 5xx — incident; ponovni pokušaji su sigurni (sve operacije su samo za čitanje)

Metapodaci NACE Rev 2.1 © Europska unija, ponovno upotrijebljeni prema politici ponovne uporabe Komisije. Metapodaci nacionalnih podrazreda © odgovarajući nacionalni statistički instituti (INE, INSEE, DESTATIS, CBS, …). Mapiranja NACEBridge, normaliziranu shemu i wrappere distribuira TΣKSOMΛ Holding, Lda., izgradio TΣKSOMΛ Technologies i pokreće TΣKSOMΛ | MΛRKET INTΣLLIGENCE.