OpenShopGraph

Developers

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
find_product POST /tool/find_product Produkt nach Titel/GTIN finden
compare_prices POST /tool/compare_prices Angebote eines Produkts vergleichen (Gesamtkosten)
get_trust POST /tool/get_trust Aggregierte Trust-Signale eines Shops
list_coupons POST /tool/list_coupons Aktive Gutscheine eines Shops
suggest GET /suggest?q=… Typeahead: Kategorien + Shops (pg_trgm)

Authentifizierung

Lese-Aufrufe (z. B. /suggest, compare_prices ) 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/compare_prices" \
  -H "content-type: application/json" \
  -d '{"product_id":"<gtin>"}'

Beispiel-Antwort GET /suggest

{
  "query": "mäh",
  "categories": [{ "category": "Outdoor & Sport", "slug": "outdoor", "count": 2 }],
  "shops": [
    { "id": "s_001", "name": "Mähprofi", "domain": "maehprofi.de", "category": "outdoor", "score": 0.97 }
  ]
}

Spezifikation + Manifeste