SanDeals.net
Nesta páginaEscolha como integrar
Spec em MarkdownVer OpenAPI

Desenvolvedores

Comece a construir com SanDeals

Conecte seu agente de IA ou aplicativo ao catálogo de ofertas do SanDeals. Esta página explica a configuração com MCP, API REST e ChatGPT Actions, seguida da referência completa.

claude mcp add --transport http sandeals https://www.sandeals.net/mcp
URL do servidor
https://www.sandeals.net/mcp
  • Streamable HTTP
  • Auth: None
  • Somente leitura

Funciona comClaude CodeChatGPTCursor

Integrações

Escolha como integrar

Escolha a interface que combina com seu cliente. As três leem o mesmo catálogo.

MCP

Para assistentes e agentes de IA. Conecte uma vez e seu modelo chama search_deals e list_deals como ferramentas.

REST API

Para aplicativos, scripts e backends. Envie uma requisição HTTP e receba JSON estruturado.

ChatGPT Actions

Para GPTs personalizados. Importe a especificação OpenAPI e chame a operação searchDeals.

Primeiros passos

Início rápido

Este guia rápido conecta a SanDeals ao Claude Code e executa sua primeira busca. Em seguida vêm os passos para ChatGPT, Cursor e outros clientes.

Pré-requisitos

  • Um cliente MCP como Claude Code, ChatGPT ou Cursor
  • Ou qualquer cliente HTTP, como curl, para a API REST
  • Sem conta nem chave de API: o servidor é público e somente leitura

Claude Code

  1. Adicione o servidor

    Execute este comando no terminal. Ele registra o SanDeals como um servidor Streamable HTTP chamado sandeals.

    Terminal
    claude mcp add --transport http sandeals https://www.sandeals.net/mcp

  2. Verifique a conexão

    Liste seus servidores. Uma conexão funcionando mostra ✓ Connected ao lado de sandeals. Se aparecer Failed to connect, verifique sua rede e execute o comando de adição novamente. Dentro de uma sessão do Claude, /mcp mostra o mesmo status.

    Terminal
    claude mcp list
    Saída
    Checking MCP server health...

sandeals: https://www.sandeals.net/mcp (HTTP) - ✓ Connected

  3. Busque ofertas

    Pergunte em linguagem natural. O Claude chama search_deals e responde com títulos e links do catálogo.

    Claude Code
    Use a SanDeals para encontrar ofertas de café e retorne o título e o link de cada uma.
    Saída
    Aqui estão ofertas de café da SanDeals:

1. Café moído 500 g — https://slink.sandeals.net/AbC123
2. Café solúvel 3 em 1, 20 sachês — https://slink.sandeals.net/XyZ789

Confira as condições no site da loja antes de comprar.
Para compartilhar o servidor com sua equipe, adicione --scope project. O Claude Code salva a configuração em .mcp.json no seu repositório.
claude mcp add --scope project --transport http sandeals https://www.sandeals.net/mcp

ChatGPT

  1. Em ChatGPT Connectors, adicione um custom MCP server.

  2. Cole a URL do servidor e escolha No authentication.

    URL do servidor
    https://www.sandeals.net/mcp

  3. Instale. Em um novo chat, digite @ e selecione SanDeals.

A disponibilidade depende das permissões do seu workspace. ChatGPT Actions, abaixo, é uma integração REST separada.

Cursor e outros clientes

Qualquer cliente compatível com MCP remoto via Streamable HTTP se conecta pela URL do servidor. No Cursor, adicione-a ao mcp.json:

~/.cursor/mcp.json
{
  "mcpServers": {
    "sandeals": {
      "url": "https://www.sandeals.net/mcp"
    }
  }
}

ChatGPT Actions

No ChatGPT, crie um GPT personalizado, abra Actions e escolha Import from URL. Cole a URL abaixo, defina Authentication como None e o GPT chamará a operação searchDeals.

OpenAPI
https://www.sandeals.net/openapi.json

