NACEBridge API & MCP

Léarscáilíonn NACEBridge EU NACE Rev 2.1 síos go dtí na fo-aicmí náisiúnta cúig dhigit a úsáideann 27 náisiún AE, an Ríocht Aontaithe agus an Eilvéis (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). Tá na ceithre uirlis ghréasáin ar fáil go cláir freisin:

• search — cuardach eochairfhocail domhanda + áitiúil
• decode — leathnaigh cód náisiúnta ina ordlathas AE iomlán
• cousins — fo-aicmí coibhéiseacha trasteorann
• grid — pivot iltíre do rannán NACE

Iompraíonn gach iarratas chuig /api/v1/* ceanntásc X-API-Key. Sínigh isteach agus giniúint eochracha i do phainéal eochracha API. Déantar na heochracha a hasháil agus iad stóráilte — ní stórálaimid an gnáth-théacs riamh.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

Úsáideann críochphointe MCP an ceanntásc céanna, na teorainneacha ráta céanna de réir sraithe agus an loga iarratais céanna leis an ngeata REST — is iad an URL (/mcp in ionad /api/v1/…) agus an clúdach JSON-RPC an t-aon difríocht. Ceadaítear trácht gréasáin gan ainm do na huirlisí UI, ach tá sé srianta go bog le cuntar stailceanna de réir IP (féach Teorainneacha ráta).

Filleann pléascthaí os cionn theorainn na fuinneoige HTTP 429 le Retry-After.

Cúig acmhainn faoi https://nacebridge.dev/api/v1/*. Glacann gach críochphointe GET le paraiméadair query nó POST le corp JSON. Is iad na freagraí { ok, tier, data } agus ceanntásca X-RateLimit-* ceangailte leo.

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

Labhraíonn NACEBridge an iompair MCP Streamable HTTP sonraíocht. Treoraigh aon chliant MCP chuig:

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 leis an dá chineál ábhair in 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): cuir leis mar Connector saincheaptha leis an URL céanna — tá uirlisí search agus fetch ar fáil do Deep Research.

Cursor: cuir an URL céanna le ~/.cursor/mcp.json.

Treoracha réamhdhéanta a mhúineann do chúntóir AI cathain agus conas NACEBridge a ghlaoch. Íoslódáil, suiteáil sa chúntóir is rogha leat, agus an chéad uair eile a ghreamaíonn an t-úsáideoir cód NACE / CAE / NAF / WZ / SBI, úsáidfidh an cúntóir an freastalaí MCP in ionad buille faoi thuairim.

Tagraíonn na trí cinn do URLanna poiblí MCP agus REST amháin. Níl aon eochair API iontu — soláthraíonn úsáideoirí a gceann féin ó phainéal eochracha 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"] });

Tá an wrapper open-source i public-wrappers/mcp/. Is proxy tanaí httpx é — gan aon sonraí áitiúla — mar sin fanann an geata príobháideach mar fhoinse na fírinne.

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

Foilsímid léarscáil láithreáin inléite ag meaisín ag /llms.txt agus innéacs níos saibhre ag /llms-full.txt ionas gur féidir le cúntóirí AI iad féin a thabhairt isteach. Tugann bloc Ask-an-AI ar an leathanach baile comhrá úr do ChatGPT, Claude, Gemini, Grok nó Perplexity, síolaithe le prompt NACEBridge a deir leis an gcúntóir an freastalaí MCP a úsáid seachas buille faoi thuairim.

• 401 — X-API-Key ar iarraidh nó neamhbhailí
• 402 — cuóta sraithe ídithe, uasghrádú riachtanach
• 422 — theip ar an ionchur bailíochtú Zod; tá sonraí réimsí sa fhreagra
• 429 — baineadh teorainn ráta amach, cloígh le Retry-After
• 5xx — teagmhas; tá retries sábháilte (tá gach oibríocht read-only)

Meiteashonraí NACE Rev 2.1 © An tAontas Eorpach, athúsáidte faoi pholasaí athúsáide an Choimisiúin. Meiteashonraí fo-aicmí náisiúnta © na hinstitiúidí staidrimh náisiúnta faoi seach (INE, INSEE, DESTATIS, CBS, …). Déanann TΣKSOMΛ Holding, Lda., tógtha ag TΣKSOMΛ Technologies agus cumhachtaithe ag TΣKSOMΛ | MΛRKET INTΣLLIGENCE.