NACEBridge API & MCP

NACEBridge kartē EU NACE Rev 2.1 līdz pieczīmju nacionālajām apakšklasēm, ko izmanto 27 ES valstis, Apvienotā Karaliste un Šveice (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). Visi četri tīmekļa rīki ir pieejami arī programmiski:

• search — globāla + vietēja atslēgvārdu meklēšana
• decode — izvērst nacionālo kodu pilnā ES hierarhijā
• cousins — pārrobežu ekvivalentās apakšklases
• grid — vairāku valstu pivot NACE nodaļai

Katrs pieprasījums uz /api/v1/* satur X-API-Key galveni. Pierakstieties un ģenerējiet atslēgas savā API atslēgu paneli. Atslēgas glabāšanā tiek hashētas — mēs nekad neglabājam atklāto tekstu.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

MCP galapunkts izmanto tieši to pašu galveni, tos pašus līmeņu pieprasījumu limitus un to pašu pieprasījumu žurnālu kā REST vārteja — atšķiras tikai URL (/mcp nevis /api/v1/…) un JSON-RPC aploksne. Anonīma tīmekļa plūsma UI rīkiem ir atļauta, bet maigi ierobežota ar IP trāpījumu skaitītāju (skat. Pieprasījumu limiti).

Pārsniegumi virs loga limita atgriež HTTP 429 ar Retry-After.

Pieci resursi zem https://nacebridge.dev/api/v1/*. Katrs galapunkts pieņem GET ar query parametriem vai POST ar JSON ķermeni. Atbildes ir { ok, tier, data } ar pievienotām X-RateLimit-* galvenēm.

# 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 izmanto MCP Streamable HTTP transport specifikāciju. Norādiet jebkuru MCP klientu uz:

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 ar abiem satura tipiem Accept galvenē:

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): pievienojiet kā pielāgotu Connector ar to pašu URL — search un fetch rīki ir pieejami Deep Research.

Cursor: pievienojiet to pašu URL ~/.cursor/mcp.json.

Gatavas instrukcijas, kas māca jūsu MI asistentam, kad un kā izsaukt NACEBridge. Lejupielādējiet, instalējiet izvēlētajā asistentā, un nākamreiz, kad lietotājs ielīmēs NACE / CAE / NAF / WZ / SBI kodu, asistents izmantos MCP serveri, nevis minēs.

Visi trīs atsaucas tikai uz publiskajiem MCP un REST URL. Tie nesatur API atslēgu — lietotāji ievada savu no API atslēgu paneļa.

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 atrodas public-wrappers/mcp/. Tas ir plāns httpx proxy — bez lokāliem datiem — tāpēc privātā vārteja paliek patiesības avots.

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

Mēs publicējam mašīnlasāmu vietnes karti /llms.txt un bagātāku indeksu /llms-full.txt, lai MI asistenti varētu paši iepazīties. Sākumlapas Ask-an-AI bloks nodod jaunu čatu ChatGPT, Claude, Gemini, Grok vai Perplexity ar NACEBridge promptu, kas liek asistentam izmantot MCP serveri, nevis minēt.

• 401 — trūkst vai nederīgs X-API-Key
• 402 — līmeņa kvota izsmelta, nepieciešams jauninājums
• 422 — ievade neizturēja Zod validāciju; atbildē ir lauku detaļas
• 429 — sasniegts pieprasījumu limits, ievērojiet Retry-After
• 5xx — incidents; atkārtojumi ir droši (visas operācijas ir tikai lasīšanai)

NACE Rev 2.1 metadati © Eiropas Savienība, atkārtoti izmantoti saskaņā ar Komisijas atkārtotas izmantošanas politiku. Nacionālo apakšklasu metadati © attiecīgie nacionālie statistikas institūti (INE, INSEE, DESTATIS, CBS, …). NACEBridge kartējumus, normalizēto shēmu un wrapperus izplata TΣKSOMΛ Holding, Lda., veidojis TΣKSOMΛ Technologies un darbina TΣKSOMΛ | MΛRKET INTΣLLIGENCE.