Buscar

CupomDescontos.com para agentes de IA

Esta página documenta como um agente (crawler, assistente com navegação, ferramenta MCP) pode consumir o conteúdo e os dados deste site de forma estruturada — sem depender de scraping de HTML renderizado.

O que é este site

Agregador brasileiro de cupons de desconto e ofertas, com mais de 500 cupons ativos de centenas de lojas. Os cupons vêm de integração direta com a Lomadee (maior rede de afiliados do Brasil) e sincronizam automaticamente a cada 6 horas — nenhum código ou desconto exibido é estimado ou inventado.

Variante Markdown de qualquer página

Toda URL do site tem uma versão em Markdown, disponível de duas formas equivalentes:

GET /cupom/amazon.md

# ou, na URL normal:
GET /cupom/amazon
Accept: text/markdown

A resposta vem com Content-Type: text/markdown, front matter YAML (título, descrição, URL canônica), o conteúdo principal da página limpo — sem menu, rodapé, botão ou script — e todo o schema.org (JSON-LD) da página original preservado em blocos de código no final. Funciona em qualquer página do site, incluindo as páginas de blog estáticas.

API pública

Dado ao vivo, direto do banco — nunca um snapshot desatualizado.

  • GET /api/coupons — busca de cupons por termo, loja ou categoria
  • GET /api/stores — lista de lojas parceiras
  • /openapi.json — especificação OpenAPI completa
  • /api-docs — documentação legível
  • /.well-known/api-catalog — descoberta automática (RFC 9727, application/linkset+json)

Ferramentas WebMCP

O site registra 2 ferramentas via navigator.modelContext.registerTool (search_coupons e get_best_coupon_for_store) para um agente que já esteja rodando dentro do navegador do usuário. Isso é diferente de um endpoint HTTP — só funciona no contexto de uma sessão de navegador com suporte à API experimental WebMCP, não é algo que um crawler server-side consiga chamar de fora.

Conteúdo com dado agregado original

Páginas com fato numérico próprio, recalculado direto do catálogo — não repetem o que já existe em outro lugar:

Descoberta completa

Esta página é curadoria, não lista exaustiva. Para o catálogo completo de URLs, use o sitemap.xml — a mesma regra do Markdown se aplica a qualquer URL listada nele: acrescente .md no final.

Perguntas frequentes

O que é o CupomDescontos.com?

Um agregador brasileiro de cupons de desconto e ofertas, com mais de 500 cupons ativos de centenas de lojas parceiras. Os cupons vêm de integração direta com a Lomadee (maior rede de afiliados do Brasil) e são sincronizados automaticamente 4 vezes ao dia — nenhum cupom é inventado ou estimado.

Como pegar o conteúdo de uma página em Markdown?

Qualquer URL do site tem uma variante em Markdown: acrescente ".md" no final da URL (ex: /cupom/amazon.md), ou envie o header "Accept: text/markdown" na mesma URL normal. A resposta vem limpa (sem menu, rodapé, script) e inclui todo o schema.org da página em blocos de código JSON no final.

Existe API pública?

Sim. /api/coupons e /api/stores retornam dado ao vivo do banco (nunca um snapshot). A especificação OpenAPI está em /openapi.json, documentação legível em /api-docs, e descoberta automática via /.well-known/api-catalog (RFC 9727).

Os dados são atualizados com que frequência?

Cupons e ofertas sincronizam a cada 6 horas. Cupons expirados são removidos automaticamente, nunca ficam visíveis vencidos.