Dê ao seu agente de IA inteligência de anúncios e lojas
O servidor MCP do SellWinners expõe nossos dados como 73 ferramentas. Aponte qualquer cliente MCP para o endpoint, entre pelo ChatGPT ou pelo Claude ou adicione sua chave de API, e seu agente pode pesquisar anúncios, inspecionar lojas Shopify, pesquisar os produtos delas e puxar criativos sozinho.
- HTTP streamable
- Login para o ChatGPT e o Claude, ou sua chave de API
- Compartilha os créditos do seu plano
# Endpoint https://mcp.sellwinners.com/mcp # Transport streamable HTTP # Auth OAuth sign-in (ChatGPT, Claude) # or X-API-Key: YOUR_API_KEY # or Authorization: Bearer YOUR_API_KEY
Três passos até a primeira chamada do seu agente
Entre ou crie uma chave
Comece grátis e depois entre pelo ChatGPT ou pelo Claude, ou crie uma chave no seu painel. O plano Free também inclui o servidor MCP: 150 créditos por mês, 10 requisições por minuto, os primeiros 10 resultados de cada busca.
Adicione o servidor ao seu cliente
Cole a configuração abaixo no Cursor, no VS Code, no Claude ou em qualquer cliente compatível com MCP remoto.
Pergunte ao seu agente
Experimente «encontre os melhores anúncios em vídeo de tênis de corrida deste mês». Seu agente escolhe sozinho a ferramenta certa.
Configure no seu cliente
O ChatGPT e o Claude usam login; nos outros, substitua YOUR_API_KEY por uma chave do seu painel.
No API key: these sign in with your SellWinners account. O plano Free também inclui o servidor MCP: 150 créditos por mês, 10 requisições por minuto, os primeiros 10 resultados de cada busca. 1. In ChatGPT (an app or a connector in developer mode) or in Claude (Customize → Connectors → Add custom connector; on Team or Enterprise an Owner adds it and you select Connect), add this server URL: https://mcp.sellwinners.com/mcp 2. Choose OAuth if asked. A SellWinners window opens: log in, then select Allow. 3. Ask: "Find the top video ads for running shoes this month". Disconnect any time: Settings → MCP → Connected apps.
// ~/.cursor/mcp.json
{
"mcpServers": {
"sellwinners": {
"url": "https://mcp.sellwinners.com/mcp",
"headers": { "X-API-Key": "YOUR_API_KEY" }
}
}
}
// .vscode/mcp.json
{
"servers": {
"sellwinners": {
"type": "http",
"url": "https://mcp.sellwinners.com/mcp",
"headers": { "X-API-Key": "YOUR_API_KEY" }
}
}
}
// claude_desktop_config.json (needs Node.js; uses the mcp-remote bridge)
{
"mcpServers": {
"sellwinners": {
"command": "npx",
"args": ["-y", "[email protected]", "https://mcp.sellwinners.com/mcp",
"--header", "X-API-Key:YOUR_API_KEY"]
}
}
}
Server URL: https://mcp.sellwinners.com/mcp
Transport: streamable HTTP
Header: X-API-Key: YOUR_API_KEY
(or Authorization: Bearer YOUR_API_KEY)
73 ferramentas, prontas para usar
Abra uma ferramenta para ver os argumentos que ela aceita. Os destacados são obrigatórios.
Descoberta
3 ferramentaslookupConverter um nome de marca, um domínio de loja ou um ID de página do Facebook em IDs que você pode usar com as outras ferramentas
3 argumentos
lookup_filter_idsIDs para os filtros das ferramentas de busca
7 argumentos
list_saved_viewsAs buscas que você salvou nas páginas de lista do site, prontas para as ferramentas de busca
1 argumento
Lojas
17 ferramentassearch_shopsPesquisar ou navegar pelas lojas Shopify
48 argumentos
find_similar_shopsConcorrentes de uma loja (ID ou domínio)
10 argumentos
find_winning_productsProdutos que estão vendendo agora em um nicho
5 argumentos
search_productsPesquisar ou navegar pelos produtos das lojas por preço, vendas, unidades vendidas, países de venda, anúncios, alcance, avaliações, data de lançamento, moeda ou país da loja
37 argumentos
search_products_by_imageEncontrar produtos das lojas parecidos com uma imagem (uma URL de imagem ou o arquivo), com as lojas deles
12 argumentos
search_shops_by_imageEncontre as lojas que vendem o que uma imagem mostra, com os produtos mais parecidos
7 argumentos
get_productUm produto com a ficha completa: fotos, opções e variantes
2 argumentos
get_product_adsOs anúncios da Meta que apontam para a página de um produto
5 argumentos
analyze_productUm produto, seus últimos anúncios e uma leitura dos sinais
3 argumentos
product_launch_radarProdutos lançados recentemente, ordenados por vendas ou pressão publicitária
34 argumentos
create_product_share_linkCriar (ou devolver) o link público de um produto
2 argumentos
delete_product_share_linkRemover o link público de um produto
2 argumentos
brief_competitorUm resumo compacto sobre um concorrente (ID, domínio ou nome da loja)
11 argumentos
shop_reportUm relatório sobre uma loja: o feed, as páginas do Facebook, a temporada do Q4, uma página de destino, o ranking de anúncios ou os testes de criativos
19 argumentos
compare_shopsUm indicador de várias lojas lado a lado
3 argumentos
market_overviewO mercado inteiro, dia a dia, ou ao longo de uma temporada do Q4
5 argumentos
detect_shopify_storeSe uma loja roda na Shopify, o tema dela e os apps da Shopify que ela carrega
1 argumento
Anúncios e mídia
8 ferramentassearch_adsPesquisar anúncios da Meta (Facebook / Instagram) por palavras no texto, na marca ou na página de destino
97 argumentos
scan_adO registro completo de um anúncio da Meta (ou de um anúncio do Google ou de um post do TikTok)
1 argumento
creative_inspiration_packInspiração criativa para um nicho
5 argumentos
search_google_ads_libraryPesquisar anúncios do Google
57 argumentos
search_tiktok_libraryPesquise anúncios e posts orgânicos do TikTok
66 argumentos
create_ad_share_linkCriar (ou retornar) o link público de um anúncio
2 argumentos
delete_ad_share_linkRemover o link público de um anúncio
2 argumentos
write_ad_hooksEscrever três frases curtas de abertura (ganchos) para um anúncio de um produto, para Meta, TikTok ou ambos
7 argumentos
Anunciantes e e-mails
5 ferramentassearch_advertisersPesquisar anunciantes (páginas do Facebook)
26 argumentos
scan_advertiserO registro de um anunciante, ou os anúncios ativos e o alcance dele dia a dia
4 argumentos
search_emailsPesquisar e-mails de marketing das marcas por palavras no assunto, no remetente ou no conteúdo
11 argumentos
get_email_htmlO HTML bruto de um e-mail (use search_emails antes para encontrar o ID)
4 argumentos
analyze_shop_emailsA estratégia de e-mail de uma loja
2 argumentos
Marcas monitoradas
14 ferramentaslist_tracked_brandsAs marcas que você monitora, com os contadores de anúncios ativos
6 argumentos
add_to_brandtrackerComeçar a monitorar uma marca
5 argumentos
delete_from_brandtrackerParar de monitorar uma marca
3 argumentos
list_brandtracker_foldersSuas pastas de monitorescreate_brandtracker_folderCriar uma pasta de monitores
1 argumento
rename_brandtracker_folderRenomear uma pasta de monitores
2 argumentos
delete_brandtracker_folderExcluir uma pasta de monitores
3 argumentos
move_tracked_brandsMover marcas monitoradas para uma pasta (folder_id=null as tira de qualquer pasta)
3 argumentos
get_brand_activityO que uma marca monitorada fez na Meta, no TikTok, no Google e por e-mail
11 argumentos
analyze_tracked_brandUma análise aprofundada de uma marca monitorada
4 argumentos
analyze_brand_changesO que mudou para uma marca monitorada em um período (1d, 7d, 14d, 30d; as posições ganhas são lidas em 7d para 1d, os ganchos em 30d para 14d, e os testes de criativos são os mais recentes)
6 argumentos
get_brandtracker_scaling_adsOs anúncios de uma marca monitorada que mais ganharam posições, com o histórico de posições
32 argumentos
get_brandtracker_transcriptsRoteiros de vídeo de uma marca monitorada, agrupados por texto
9 argumentos
daily_radarResumo diário das suas marcas monitoradas
4 argumentos
Quadros
14 ferramentaslist_boardsSeus quadros
8 argumentos
get_boardUm quadro
1 argumento
create_boardCriar um quadro
6 argumentos
update_boardRenomear um quadro, alterar a descrição ou a visibilidade dele
4 argumentos
move_boardMover um quadro para dentro de um quadro pasta (parent_board_id=null o leva para o nível superior)
2 argumentos
archive_boardArquivar um quadro e tudo o que há dentro dele (restore_board o traz de volta)
2 argumentos
restore_boardRestaurar um quadro arquivado
1 argumento
list_board_itemsOs itens salvos em um quadro
3 argumentos
find_saved_itemsPesquisar tudo o que você salvou, em todos os quadros e nos seus favoritos
13 argumentos
add_board_itemSalvar um item em um quadro de coleção
5 argumentos
move_board_itemMover um item salvo para outro quadro
4 argumentos
remove_board_itemRemover um item salvo de um quadro
3 argumentos
create_board_share_linkCriar um link público para um quadro
2 argumentos
delete_board_share_linkRemover os links públicos de um quadro
2 argumentos
Favoritos
10 ferramentaslist_favoritesSeus anúncios, lojas ou e-mails salvos
6 argumentos
add_favorite_itemSalvar um anúncio, uma loja ou um e-mail
4 argumentos
move_favorite_itemMover um favorito salvo para uma pasta (folder_id=null o tira de qualquer pasta)
4 argumentos
remove_favorite_itemRemover um favorito salvo, pelo próprio ID (favorite_id) ou pelo ID do registro salvo (item_id)
5 argumentos
create_favorite_folderCriar uma pasta de favoritos
4 argumentos
update_favorite_folderRenomear uma pasta de favoritos ou movê-la (move=true com parent_id, null para o nível superior)
6 argumentos
delete_favorite_folderExcluir uma pasta de favoritos
6 argumentos
set_favorite_folder_visibilityTornar uma pasta de favoritos privada ou compartilhada
4 argumentos
create_favorite_folder_share_linkCriar um link público para uma pasta de favoritos
4 argumentos
delete_favorite_folder_share_linkRemover os links públicos de uma pasta de favoritos
4 argumentos
Conta
2 ferramentasusage_getSeu plano, os créditos dele e quantos restamcheck_creditsQuantos créditos você ainda tem neste mês (a mesma resposta de usage_get)usage_get e check_credits não custam nada. O servidor também expõe três recursos: sellwinners://me, sellwinners://usage e sellwinners://openapi.Solução de problemas
- 401, ou o cliente pede que você entre de novo: a chave foi revogada ou digitada errado, ou o login expirou. Crie uma nova chave em Chaves de API ou reconecte o app.
- Uma ferramenta responde insufficient_credits: os créditos deste mês acabaram. A chamada não foi executada e não custou nada; a resposta informa o dia em que os créditos se renovam. Os planos pagos podem adicionar créditos na página de cobrança.
- 403 plan_not_eligible: o plano não inclui esta ferramenta ou o servidor MCP. A resposta indica a funcionalidade; os planos estão na página de preços.
- Uma ferramenta responde rate_limited: é o limite de requisições por minuto, compartilhado pelo espaço de trabalho. A chamada não foi executada e não custou nada; espere os segundos indicados na resposta e tente de novo.
- Um app conectado parou de funcionar: desconecte-o em Configurações, MCP, Apps conectados e depois conecte-o de novo. Uma conexão sem uso por 60 dias termina sozinha.
- Outro problema: escreva para o suporte com o horário da chamada e o nome da ferramenta.