Model Context Protocol · para agentes de IA

Conecte seu agente
ao BuscaZap.

Uma ferramenta MCP que descobre produtos reais à venda em Mercado Livre, Amazon, Shopee, Shein e +180 lojas — já com o link de compra pronto. Seu agente chama sozinho, sem programar cada request. Comece sem cadastro: aponte pro endpoint e use.

grátis pra começar · sem chavePOST Streamable HTTP · JSON-RPC 2.0stateless sem sessão

01 — conectar

Endereço e transporte

O MCP fala Streamable HTTP: seu cliente faz POST no endpoint com uma mensagem JSON-RPC e recebe uma resposta JSON. Sem SSE, sem sessão.

Endpoint MCP: https://www.buscazap.com.br/mcp
Token OAuth: https://www.buscazap.com.br/oauth/token
Authorize: https://www.buscazap.com.br/authorize
Discovery: https://www.buscazap.com.br/.well-known/oauth-authorization-server
Protocolo: MCP 2025-06-18

Sem cadastro pra começar: o tier aberto conecta em silêncio como anonymous — nenhuma credencial. Credenciais só entram no tier enterprise, entregues por canal seguro separado (nunca aparecem nesta página).

02 — tiers e acesso

Comece grátis, evolua por tier

Um único endpoint, o acesso é resolvido por sessão. Sem credencial você já usa a busca (tier aberto). Credencial destrava mais volume e recursos.

Tier	Credencial	Teto	O que inclui
anonymous	nenhuma	50 buscas/dia por IP	busca de produtos (resposta com attribution)
free / growth	API key (em breve — self-serve)	maior	busca + memória de usuário; sem atribuição no growth
enterprise	OAuth / API key	contratual, sem corte	tudo + tools premium (negociação local, live leads) + webhook

Aberto

Sem credencial — funciona já

Aponte seu agente pro /mcp e chame a busca. Ideal pra testar e pra listagem nos diretórios de MCP. Teto de 50 buscas/dia por IP.

# Tier ABERTO/grátis — sem credencial nenhuma, funciona já:
curl -X POST https://www.buscazap.com.br/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"buscar_produtos_por_contexto","arguments":{"context":"quero um fone bluetooth ate 200 pra corrida"}}}'

Credencial

Com chave/OAuth (enterprise)

Mande a credencial no header Authorization: Bearer — ou, se seu client MCP não deixa header custom, no path /mcp/k/<chave>. Enterprise também suporta OAuth 2.0 (client_credentials + PKCE).

# Credencial no PATH (para clients MCP que não deixam mandar header):
curl -X POST https://www.buscazap.com.br/mcp/k/SUA_CHAVE \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

OAuth (máquina-a-máquina):

curl -X POST https://www.buscazap.com.br/oauth/token \
  -u "SEU_CLIENT_ID:SEU_CLIENT_SECRET" \
  -d grant_type=client_credentials

03 — configurar o cliente

Cole a config e conecte

É aqui que a maioria empaca — então já vai pronto pra colar.

Claude (app / web) — Conector personalizado

Em Settings → Connectors → Add custom connector, cole a URL abaixo. No tier aberto conecta na hora, sem login. (Enterprise: o Claude descobre o OAuth e pede a credencial.)

https://www.buscazap.com.br/mcp

Claude Desktop — arquivo de config

No claude_desktop_config.json, use a ponte mcp-remote (conecta no tier aberto sem credencial):

{
  "mcpServers": {
    "buscazap": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.buscazap.com.br/mcp"]
    }
  }
}

04 — a ferramenta

Ferramentas

Seu agente descobre isto sozinho via tools/list. Você não monta o termo de busca: passa o contexto da conversa e o BuscaZap deriva o termo e ranqueia os produtos contra ele.

buscar_produtos_por_contexto

Dado o RESUMO de uma conversa com um cliente, encontra produtos reais à venda em Mercado Livre, Amazon, Shopee, Shein e mais de 180 lojas, já com o link de compra pronto. Use assim que o cliente demonstrar intenção de comprar. Você NÃO monta o termo de busca: passe o contexto (o que quer, para quem, cor/tamanho/faixa de preço, marcas rejeitadas) e o BuscaZap deriva o termo e ranqueia os produtos contra o contexto. Retorna produtos padronizados com link.

