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

Instalar

Cola este bloco na configuração do teu cliente MCP e reinicia. Hoje não existe um link de instalação num clique que possamos garantir que funciona em todos os clientes — esta configuração copiar-colar é o caminho honesto e testado.

Claude Desktop / Cursor (bloco mcpServers)

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

Cliente MCP genérico (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])

Experimenta estes prompts

Depois de instalado, pede ao teu assistente coisas como:

“Usa o compare_prices do OpenShopGraph para encontrar o lugar mais barato para comprar um iPhone 16 Pro 256GB com envio para a Alemanha.”
“Consulta bergzeit.de no OpenShopGraph — qual é a avaliação de confiança e há cupões ativos?”
“Compara as opções de envio e os prazos de entrega de bergzeit.de no OpenShopGraph.”
“Encontra lojas no OpenShopGraph que enviam para Portugal e vendem auscultadores sem fios, depois compara os preços.”

O que o servidor MCP sabe fazer

As 12 ferramentas, num só lugar — esquema completo em /.well-known/mcp.json ou no guia de integração.

find_product: Pesquisa o catálogo de produtos por texto livre, p. ex. «iphone 16 pro 256gb».
get_product: Obtém um único produto canónico pelo seu id.
find_offers: Lista as ofertas de comerciantes para um produto e/ou uma loja.
list_coupons: Lista os cupões atualmente visíveis, filtráveis por loja.
get_trust: Obtém o sinal de confiança agregado (avaliação, número de reviews, fonte) de uma loja.
list_shipping_options: Lista as opções de envio de uma loja — transportadora, custo, prazo de entrega.
compare_offers: Compara um conjunto conhecido de ofertas, por ordem crescente de preço.
compare_prices: Ferramenta principal: classifica todos os comerciantes de um produto pelo custo total (preço + envio − melhor cupão).
price_analytics: Deteção de quedas de preço e acompanhamento do preço mais baixo histórico de uma oferta.
find_shop: Pesquisa comerciantes por texto livre, filtrável por país.
get_shop: Obtém um comerciante por id ou domínio, com as suas ofertas atuais.
report_code: Reporta se um cupão funcionou (apenas escrita, sem dados pessoais).

Todas as ferramentas são apenas de leitura, exceto report_code, que só acrescenta um resultado (sem dados pessoais) e não altera de imediato o que as outras ferramentas devolvem.