NACEBridge API & MCP

Το NACEBridge αντιστοιχίζει το EU NACE Rev 2.1 στις πενταψήφιες εθνικές υποκλάσεις που χρησιμοποιούν 27 χώρες της ΕΕ, το Ηνωμένο Βασίλειο και η Ελβετία (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). Και τα τέσσερα web εργαλεία είναι επίσης διαθέσιμα προγραμματιστικά:

• search — παγκόσμια + τοπική αναζήτηση με λέξη-κλειδί
• decode — επέκταση εθνικού κωδικού σε πλήρη ιεραρχία ΕΕ
• cousins — διασυνοριακές ισοδύναμες υποκλάσεις
• grid — pivot πολλών χωρών για μια διαίρεση NACE

Κάθε αίτημα προς /api/v1/* φέρει header X-API-Key. Συνδεθείτε και δημιουργήστε κλειδιά στον πίνακα κλειδιών API. Τα κλειδιά αποθηκεύονται hash-αρισμένα — δεν αποθηκεύουμε ποτέ plaintext.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

Το endpoint MCP χρησιμοποιεί ακριβώς το ίδιο header, τα ίδια όρια ανά επίπεδο και το ίδιο log αιτημάτων με το REST gateway — η μόνη διαφορά είναι το URL (/mcp αντί για /api/v1/…) και ο φάκελος JSON-RPC. Η ανώνυμη web κίνηση επιτρέπεται για τα εργαλεία UI, αλλά περιορίζεται ήπια με μετρητή ανά IP (βλ. Όρια ρυθμού).

Αιχμές πάνω από το όριο παραθύρου επιστρέφουν HTTP 429 με Retry-After.

Πέντε πόροι κάτω από https://nacebridge.dev/api/v1/*. Κάθε endpoint δέχεται GET με query params ή POST με JSON body. Οι απαντήσεις είναι { ok, tier, data } με headers 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 client στο:

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 με και τους δύο τύπους περιεχομένου στο 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: προσθέστε το ίδιο URL στο ~/.cursor/mcp.json.

Έτοιμες οδηγίες που μαθαίνουν στον AI βοηθό σας πότε και πώς να καλεί το NACEBridge. Κατεβάστε, εγκαταστήστε στον βοηθό της επιλογής σας, και την επόμενη φορά που ο χρήστης επικολλήσει κωδικό NACE / CAE / NAF / WZ / SBI, ο βοηθός θα χρησιμοποιήσει τον MCP server αντί να μαντέψει.

Και τα τρία αναφέρονται μόνο στα δημόσια MCP και REST URLs. Δεν περιέχουν API key — οι χρήστες παρέχουν το δικό τους από τον πίνακα κλειδιών 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"
      }
    }
  }
}

Δημοσιεύουμε έναν μηχαναγνώσιμο χάρτη ιστότοπου στο /llms.txt και έναν πλουσιότερο δείκτη στο /llms-full.txt ώστε οι AI βοηθοί να μπορούν να αυτοενταχθούν. Το μπλοκ Ask-an-AI στην αρχική σελίδα παραδίδει μια νέα συνομιλία σε ChatGPT, Claude, Gemini, Grok ή Perplexity με prompt NACEBridge που λέει στον βοηθό να χρησιμοποιήσει τον MCP server αντί να μαντέψει.

• 401 — λείπει ή είναι άκυρο το X-API-Key
• 402 — το όριο του επιπέδου εξαντλήθηκε, απαιτείται αναβάθμιση
• 422 — η είσοδος απέτυχε στην επικύρωση Zod· η απάντηση περιέχει λεπτομέρειες πεδίων
• 429 — επιτεύχθηκε όριο ρυθμού, τηρήστε το Retry-After
• 5xx — περιστατικό· οι επαναλήψεις είναι ασφαλείς (όλες οι λειτουργίες είναι μόνο ανάγνωσης)

Μεταδεδομένα NACE Rev 2.1 © Ευρωπαϊκή Ένωση, επαναχρησιμοποιημένα σύμφωνα με την πολιτική επαναχρησιμοποίησης της Επιτροπής. Μεταδεδομένα εθνικών υποκλάσεων © αντίστοιχα εθνικά στατιστικά ινστιτούτα (INE, INSEE, DESTATIS, CBS, …). Οι αντιστοιχίσεις NACEBridge, το κανονικοποιημένο σχήμα και τα wrappers διανέμονται από TΣKSOMΛ Holding, Lda., κατασκευασμένο από TΣKSOMΛ Technologies και τροφοδοτούμενο από TΣKSOMΛ | MΛRKET INTΣLLIGENCE.