Prompt do agente

Aponte o agente para www.sandeals.net/for-agents.md ou use este prompt:

Prompt do agente
Conecte-se a https://www.sandeals.net/mcp. Chame search_deals. Retorne o título e o link de cada oferta da resposta.

Referência

Servidor MCP

O servidor MCP usa Streamable HTTP e não mantém estado de sessão entre requisições. A URL dele é www.sandeals.net/mcp.

EndpointPOST /mcp
AliasPOST /api/mcp
AuthNone
TransportStreamable HTTP · JSON-RPC 2.0
Protocol2025-03-26 · 2025-06-18 · 2025-11-25
Methodsinitialize · tools/list · tools/call

Ferramentas

search_dealsSomente leitura

Busca ofertas por palavra-chave. Cada resultado tem título, link e categoria.

CampoTipoObservações
queryObrigatóriostring1–512 chars
limitinteger1–50 · default 10
list_dealsSomente leitura

Lista o catálogo, com filtro opcional por categoria ou palavra-chave.

CampoTipoObservações
categoryenumall · food · travel · shopping · tech · books · lifestyle · education
searchstring≤ 512 chars
limitinteger1–100 · default 20
tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_deals",
    "arguments": {
      "query": "coffee",
      "limit": 5
    }
  }
}

REST API

A API REST executa a mesma busca da ferramenta MCP search_deals. Passe sua consulta em q. limit é opcional, com padrão 10 e máximo 50. Em requisições POST, envie mode: "agent" para receber JSON estruturado.

GETPOST/api/search-advanced

curl "https://www.sandeals.net/api/search-advanced?q=coffee&limit=5"
  • Catálogo: GET /api/deals lista o catálogo. Filtre com category, search (ou seu alias q) e limit.
  • Fallback em HTML: GET /search?q=coffee retorna uma página de resultados em HTML que funciona sem JavaScript. Use apenas se seu cliente não consegue ler JSON.

Resposta

Cada resultado inclui title e href.

response.json
{
  "ok": true,
  "query": "coffee",
  "total": 1,
  "results": [
    {
      "title": "Example Cafe",
      "href": "https://slink.sandeals.net/example",
      "category": "food",
      "summary": "Example cafe — coffee and tea.",
      "score": 13,
      "source": "deals"
    }
  ],
  "response": "Found 1 deal for \"coffee\": 1. Example Cafe — https://slink.sandeals.net/example",
  "meta": {
    "mode": "agent",
    "matched": true
  }
}
CampoTipoObservações
results[].titlestringNome da loja ou da oferta
results[].hrefstringURL da oferta
results[].categorystringfood (alimentação), travel (viagens), shopping (compras), tech (tecnologia), books (livros), lifestyle (estilo de vida)
meta.matchedbooleanfalse indica sugestões alternativas

Restrição

Se meta.matched for false, informe que não há correspondência exata e retorne as linhas sugeridas. Use apenas valores presentes na resposta.

Testar

Faça uma busca direto do navegador. O formulário envia uma requisição GET para /search, a mesma página de resultados que as pessoas usam, e funciona com JavaScript desativado.

Exemplos: coffeegiàyvoucherJSON café

Índices

Estes arquivos descrevem a SanDeals para crawlers e agentes de código. Cada um lista os mesmos endpoints em um formato diferente.

CaminhoFormato
/llms.txtMarkdown
/for-agents.mdMarkdown
/api/llmsJSON
/.well-known/ai.txtText
/openapi.jsonOpenAPI 3
GET /mcpJSON

Próximos passos

Você conectou a SanDeals. Agora explore a referência completa e as outras formas de integrar.

Referência da APITodos os endpoints, parâmetros e esquemas de resposta.Servidor MCPDetalhes do servidor, ferramentas e passos de conexão em uma página.Especificação OpenAPIImporte no ChatGPT Actions ou gere um cliente.Guia para agentesA documentação em Markdown, para agentes de código e crawlers.