MCP para Ecommerce Parte 2: Construa um Agente de Compras Real em 15 Minutos

A Parte 1 abordou por que o ecommerce precisa de infraestrutura MCP. Esta parte mostra como construir um agente que realmente faz compras.

Você tem um servidor MCP. Você tem dados de produtos. E agora?

Este tutorial o guiará na construção de um agente de compras AI real — um que pesquisa produtos, compara preços entre mercados e encontra as melhores ofertas. Tudo em 15 minutos.

O que você vai construir

Um agente de compras que pode:

• Pesquisar qualquer produto entre mais de 50 milhões de itens
• Comparar preços nos mercados dos EUA, Cingapura, Japão e Coreia
• Encontrar ofertas e promoções ativas
• Retornar resultados estruturados que sua interface pode renderizar

Pré-requisitos

• Node.js 18+
• Uma chave de API BuyWhere gratuita (obtenha uma aqui)
• Um cliente MCP (Claude Desktop, Cursor, VS Code ou um agente personalizado)

Passo 1: Instale o Servidor MCP (30 segundos)

npx -y @buywhere/mcp-server

Isso inicia o servidor MCP. Ele expõe 5 ferramentas para qualquer agente AI conectado.

Passo 2: Configure seu Cliente MCP (2 minutos)

Claude Desktop

Adicione ao claude_desktop_config.json:

{
  "mcpServers": {
    "buywhere": {
      "command": "npx",
      "args": ["-y", "@buywhere/mcp-server"],
      "env": {
        "BUYWHERE_API_KEY": "sua-chave-api-aqui"
      }
    }
  }
}

Cursor / VS Code

Adicione ao .cursor/mcp.json:

{
  "mcpServers": {
    "buywhere": {
      "command": "npx",
      "args": ["-y", "@buywhere/mcp-server"],
      "env": {
        "BUYWHERE_API_KEY": "sua-chave-api-aqui"
      }
    }
  }
}

Passo 3: Sua Primeira Consulta (1 minuto)

Peça ao seu agente:

"Encontre o melhor laptop abaixo de $1000 disponível nos EUA agora."

O agente chamará search_products com filtros e retornará resultados em tempo real.

Passo 4: Comparação de Preços entre Mercados (3 minutos)

Agora a parte interessante. Pergunte:

"Compare o preço dos fones de ouvido Sony WH-1000XM6 nos EUA, Cingapura e Japão. Mostre-me a opção mais barata incluindo estimativas de frete."

O agente chama compare_products entre os mercados e retorna uma comparação estruturada.

Exemplo de estrutura de resposta:

{
  "comparisons": [
    {
      "market": "EUA",
      "price": "$348.00",
      "retailer": "Amazon",
      "in_stock": true
    },
    {
      "market": "Cingapura",
      "price": "SGD 459.00",
      "retailer": "Shopee",
      "in_stock": true
    },
    {
      "market": "Japão",
      "price": "¥42,800",
      "retailer": "Rakuten",
      "in_stock": true
    }
  ]
}

Passo 5: Ofertas e Promoções (2 minutos)

Pergunte:

"Mostre-me as ofertas ativas em monitores para jogos esta semana. Ordene por percentual de desconto."

O agente chama get_deals e retorna promoções ao vivo.

Passo 6: Construa um Agente Personalizado (5 minutos)