NACEBridge API & MCP

NACEBridge mapeia EU NACE Rev 2.1 até às subclasses nacionais de 5 dígitos usadas por 27 países da UE, o Reino Unido e a Suíça (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). Os quatro utilitários web estão também disponíveis programaticamente:

• search — pesquisa por palavra-chave global + local
• decode — expandir um código nacional para a sua hierarquia EU completa
• cousins — subclasses equivalentes transfronteiriças
• grid — pivot multi-país para uma divisão NACE

Cada pedido a /api/v1/* leva um cabeçalho X-API-Key. Entre na conta e gere chaves no seu painel de chaves API. As chaves são hashed em repouso — nunca guardamos o texto em claro.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

O endpoint MCP usa exatamente o mesmo cabeçalho, exatamente os mesmos limites por escalão e exatamente o mesmo registo de pedidos que o gateway REST — a única diferença é a URL (/mcp em vez de /api/v1/…) e o envelope JSON-RPC. Tráfego web anónimo é permitido para os utilitários da UI mas está suavemente limitado por um contador de strikes por IP (ver Limites de pedidos).

Picos acima do limite da janela devolvem HTTP 429 com Retry-After.

Cinco recursos em https://nacebridge.dev/api/v1/*. Cada endpoint aceita GET com query params ou POST com corpo JSON. As respostas têm a forma { ok, tier, data } com cabeçalhos X-RateLimit-* anexados.

# 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 fala a especificação MCP Streamable HTTP transport . Aponte qualquer cliente MCP para:

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 com ambos os content-types em 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): adicionar como Connector personalizado com a mesma URL — as ferramentas search e fetch ficam expostas para Deep Research.

Cursor: adicionar a ~/.cursor/mcp.json com a mesma URL.

Instruções drop-in que ensinam o seu assistente de IA quando e como chamar a NACEBridge. Descarregue, instale no assistente à sua escolha, e na próxima vez que o utilizador colar um código NACE / CAE / NAF / WZ / SBI o assistente irá ao servidor MCP em vez de adivinhar.

Os três referenciam apenas as URL públicas de MCP e REST. Não contêm nenhuma chave API — os utilizadores fornecem a sua a partir do painel de chaves 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"] });

O wrapper open source vive em public-wrappers/mcp/. É um proxy httpx fino — zero dados locais — para que o gateway privado permaneça a fonte de verdade.

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

Publicamos um mapa do site legível por máquina em /llms.txt e um índice mais rico em /llms-full.txt para que os assistentes de IA se auto-orientem. O bloco Ask-an-AI na página inicial entrega um chat novo a ChatGPT, Claude, Gemini, Grok ou Perplexity — semeado com um prompt NACEBridge que diz ao assistente para usar o servidor MCP em vez de adivinhar.

• 401 — X-API-Key em falta ou inválido
• 402 — quota do escalão esgotada, upgrade necessário
• 422 — entrada falhou validação Zod; a resposta carrega detalhes por campo
• 429 — limite de pedidos atingido, respeitar Retry-After
• 5xx — incidente; retries são seguros (todas as operações são apenas de leitura)

Metadados NACE Rev 2.1 © União Europeia, reutilizados ao abrigo da política de reutilização da Comissão. Metadados das subclasses nacionais © respetivos institutos nacionais de estatística (INE, INSEE, DESTATIS, CBS, …). Os mapeamentos NACEBridge, o esquema normalizado e os wrappers são distribuídos por TΣKSOMΛ Holding, Lda., construído por TΣKSOMΛ Technologies e impulsionado por TΣKSOMΛ | MΛRKET INTΣLLIGENCE.