Agentes de IA para pesquisa de e-commerce com MCP

Um agente de IA é bom na parte lenta da pesquisa de e-commerce: fazer dez pesquisas, abrir os resultados, compará-los e redigir o que eles têm em comum. O que falta a ele, sozinho, são dados. Pergunte a um assistente de chat quais lojas estão crescendo em um nicho e ele só consegue adivinhar com base no que aprendeu no treinamento.

O MCP resolve isso dando ao agente ferramentas que ele pode chamar para obter dados ao vivo. Conecte um agente ao servidor MCP do SellWinners e ele mesmo pode pesquisar lojas Shopify, anúncios e e-mails de marketing, e depois entregar a você uma tabela ou um resumo. Veja como o MCP funciona, como conectar seu agente, prompts que dão bons resultados e como as chamadas são descontadas do seu plano.

O que é MCP, em palavras simples

MCP é a sigla de Model Context Protocol. É um padrão aberto para conectar assistentes de IA a ferramentas e dados externos.

Ele tem dois lados. Um servidor MCP publica uma lista de ferramentas: o nome de cada uma, o que ela faz e os argumentos que recebe. Um cliente MCP é o app com que você conversa, como Claude Desktop, Cursor ou VS Code. O cliente mostra a lista de ferramentas ao modelo. Quando sua pergunta precisa de dados, o modelo escolhe uma ferramenta e preenche os argumentos, o cliente executa a chamada e o resultado volta para o modelo ler antes de responder ou chamar a próxima ferramenta.

Para a pesquisa, isso muda o trabalho. Você faz uma pergunta em linguagem comum, o agente escolhe e encadeia as ferramentas, e você revisa a resposta. Você não escreve código, e o agente trabalha com os mesmos dados do app web e da API REST do SellWinners.

O que o agente pode fazer com o SellWinners

O servidor expõe o produto como ferramentas prontas. Estas são as que você mais vai usar para pesquisa:

Ferramenta	O que faz
`lookup`	Transforma o nome de uma marca, o domínio de uma loja ou o ID de uma página do Facebook nos IDs que as outras ferramentas usam
`search_shops`	Pesquisa ou navega pelas lojas Shopify com filtros
`find_winning_products`	Produtos que estão vendendo agora em um nicho
`find_similar_shops`	Os concorrentes de uma loja, por ID ou domínio
`brief_competitor`	Um resumo compacto sobre um concorrente
`search_ads`	Pesquisa anúncios da Meta por palavras no texto, na marca ou na página de destino
`scan_ad`	O registro completo de um anúncio da Meta
`creative_inspiration_pack`	Inspiração criativa para um nicho
`search_google_ads_library`	Pesquisa anúncios do Google
`search_tiktok_library`	Pesquisa anúncios e posts orgânicos do TikTok
`search_emails`	Pesquisa os e-mails de marketing das marcas
`analyze_shop_emails`	A estratégia de e-mail de uma loja
`analyze_brand_changes`	O que mudou em uma marca monitorada ao longo de um período
`usage_get`	Seu plano, os créditos mensais e quantos você já usou

Há outras para monitorar marcas, salvar itens em quadros e favoritos e compartilhar. A página do MCP lista todas as ferramentas com seus argumentos.

Como conectar seu agente ao SellWinners

Crie uma chave de API. Crie uma conta; depois, crie uma chave no seu painel. Contas Free também criam chaves: o plano Free inclui o app web e o servidor MCP (150 créditos por mês), sem a API (veja os planos e seus preços). Crie uma chave só para o seu agente, para poder revogá-la separadamente depois.
Adicione o servidor ao seu cliente. Seu cliente precisa de três coisas: a URL do endpoint exibida na página do MCP, o transporte HTTP streamable e a sua chave em um cabeçalho X-API-Key (ou Authorization: Bearer seguido da chave). A página do MCP traz configurações prontas para Cursor, VS Code e Claude Desktop. O Claude Desktop se conecta pela ponte mcp-remote, que precisa do Node.js.
Verifique se funciona. Pergunte ao seu agente: «Quantos dos meus créditos do SellWinners eu já usei neste mês?» Ele deve chamar usage_get ou check_credits, e nenhuma das duas custa crédito.

Outros clientes e frameworks de agentes funcionam quando são compatíveis com servidores MCP remotos via HTTP streamable com um cabeçalho personalizado. Se você usa outro assistente, o ChatGPT por exemplo, verifique se a sua versão permite adicionar um servidor MCP remoto com um cabeçalho personalizado. Se permitir, esses mesmos três valores são tudo de que ele precisa.

Prompts que funcionam

Os agentes se saem melhor com perguntas específicas: diga o nicho, o mercado, quantos resultados você quer e o formato da resposta. Você pode citar ferramentas para orientar o agente ou deixar a escolha com ele.

Pesquisa de produtos

Use find_winning_products para «dog grooming». Depois, use search_shops para encontrar lojas Shopify desse nicho que vendem para os EUA com pelo menos 20.000 visitas mensais, ordenadas pelo crescimento do tráfego em 30 dias. Me dê uma tabela com as 10 primeiras, com loja, visitas mensais, crescimento, produto mais vendido e o preço dele.

Continue com «para as três primeiras, use brief_competitor e me diga o que elas têm em comum». Antes de apostar em um candidato a produto vencedor, passe seus próprios custos ao preço de mercado pela calculadora de margem de lucro.

Pesquisa de anúncios da concorrência

