OpenShopGraph

Entwickler

OpenShopGraph spricht zwei Protokolle gegen dieselbe Datenbasis: ein REST-Werkzeug-API (POST /tool/<name>) und MCP (für Claude, ChatGPT, Perplexity). Lese-Endpunkte sind ohne Key nutzbar; höhere Kontingente brauchen einen API-Token.

Endpunkte

Basis: https://api.openshopgraph.org
ToolMethodePfadZweck
find_shop POST /tool/find_shop Shop nach Name/Domain finden
list_categories POST /tool/list_categories Kategorien-Taxonomie auflisten (vor find_shop mit category-Filter)
get_shop POST /tool/get_shop Einzelnen Shop per ID/Domain abrufen
list_coupons POST /tool/list_coupons Aktive Gutscheine eines Shops
get_shipping_policy POST /tool/get_shipping_policy Versandangaben eines Shops abrufen (Ziele, Lieferzeit, Freigrenze)
get_trust POST /tool/get_trust Vertrauensrelevante Fakten, die OpenShopGraph selbst gemessen hat (TLS, Hosting, Domainalter, Registrar, Zahlungsarten) — Einzelsignale mit Quelle und Pruefdatum, ausdruecklich KEINE Note
report_code POST /tool/report_code Ergebnis eines Code-Versuchs melden (nur Schreiben)
report_issue POST /tool/report_issue Shop- oder Datenfakten-Problem mit festem Grund melden (nur Schreiben)

Authentifizierung

Lese-Aufrufe (z. B. /suggest, list_coupons ) sind keyless im Rahmen fairer Nutzung. Für höhere Limits sendest du den Header x-api-token: <dein-token>.

Beispiel-Aufruf

curl -s "https://api.openshopgraph.org/suggest?q=mäh&limit=5"

curl -s -X POST "https://api.openshopgraph.org/tool/list_coupons" \
  -H "content-type: application/json" \
  -d '{"shop_domain":"example.com"}'

Beispiel-Antwort GET /suggest

{
  "query": "mäh",
  "categories": [{ "category": "Haus & Garten", "slug": "home-garden", "count": 2 }],
  "shops": [
    { "id": "s_001", "name": "Example Shop", "domain": "example.com", "category": "home-garden", "score": 0.97 }
  ]
}

Spezifikation + Manifeste