API & MCP – Tourism.one Data

Zugang

Offene Daten lesen Sie ohne Schlüssel. Das sind Objekte, die ausschließlich aus Quellen mit offener Lizenz stammen.

Ein Mandantenschlüssel gibt Zugriff auf die Daten einer Region oder eines Kunden, bei eigenen Daten auch schreibend. Er wird nur auf Anfrage vergeben und im Kopf „Authorization: Bearer <Schlüssel>“ gesendet.

Schlüssel anfragen

REST-Schnittstelle

Basisadresse: https://data.tourism.one. Die Schnittstelle ist als Version 0 gekennzeichnet; Änderungen sind noch möglich.

GET /api/v0/objects: Objekte suchen. Filter: query, type (Place, Accommodation, Event, Tour, Organization), category, limit.
GET /api/v0/objects/{id}: Ein Objekt mit allen Angaben und deren Herkunft.
GET /objects/{id}: Dasselbe Objekt als JSON-LD (Schema.org). Die Sprache wählen Sie mit lang.
GET /schema/v0.1/object.schema.json: JSON-Schema der Objekte.
GET /api/v0/sources: Quellen-Register. Filter: mode, category, status.
GET /api/v0/stats: Gesamtzahlen der offenen Daten.
GET /api/v0/categories: Kategorien (Taxonomie).
GET /api/v0/changes: Änderungen seit einem Zeitpunkt (since).

Beispielabruf

curl "https://data.tourism.one/api/v0/sources?mode=read-only"
curl "https://data.tourism.one/api/v0/objects?type=Event&limit=5"
curl -H "Authorization: Bearer <key>" "https://data.tourism.one/api/v0/objects?query=sauna"

MCP für KI-Assistenten

Über den MCP-Endpunkt https://mcp.tourism.one durchsuchen KI-Assistenten die Daten, listen Quellen und Kategorien auf und prüfen die Herkunft einzelner Angaben. Ohne Schlüssel ist der Zugriff lesend und auf offene Daten beschränkt.

Die Adresse mcp.tourism.one wird derzeit eingerichtet.

Beispielkonfiguration für einen MCP-Client

Ohne Schlüssel (offene Daten, nur lesend). Die Schreibweise der Konfiguration unterscheidet sich je nach Client.

{
  "mcpServers": {
    "tourism-one-data": {
      "type": "http",
      "url": "https://mcp.tourism.one"
    }
  }
}

Mit Mandantenschlüssel (Daten des Mandanten, eigene Daten auch schreibbar). Ersetzen Sie den Platzhalter durch Ihren Schlüssel und legen Sie ihn nie in einem Repository ab.

{
  "mcpServers": {
    "tourism-one-data": {
      "type": "http",
      "url": "https://mcp.tourism.one",
      "headers": { "Authorization": "Bearer <key>" }
    }
  }
}

Werkzeuge

Ohne Schlüssel (lesend)

search_objects
get_object
find_nearby
list_events
list_changes
describe_schema
list_sources
list_categories

Mit Mandantenschlüssel

tenant_stats
search_tenant_objects
upsert_own_object
delete_own_object
export_tourismus_one

Der Umfang wächst mit den Versionen; maßgeblich ist die Werkzeugliste, die der Server selbst ausgibt.