NACEBridge API & MCP

NACEBridge картографира EU NACE Rev 2.1 до 5-цифрените национални подкласове, използвани от 27 държави в ЕС, Обединеното кралство и Швейцария (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). И четирите уеб инструмента са достъпни и програмно:

• search — глобално + локално търсене по ключова дума
• decode — разгръщане на национален код до пълната EU йерархия
• cousins — трансгранично еквивалентни подкласове
• grid — многонационален pivot за дивизия по NACE

Всяка заявка към /api/v1/* носи хедър X-API-Key. Влезте и генерирайте ключове във вашия панел за API ключове. Ключовете се пазят hashed в покой — никога не съхраняваме открития текст.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

MCP endpoint използва точно същия хедър, точно същите лимити за всеки tier и точно същия лог на заявки като REST gateway — единствената разлика е URL (/mcp вместо /api/v1/…) и JSON-RPC обвивката. Анонимен уеб трафик е разрешен за UI инструментите, но е меко ограничен с брояч на strike-ове по IP (вижте Лимити).

Пикове над лимита на прозореца връщат HTTP 429 с Retry-After.

Пет ресурса под https://nacebridge.dev/api/v1/*. Всеки endpoint приема GET с query параметри или POST с JSON тяло. Отговорите са { ok, tier, data } с прикачени X-RateLimit-* хедъри.

# 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 говори спецификацията MCP Streamable HTTP transport . Насочете всеки MCP клиент към:

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 с двата content-type в 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): добавете като персонализиран Connector със същия URL — инструментите search и fetch са изложени за Deep Research.

Cursor: добавете в ~/.cursor/mcp.json със същия URL.

Готови инструкции, които учат вашия AI асистент кога и как да извика NACEBridge. Свалете, инсталирайте в избрания асистент — при следващото поставяне на код NACE / CAE / NAF / WZ / SBI асистентът ще се обърне към MCP сървъра вместо да гадае.

Всичките три препращат само към публичните MCP и REST URL. Не съдържат API ключ — потребителите подават своя от панела за 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"] });

Open-source wrapper живее в public-wrappers/mcp/. Това е тънък httpx proxy — нула локални данни — за да остане частният gateway източник на истината.

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

Публикуваме машинно-четим site map на /llms.txt и по-богат индекс на /llms-full.txt, за да могат AI асистентите да се onboard-ват сами. Блокът Ask-an-AI на началната страница отваря нов чат в ChatGPT, Claude, Gemini, Grok или Perplexity — захранен с NACEBridge prompt, който казва на асистента да използва MCP сървъра вместо да гадае.

• 401 — липсващ или невалиден X-API-Key
• 402 — квотата за tier е изчерпана, нужен е upgrade
• 422 — входът не премина Zod валидация; отговорът носи детайли по полета
• 429 — лимитът е достигнат, спазвайте Retry-After
• 5xx — инцидент; повторенията са безопасни (всички операции са само за четене)

Метаданни NACE Rev 2.1 © Европейски съюз, преизползвани при политиката за повторно използване на Комисията. Метаданни на националните подкласове © съответните национални статистически институти (INE, INSEE, DESTATIS, CBS, …). NACEBridge картографиранията, нормализираната схема и wrapper-ите се разпространяват от TΣKSOMΛ Holding, Lda., изградено от TΣKSOMΛ Technologies и захранено от TΣKSOMΛ | MΛRKET INTΣLLIGENCE.