Use search_ads para listar os anúncios ativos da Meta de [domínio do concorrente] que estão no ar há pelo menos 30 dias, ordenados por alcance. Para cada um, informe o gancho de abertura, o título, a chamada para ação, a página de destino e os dias no ar. Depois, resuma os três ângulos que ele mais repete.

Isso transforma uma pesquisa na biblioteca de anúncios em um briefing criativo. Peça a mesma marca com search_tiktok_library e search_google_ads_library para comparar canais, ou use creative_inspiration_pack para um nicho inteiro quando precisar de ganchos novos.

Análises completas de lojas

Me dê um resumo de [domínio do concorrente] com brief_competitor. Depois, use find_similar_shops ordenado por visitas mensais e compare as cinco primeiras em uma tabela: visitas mensais, crescimento em 30 dias, anúncios ativos, número de produtos. Termine com analyze_shop_emails para a primeira loja: com que frequência ela envia e-mails, em quais dias e com quais promoções.

O guia sobre como analisar qualquer loja Shopify lista tudo o que vale a pena verificar em uma análise completa.

Acompanhamento contínuo

Adicione [domínio do concorrente] ao meu monitor de marcas.

Depois, uma vez por semana, pergunte:

Use analyze_brand_changes em [domínio do concorrente] para os últimos 7 dias. Quais anúncios novos ele lançou e quais anúncios subiram de posição?

Monitorar as marcas que você escolher faz parte dos planos pagos. O agente também pode salvar o que encontra: peça que ele crie um quadro e adicione os cinco melhores anúncios com create_board e add_board_item.

Como as chamadas de ferramentas consomem seus créditos

Uma chamada de ferramenta custa os resultados que retorna. 1 crédito = 1 resultado retornado: os detalhes de uma marca, um anúncio ou uma linha de uma lista. Um resultado vazio é grátis. As chamadas MCP saem dos créditos mensais do seu plano, os mesmos créditos que a API REST usa.
Algumas chamadas são grátis. Chamadas com falha não custam nada, assim como usage_get, check_credits, lookup e lookup_filter_ids. Chamadas barradas pelo limite de requisições e chamadas com parâmetros rejeitados também não custam nada.
Uma pergunta pode gerar várias chamadas. O prompt de análise completa acima faz pelo menos três: brief_competitor, find_similar_shops e analyze_shop_emails. Cada uma custa os resultados que retorna, e um lookup antes não custa nada. Peça menos resultados para gastar menos.
O app web não conta. Navegar e conferir resultados no app não consome nenhum dos seus créditos.
Os créditos são mensais. Eles se renovam no dia 1º do mês (UTC). Quando acabam, as chamadas seguintes são recusadas até a renovação, a menos que o proprietário do seu espaço de trabalho compre créditos de recarga ou faça upgrade. Também se aplica um limite de requisições por minuto, compartilhado por todo o espaço de trabalho.

Boas práticas para pesquisar com agentes

Peça as fontes. Faça o agente dizer qual ferramenta chamou, com quais filtros, e listar os domínios ou IDs por trás de cada descoberta para que você possa abri-los.
Mantenha-o nos dados. Diga a ele para usar apenas números dos resultados das ferramentas e para dizer claramente quando uma pesquisa não retornou nada. Isso o impede de preencher lacunas com suposições.
Confira o que embasa uma decisão. Antes de encomendar estoque ou passar um briefing para uma equipe de criação, abra as lojas principais na página Lojas do app e os anúncios principais na página Anúncios.
Lembre-se do que é estimado. O tráfego, as vendas e o investimento em anúncios de outras marcas são estimativas. Use-os para comparar, não como números exatos.
Delimite seus prompts. Um mercado, um limite de resultados e um formato de saída claro usam menos chamadas do que «me conte tudo sobre produtos para pets».
Leia antes de confirmar. As ferramentas que excluem ou compartilham algo só são executadas com uma confirmação explícita, então verifique o que o agente propõe antes de dizer sim.
Salve os prompts que funcionam. Um bom prompt de análise de loja ou de pesquisa de anúncios vira um modelo que você reutiliza toda semana.

Como fazer isso com o SellWinners: agente, app e API

Uma única chave de API cobre as três formas de acesso, e o agente é uma delas. Use cada uma para o que ela faz de melhor:

O app web para navegar e conferir: filtre lojas na página Lojas, leia anúncios na página Anúncios, acompanhe marcas nos seus monitores de marcas e guarde suas descobertas nos seus quadros.
O agente via MCP para perguntas que exigem várias pesquisas combinadas: varreduras de nicho, análises completas de lojas, briefings de anúncios e resumos semanais do que mudou.
A API REST para tarefas que rodam sempre do mesmo jeito, como uma exportação diária. A documentação da API lista todos os endpoints.

Para ver os dados por trás de cada ferramenta, comece por Lojas, Biblioteca de anúncios, Análise de lojas e Monitor de marcas.

Principais conclusões

O MCP permite que um agente de IA chame ferramentas para obter dados ao vivo, em vez de adivinhar com base no próprio treinamento.
A conexão exige três valores: a URL do endpoint, o transporte HTTP streamable e a sua chave de API em um cabeçalho.
Prompts específicos (nicho, mercado, número de resultados, formato de saída) trazem as melhores respostas e usam menos chamadas.
Uma chamada de ferramenta custa os resultados que retorna, descontados dos seus créditos mensais, compartilhados com a API REST. Consultas de uso, lookups e chamadas com falha são grátis.
Peça as fontes, limite o agente aos resultados das ferramentas e confira os números principais no app web antes de agir.

Como usar um agente de IA para pesquisa de e-commerce com MCP