NACEBridge API & MCP

NACEBridge mapittaa EU NACE Rev 2.1:n viisinumeroisiin kansallisiin alaluokkiin, joita käytetään 27 EU-maassa, Yhdistyneessä kuningaskunnassa ja Sveitsissä (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). Kaikki neljä verkkotyökalua ovat saatavilla myös ohjelmallisesti:

• search — globaali + paikallinen avainsanahaku
• decode — laajenna kansallinen koodi koko EU-hierarkiaan
• cousins — rajat ylittävät vastaavat alaluokat
• grid — monimaan pivot NACE-divisioonaa varten

Jokaisessa /api/v1/*-pyynnössä on X-API-Key-otsake. Kirjaudu sisään ja luo avaimia API-avainten hallintapaneeli. Avaimet hashataan tallennuksessa — emme koskaan tallenna selkokielistä arvoa.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

MCP-päätepiste käyttää täsmälleen samaa otsaketta, samoja tasokohtaisia pyyntörajoja ja samaa pyyntölokia kuin REST-yhdyskäytävä — erona ovat vain URL (/mcp eikä /api/v1/…) ja JSON-RPC-kuori. Anonyymi verkkoliikenne on sallittu UI-työkaluille, mutta sitä pehmeästi rajoitetaan IP-kohtaisella laskurilla (katso Pyyntörajat).

Ikkunakohtaisen rajan ylittävät purskeet palauttavat HTTP 429:n ja Retry-After-otsakkeen.

Viisi resurssia osoitteessa https://nacebridge.dev/api/v1/*. Jokainen päätepiste hyväksyy GETin query-parametreilla tai POSTin JSON-rungolla. Vastaukset ovat muotoa { ok, tier, data } ja sisältävät X-RateLimit-*-otsakkeet.

# 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 käyttää MCP Streamable HTTP -kuljetuksen spesifikaatiota. Osoita mikä tahansa MCP-asiakas tähän:

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 molemmilla sisältötyypeillä Accept-otsakkeessa:

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): lisää mukautettuna Connectorina samalla URL:lla — search- ja fetch-työkalut ovat käytössä Deep Researchia varten.

Cursor: lisää sama URL tiedostoon ~/.cursor/mcp.json.

Valmiit ohjeet, jotka opettavat AI-avustajallesi, milloin ja miten kutsua NACEBridgeä. Lataa, asenna valitsemaasi avustajaan, ja kun käyttäjä seuraavan kerran liittää NACE / CAE / NAF / WZ / SBI -koodin, avustaja käyttää MCP-palvelinta arvaamisen sijaan.

Kaikki kolme viittaavat vain julkisiin MCP- ja REST-URL-osoitteisiin. Ne eivät sisällä API-avainta — käyttäjät lisäävät omansa API-avainten hallintapaneelista.

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-kääre sijaitsee public-wrappers/mcp/-hakemistossa. Se on ohut httpx-proxy — ei paikallista dataa — joten yksityinen yhdyskäytävä pysyy totuuden lähteenä.

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

Julkaisemme koneellisesti luettavan sivukartan osoitteessa /llms.txt ja rikkaamman indeksin osoitteessa /llms-full.txt, jotta AI-avustajat voivat perehtyä itse. Etusivun Ask-an-AI-lohko siirtää uuden chatin ChatGPT:lle, Claudelle, Geminille, Grokille tai Perplexitylle NACEBridge-promptilla, joka ohjaa avustajaa käyttämään MCP-palvelinta arvaamisen sijaan.

• 401 — puuttuva tai virheellinen X-API-Key
• 402 — tason kiintiö käytetty, päivitys vaaditaan
• 422 — syöte ei läpäissyt Zod-validointia; vastaus sisältää kenttätiedot
• 429 — pyyntöraja saavutettu, noudata Retry-After-otsaketta
• 5xx — häiriö; uudelleenyritykset ovat turvallisia (kaikki toiminnot ovat vain luku -toimintoja)

NACE Rev 2.1 -metatiedot © Euroopan unioni, uudelleenkäytetty komission uudelleenkäyttöpolitiikan mukaisesti. Kansallisten alaluokkien metatiedot © asianomaiset kansalliset tilastolaitokset (INE, INSEE, DESTATIS, CBS, …). NACEBridge-kartoitukset, normalisoitu skeema ja kääreet jakaa TΣKSOMΛ Holding, Lda., rakentanut TΣKSOMΛ Technologies ja voimanlähteenä TΣKSOMΛ | MΛRKET INTΣLLIGENCE.