Parâmetro	Tipo		Descrição
context	string	obrigatório	Resumo/histórico da conversa em texto livre: o que a pessoa quer, para quem, cor/tamanho/faixa de preço, marcas que ela rejeitou. Quanto mais limpo, melhor o termo gerado e o ranqueamento.
limit	integer	opcional	Máximo de produtos a retornar. Omita para receber todos os relevantes.
llm	string · gemini deepseek kimi grok	opcional	Qual LLM conduz a busca (extrai o termo do contexto e ranqueia). Omita para o padrão 'gemini' (mais rápido e já ajustado).
recomendar	boolean	opcional	Se true, além dos produtos retorna um campo 'recomendacao': uma análise curta de consultor (melhor custo-benefício / mais barato) pronta pra você repassar ao usuário. Custa ~1s a mais. Omita para resposta mais rápida.

listar_lojas

Lista as principais lojas que o BuscaZap cobre, agrupadas por segmento (moda, esporte, casa, pet, beleza, bebidas, eletrônicos...), mais o total de +180 lojas. Use quando o usuário perguntar 'quais lojas vocês têm?' ou quiser saber a cobertura antes de buscar. É uma lista CURADA de destaques reconhecíveis — para confirmar se um produto/marca específico está disponível, prefira 'buscar_produtos_por_contexto'.

Parâmetro	Tipo		Descrição

negociar_local

🔒 [Requer plano Enterprise] Aciona agentes que negociam preço/condições direto com a loja física local para o cliente. Gere uma chave em https://buscazap.com.br/api.

Parâmetro	Tipo		Descrição
context	string	obrigatório

live_leads

🔒 [Requer plano Enterprise] Entrega leads quentes em tempo real (intenção de compra georreferenciada) para lojistas parceiros. Gere uma chave em https://buscazap.com.br/api.

Parâmetro	Tipo		Descrição
segment	string	opcional

Escolha de LLM (opcional): o campo llm deixa você escolher o modelo que conduz a busca por chamada. Omita para o padrão (gemini, o mais rápido e já ajustado); os demais rodam sob demanda.

05 — chamar

Exemplo ponta a ponta

Liste as tools e faça uma busca. O $TOKEN é opcional — no tier aberto pode omitir os headers de auth (veja o exemplo sem credencial no passo 02); com credencial, use o token/chave enterprise.

tools/list

curl -X POST https://www.buscazap.com.br/mcp \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

tools/call

curl -X POST https://www.buscazap.com.br/mcp \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "buscar_produtos_por_contexto",
      "arguments": {
        "context": "quero um fone bluetooth ate 200 reais pra corrida",
        "limit": 5
      }
    }
  }'

resposta

{
  "jsonrpc": "2.0", "id": 2,
  "result": {
    "isError": false,
    "structuredContent": {
      "products": [
        {
          "store_name": "Mercado Livre",
          "short_description": "Fone Bluetooth Esportivo ...",
          "price": 149.9, "price_from": 199.9, "discount": "25%",
          "thumbnail": "https://...", "url": "https://..."
        }
      ]
    }
  }
}

06 — erros

Como os erros chegam

O MCP separa erro de protocolo de erro de execução da tool — trate os dois diferente.

Situação	Formato	O agente faz
Método/tool inexistente, request inválido	error (-32601/-32602/-32600)	trata como falha de chamada
A busca lançou exceção (ex.: llm inválido)	result + isError: true	lê o texto do erro e decide
Contexto sem intenção de compra	result + products: []	é sucesso, não erro
Sem credencial (ou chave inválida)	conecta como anonymous	funciona (nunca 401 no connect)
Tool acima do seu tier	result + isError · error: "tier_required"	gera uma chave e repete
Teto diário atingido (anonymous)	result + isError · error: "quota_exceeded"	aguarda o reset ou faz upgrade