For AI agents

Your AI assistant can query this directly.

Assistants read verified, structured shop data instead of guessing from SEO pages — via the MCP server or the JSON-LD embedded in every record page.

Request — via MCP (example shape)

shops.search({
query: "wireless headphones",
ship_to: "PT",
verified_only: true
})

Response — verified & timestamped (example shape)

{
"shop": "example-shop.com",
"trust": { "imprint": "verified 2026-06-30" },
"codes": [{ "code": "EXAMPLE15",
"last_verified": "2026-06-30" }] }

Try it from your own assistant: ChatGPT Claude Perplexity Grok Mistral Asia/China AIs:

Logos indicate compatibility, not endorsement.

Full MCP documentation Discovery: /llms.txt · /.well-known/mcp.json · JSON-LD on every record

Installer

Colle ce bloc dans la configuration de ton client MCP et redémarre. Il n'existe pas de lien d'installation en un clic dont on puisse garantir le bon fonctionnement partout aujourd'hui — ce copier-coller est la voie honnête et testée.

Claude Desktop / Cursor (bloc mcpServers)

{
  "mcpServers": {
    "openshopgraph": {
      "command": "npx",
      "args": ["-y", "@openshopgraph/mcp-server"]
    }
  }
}

Client MCP générique (streamable-HTTP)

MCP endpoint (streamable-HTTP): https://api.openshopgraph.org/mcp
Server card (schema): https://openshopgraph.org/.well-known/mcp.json
Auth: consumer key via "x-api-token" header (request one: [email protected])

Essaie ces prompts

Une fois installé, demande par exemple à ton assistant :

“Utilise compare_prices d'OpenShopGraph pour trouver où acheter un iPhone 16 Pro 256 Go au meilleur prix, livraison en Allemagne.”
“Consulte bergzeit.de sur OpenShopGraph — quelle est sa note de confiance, y a-t-il des codes promo actifs ?”
“Compare les options et délais de livraison de bergzeit.de sur OpenShopGraph.”
“Trouve des boutiques sur OpenShopGraph qui livrent au Portugal et vendent des écouteurs sans fil, puis compare les prix.”

Ce que le serveur MCP sait faire

Les 12 outils, réunis ici — schéma complet sur /.well-known/mcp.json ou dans le guide d'intégration.

find_product: Recherche en texte libre dans le catalogue de produits, ex. « iphone 16 pro 256gb ».
get_product: Récupère un produit canonique par son id.
find_offers: Liste les offres marchandes pour un produit et/ou une boutique.
list_coupons: Liste les codes promo actuellement visibles, filtrables par boutique.
get_trust: Récupère le signal de confiance agrégé (note, nombre d'avis, source) d'une boutique.
list_shipping_options: Liste les options de livraison d'une boutique — transporteur, coût, délai.
compare_offers: Compare un ensemble connu d'offres, triées par prix croissant.
compare_prices: Outil phare : classe tous les marchands d'un produit par coût total (prix + livraison − meilleur code promo).
price_analytics: Détection de baisse de prix et suivi du prix le plus bas pour une offre.
find_shop: Recherche de marchands en texte libre, filtrable par pays.
get_shop: Récupère un marchand par id ou domaine, avec ses offres actuelles.
report_code: Signale si un code promo a fonctionné (écriture seule, aucune donnée personnelle).

Tous les outils sont en lecture seule, sauf report_code, qui se contente d'ajouter un résultat (sans donnée personnelle) et ne change pas immédiatement ce que renvoient les autres outils.