Für KI-Agenten

Deine KI-Assistenz kann das direkt abfragen.

Assistenzen lesen strukturierte Shop-Daten mit Quelle und Datum, statt aus SEO-Seiten zu raten — über den MCP-Server oder das JSON-LD, das in jeder Datensatzseite steckt.

Anfrage — über MCP (Beispielform)

find_shop({
query: "headphones",
country: "PT"
})

Antwort (Beispielform)

{
"results": [{ "name": "example-shop.com",
"canonical_domain": "example-shop.com",
"country": "PT",
"category": "electronics" }],
"total_count": 1
}

Probier es in deiner eigenen Assistenz: ChatGPT Claude Perplexity Mistral Grok KI-Assistenzen aus Asien/China:

Logos zeigen Kompatibilität, keine Empfehlung.

Vollständige MCP-Dokumentation Auffindbarkeit: /llms.txt · /.well-known/ai.txt · /.well-known/mcp.json · JSON-LD in jedem Datensatz

Datenstudie: Rückgabefristen und Zahlarten (zitierbar, CC BY 4.0, mit CSV)

Installieren

Diesen Block in die Konfiguration deines MCP-Clients einfügen und neu starten. Einen Ein-Klick-Install-Link, der heute nachweislich überall funktioniert, gibt es nicht — dieser Copy-Paste-Weg ist der ehrliche, getestete.

Claude Desktop / Cursor (mcpServers-Block)

{
  "mcpServers": {
    "openshopgraph": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.openshopgraph.com/mcp"]
    }
  }
}

Generischer MCP-Client (Streamable-HTTP)

MCP-Endpunkt (Streamable-HTTP): https://api.openshopgraph.com/mcp
Server-Karte (Schema): https://openshopgraph.com/.well-known/mcp.json
Zugang: find_shop, list_categories, get_shop, list_coupons,
  get_shop_policies und get_shipping_policy brauchen keinen Schlüssel. get_trust, report_code und
  report_issue brauchen den Header "x-api-token" (anfordern:
  info@openshopgraph.com, noch keine Selbstanmeldung). Ohne Schlüssel sind sie nicht
  öffentlich gelistet.

Diese Prompts ausprobieren

Nach der Installation kannst du deinen Assistenten zum Beispiel fragen:

“Nutze find_shop von OpenShopGraph, um Shops aus Deutschland in der Kategorie camping-hiking aufzulisten.”
“Schau bergzeit.de bei OpenShopGraph nach — was gibt der Shop zum Versand an, und wann wurde das zuletzt geprüft?”
“Vergleiche Versandoptionen und Lieferzeiten für bergzeit.de bei OpenShopGraph.”
“Liste die Gutscheincodes, die OpenShopGraph gerade zeigt, mit Shop und Prüfstatus jedes Codes.”

Was der MCP-Server kann

Alle 9 Tools an einem Ort — vollständiges Schema unter /.well-known/mcp.json oder in der Integrationsanleitung.

find_shop: Händler per Freitextsuche finden, optional nach Land gefiltert.
list_categories: Die Kategorien-Taxonomie auflisten — vor der Übergabe einer Kategorie an find_shop aufrufen.
get_shop: Einen Händler per ID oder Domain abrufen (öffentliche Sicht; das Angebots-Array bleibt leer, bis Händlerangebote erfasst sind).
list_coupons: Aktuell sichtbare Gutscheincodes auflisten, optional nach Shop gefiltert.
get_shop_policies: Angaben eines Shops zu Rückgabe (Frist, kostenloses Retourenlabel), Tracking, Zahlungsarten, Käuferschutz und Versand; die Angaben unter `policies` tragen Datum der letzten Prüfung und Quelle.
get_shipping_policy: Früherer Name von get_shop_policies, gleiche Antwort. Versandangaben eines Shops (Ziele, Lieferzeit, Freigrenze), mit Datum der letzten Prüfung.
get_trust: Vertrauensrelevante Fakten, die OpenShopGraph selbst gemessen hat (TLS, Hosting, Domainalter, Registrar, Zahlungsarten) — Einzelsignale mit Quelle und Prüfdatum, ausdrücklich keine Note.
report_code: Melden, ob ein Gutscheincode funktioniert hat (nur Schreibzugriff, keine personenbezogenen Daten).
report_issue: Ein Shop- oder Datenproblem als einen festen, dokumentierten Grund melden (nur Schreibzugriff, kein Freitext) — stößt eine Nachprüfung an, ändert ausgelieferte Daten nie direkt.

Alle Tools sind rein lesend, außer report_code: das hängt nur ein Ergebnis an (keine personenbezogenen Daten) und ändert nicht sofort, was andere Tools zurückgeben.