A robotikai index az eszközeidben.

API-hozzáférés

A gépi lekérdezésekhez Bearer API-kulcs szükséges. A kulcsot szerveren vagy a saját AI-kliensed titkos beállításaiban tárold; nyilvános weboldal kódjába ne illeszd be.

• Alapcím: https://robotikaterkep.hu/api/v1
• OpenAPI 3.1 specifikáció
• MCP-végpont: https://robotikaterkep.hu/mcp
• Hozzáférés igénylése

Keresés és lapozás

curl --get 'https://robotikaterkep.hu/api/v1/organizations' \
  --header "Authorization: Bearer $ROBOTIKAI_INDEX_KEY" \
  --data-urlencode 'q=robotika' \
  --data-urlencode 'category=integrator' \
  --data-urlencode 'city=Budapest' \
  --data-urlencode 'limit=10'

A q, category és city feltételek együtt érvényesülnek. A keresés kis- és nagybetűtől, illetve ékezetektől független. A válaszban a nextOffset mutatja a következő oldal kezdetét; ha null, nincs több oldal. Egy kérés legfeljebb 50 szervezetet ad vissza.

Minden találat tartalmazza a hivatkozásra használható nyilvános url mezőt. Az updatedAt a szinkron időpontja. A forrásban hiányzó cím vagy koordináta hiányzó adatként marad meg; ne egészítsd ki feltételezéssel.

MCP-kapcsolat

A kiszolgáló állapotmentes Streamable HTTP kapcsolatot és JSON-válaszokat használ. A kliensben add meg a fenti /mcp URL-t és az Authorization: Bearer … fejlécet. Olyan kliens szükséges, amely támogat egyedi Bearer fejlécet; OAuth-bejelentkezést ez a kiadás nem biztosít.

Elérhető eszközök:

• search_organizations: keresés és lapozás;
• get_organization: egy szervezet részletes lekérdezése;
• list_categories: a szűrhető szakterületek listája.

Támogatott protokoll: 2025-06-18. Az MCP a REST API-val azonos kulcsot és adatforrást használ. A szerver nem tart fenn SSE-kapcsolatot és nem ad tömeges exportot.

Rövid leírás és frissítés

A szervezetek bemutatkozása a description mezőben érkezik a keresésben és a részletes lekérdezésben is. Üres szöveg esetén még nincs bemutatkozás. A leírásokban is lehet keresni, például q=humanoid feltétellel.

Az oldal, a REST API és az MCP ugyanazt a közzétett adatállományt használja. Az updatedAt a forrásszinkron ideje. Hiányzó koordináta esetén a coordinates értéke null; egy tárolt pont sem jelent önmagában független címellenőrzést. Az adatbázis szervezetek felfedezésére szolgál, a koordinátákat közvetlen robotnavigáció előtt külön ellenőrizni kell.

MCP-próba Node.js-ből

A hivatalos TypeScript SDK 1.32.1 verziójával tesztelt kapcsolat. Telepítés: npm install @modelcontextprotocol/sdk@1.32.1. A példát .mjs fájlként futtasd, a kulcsot a ROBOTIKAI_INDEX_KEY környezeti változóban add meg.

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const key = process.env.ROBOTIKAI_INDEX_KEY;
if (!key) throw new Error('Hiányzik az API-kulcs.');
const client = new Client({ name: 'robotikai-kliens', version: '1.0.0' });
try {
  await client.connect(new StreamableHTTPClientTransport(
    new URL('https://robotikaterkep.hu/mcp'),
    { requestInit: { headers: { Authorization: `Bearer ${key}` } } }
  ));
  const result = await client.callTool({
    name: 'search_organizations',
    arguments: { q: 'humanoid', limit: 5 }
  });
  console.log(result.structuredContent);
} finally {
  await client.close();
}

A kliensoldali próba a keresést és az adatok elérését igazolja. Egy adott robot vagy AI-rendszer tényleges integrációját a saját környezetében is tesztelni kell. Ha a kliens csak OAuth-belépést támogat, közvetlenül a REST API-t vagy saját szerveroldali közvetítőt használj.

Lekérdezési korlátok

Az adatvégpontokon IP-címenként 60 kérés/perc, a hitelesített hozzáférésnél kulcsonként további 120 kérés/perc korlát érvényesül. A Cloudflare korlátozói adatközpontonként, közelítő módon működnek; ezek nem globális, elszámolási célú kvóták. A határérték elérésekor 429 válasz és Retry-After fejléc érkezik. Várj a jelzett ideig, és fokozatosan próbáld újra.

Hibás vagy lejárt kulcs: 401. Hibás szűrés: 400. Nem létező szervezet: 404. Átmeneti kiszolgálási hiba: 503.

Forrásmegjelölés

A válaszban hivatkozz az érintett szervezet adatlapjára, nevezd meg a Magyar Robotika Térképet, és jelezd az adatfrissítés idejét. A nyilvántartott jelenlétet ne értelmezd tagsági vagy minősítési igazolásként.