Como integrar meu chatbot com dados do Mercadolivre.com.br (MCP + API)

Chatbot bom não “chuta”: ele consulta dados. Para isso, você usa um agente (MCP) que chama a API da GeckoAPI e devolve informações estruturadas.

O problema

A maioria dos chatbots responde com base no que o modelo “aprendeu” durante o treinamento. Isso significa que:

Preços estão desatualizados
Produtos podem não existir mais
Informações podem estar simplesmente erradas

O resultado: alucinação. E alucinação destrói a confiança do usuário.

A solução: dados em tempo real via MCP

Com o protocolo MCP (Model Context Protocol), seu agente de IA pode chamar ferramentas externas — como a API da GeckoAPI — antes de responder.

Arquitetura simples

Usuário pergunta no chatbot
Agente identifica intenção e chama ferramenta MCP
GeckoAPI retorna JSON com dados do Mercado Livre
Agente responde com dados e contexto verificável

É direto: o agente age como um “mediador inteligente” entre o usuário e os dados.

Exemplo de perguntas

“Esse produto tem quais variações?”
“Qual o preço atual e o histórico?”
“Esse anúncio está disponível?”
“Quem é o vendedor e qual a reputação?”
“Me mostre as especificações técnicas.”

O agente consulta a API, processa o JSON e formula a resposta em linguagem natural.

Configuração MCP (exemplo)

{
  "mcpServers": {
    "geckoapi": {
      "url": "https://api.geckoapi.com.br/v1/mcp",
      "headers": {
        "Authorization": "Bearer pk_live_sua_chave"
      }
    }
  }
}

Se o seu cliente MCP já converte apiKey em header automaticamente, isso também funciona. No protocolo HTTP, a GeckoAPI aceita:

Authorization: Bearer pk_live_...
X-API-Key: pk_live_...

Como as ferramentas aparecem no MCP

Cada scraper habilitado para a sua conta vira uma ferramenta separada. O nome da ferramenta é derivado do apiId do backend:

mercadolivre.com.br:pdp vira mercadolivre_com_br_pdp
mercadolivre.com.br:plp vira mercadolivre_com_br_plp
booking.com.br:pdp vira booking_com_br_pdp

Os campos de entrada seguem os mesmos nomes da API /v1/extract, mas target e type já ficam fixos na própria ferramenta. Exemplo: ao chamar mercadolivre_com_br_pdp, seu agente envia só os argumentos relevantes como url e executionId.

Limitações da v1

O endpoint hospedado é https://api.geckoapi.com.br/v1/mcp
O servidor atual é stateless e responde em JSON via POST
GET e DELETE não são usados nessa versão
A autenticação da v1 usa apenas chave estática de API; OAuth ficará para uma versão futura

Boas práticas

Sempre logar chamadas — para auditoria, debug e controle de custo
Definir limites por usuário — rate limit evita surpresas na fatura
Cache quando fizer sentido — respostas que mudam pouco podem ser cacheadas
Tratar erros — se a API não responder, o chatbot deve ter um fallback elegante

LGPD

Cuidado com dados pessoais. Se o chatbot lida com dados de terceiros, garanta que:

Existe base legal para o tratamento
O usuário sabe que dados estão sendo consultados
Dados sensíveis não são expostos indevidamente

Acesse: dashboard.geckoapi.com.br e comece com 1000 requisições grátis/mês.