NACEBridge API & MCP

NACEBridge jimmappja EU NACE Rev 2.1 sal-issotto-klassijiet nazzjonali ta’ ħames ċifri użati minn 27 nazzjon tal-UE, ir-Renju Unit u l-Iżvizzera (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). L-erba’ għodod tal-web kollha huma disponibbli wkoll b’mod programmatiku:

• search — tfittxija bil-kliem ewlieni globali + lokali
• decode — espandi kodiċi nazzjonali fil-ġerarkija sħiħa tiegħu tal-UE
• cousins — issotto-klassijiet ekwivalenti transkonfinali
• grid — pivot għal diversi pajjiżi għal diviżjoni NACE

Kull talba lejn /api/v1/* iġġorr header X-API-Key. Idħol u ġġenera ċwievet fil- pannell taċ-ċwievet API. Iċ-ċwievet jinħażnu hashed — qatt ma naħżnu plaintext.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

L-endpoint MCP juża l-istess header eżatt, l-istess limiti skont il-livell u l-istess log tat-talbiet bħall-gateway REST — l-unika differenza hija l-URL (/mcp minflok /api/v1/…) u l-envelope JSON-RPC. Traffiku web anonimu huwa permess għall-għodod UI iżda limitat b’mod artab b’counter ta’ hits għal kull IP (ara Limiti ta’ talbiet).

Żidiet ’il fuq mil-limitu tat-tieqa jirritornaw HTTP 429 b’Retry-After.

Ħames riżorsi taħt https://nacebridge.dev/api/v1/*. Kull endpoint jaċċetta GET b’parametri query jew POST b’JSON body. It-tweġibiet huma { ok, tier, data } b’headers X-RateLimit-* mehmuża.

# 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 juża l- MCP Streamable HTTP transport spec. Ipponta kwalunkwe klijent MCP lejn:

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 biż-żewġ tipi ta’ kontenut f’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): żid bħala Connector personalizzat bl-istess URL — l-għodod search u fetch huma esposti għal Deep Research.

Cursor: żid l-istess URL ma’ ~/.cursor/mcp.json.

Istruzzjonijiet lesti li jgħallmu lill-assistent AI tiegħek meta u kif isejjaħ lil NACEBridge. Niżżel, installa fl-assistent tal-għażla tiegħek, u d-darba li jmiss li l-utent idaħħal kodiċi NACE / CAE / NAF / WZ / SBI, l-assistent juża s-server MCP minflok ma jaqta’.

It-tlieta jirreferu biss għall-URLs pubbliċi MCP u REST. Ma fihomx ċavetta API — l-utenti jipprovdu tagħhom mill-pannell taċ-ċwievet 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"] });

Il-wrapper open-source jinsab f’public-wrappers/mcp/. Huwa proxy httpx irqiq — ebda data lokali — għalhekk il-gateway privat jibqa’ s-sors tal-verità.

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

Nippubblikaw mappa tas-sit li tinqara mill-magni f’/llms.txt u indiċi aktar rikk f’/llms-full.txt sabiex assistenti AI jistgħu jidħlu waħedhom. Il-blokk Ask-an-AI fuq il-homepage jgħaddi chat ġdid lil ChatGPT, Claude, Gemini, Grok jew Perplexity, b’prompt NACEBridge li jgħid lill-assistent juża s-server MCP minflok jaqta’.

• 401 — X-API-Key nieqes jew invalidu
• 402 — kwota tal-livell eżawrita, upgrade meħtieġ
• 422 — l-input falla l-validazzjoni Zod; it-tweġiba ġġorr dettalji tal-fields
• 429 — intlaħaq il-limitu tar-rata, irrispetta Retry-After
• 5xx — inċident; retries huma siguri (l-operazzjonijiet kollha huma read-only)

Metadata NACE Rev 2.1 © Unjoni Ewropea, użati mill-ġdid taħt il-politika ta’ użu mill-ġdid tal-Kummissjoni. Metadata tas-sotto-klassijiet nazzjonali © l-istituti nazzjonali tal-istatistika rispettivi (INE, INSEE, DESTATIS, CBS, …). Il-mappings NACEBridge, l-iskema normalizzata u l-wrappers jitqassmu minn TΣKSOMΛ Holding, Lda., mibni minn TΣKSOMΛ Technologies u mħaddem minn TΣKSOMΛ | MΛRKET INTΣLLIGENCE.