AdWhispr
Converse com os anúncios do Meta (Facebook/Instagram) de qualquer marca dentro do Claude — pesquise a biblioteca de anúncios de um concorrente, descubra seus anúncios de maior duração, extraia ganchos/formatos e clone anúncios vencedores para sua própria marca.
Documentação
adwhispr-mcp-server
Pesquise os anúncios de qualquer marca, clone os vencedores e publique-os — direto do chat. Isso conecta o Claude (ou qualquer cliente MCP) ao AdWhispr — o ciclo completo em uma única conversa:
- Pesquise a biblioteca de anúncios de um concorrente (Meta + TikTok) e descubra os anúncios de maior duração e comprovadamente vencedores
- Clone o criativo vencedor — imagem ou vídeo — para a sua própria marca
- Publique como uma campanha real: Google Search e Performance Max (GA), TikTok (GA), Meta (beta)
"Encontre o anúncio de maior duração do meu maior concorrente, clone para a minha marca e publique no TikTok com orçamento de US$ 50/dia."
É uma ponte leve e de código aberto para o servidor MCP remoto do AdWhispr (https://adwhispr.com/api/mcp). O login acontece automaticamente pelo seu navegador na primeira vez.
Instalação (Claude Desktop) — 3 passos
npx adwhispr-mcp-server config
- Execute o comando acima. Ele adiciona o AdWhispr à configuração do seu Claude Desktop.
- Feche e reabra completamente o Claude Desktop.
- Inicie um chat — uma janela do navegador abre uma vez para você entrar no AdWhispr. Pronto.
Depois, experimente:
"Pesquise no AdWhispr os anúncios de maior duração da Nike." "Quais ganchos o Hims está usando nos anúncios de Meta?" "Clone o melhor anúncio do Cal AI para a minha marca em example.com." "Publique esse clone no Google como campanha de Search, US$ 30/dia, pausada."
Configuração manual
Prefere editar a configuração você mesmo? Adicione isto a claude_desktop_config.json:
{
"mcpServers": {
"adwhispr": {
"command": "npx",
"args": ["-y", "adwhispr-mcp-server", "serve"]
}
}
}
Local do arquivo de configuração:
- macOS
~/Library/Application Support/Claude/claude_desktop_config.json - Windows
%APPDATA%\Claude\claude_desktop_config.json - Linux
~/.config/Claude/claude_desktop_config.json
Outros clientes MCP
Qualquer cliente MCP que execute um comando stdio funciona — aponte-o para npx -y adwhispr-mcp-server serve, ou conecte-se diretamente ao endpoint remoto https://adwhispr.com/api/mcp se o seu cliente suportar servidores MCP remotos com OAuth (Claude.ai, modo desenvolvedor do ChatGPT, Cursor, Claude Code).
Ferramentas
Pesquisa — inteligência de concorrentes
| Ferramenta | O que faz |
|---|---|
find_competitors | Encontre marcas comprovadamente anunciando ativamente agora no seu nicho, classificadas por quantidade de anúncios ativos — sem adivinhação. |
search_brands | Encontre marcas rastreadas no AdWhispr pelo nome (retorna contagens de anúncios + IDs). |
add_brand | Comece a rastrear uma nova marca concorrente (inicia a ingestão da biblioteca de anúncios). |
get_brand_ads | Os anúncios de uma marca com ganchos, formatos, dias de veiculação e links dos criativos. |
get_brand_stats | Estatísticas agregadas: contagens de anúncios, distribuições de ganchos/formatos, faixas de gasto. |
search_ads | Busca semântica nos anúncios de uma marca por conceito ("antes/depois", "prova social"). |
compare_brands | Compare 2–3 marcas lado a lado. |
generate_brief | Briefing competitivo para uma marca: curva de longevidade, principais ganchos, mix de formatos, veredito. |
research_tiktok_ads | Pesquise os anúncios de TikTok de um concorrente (vídeo, miniaturas, datas de veiculação). |
research_keywords | Inteligência de palavras-chave do Google: volume, concorrência, faixas de CPC. |
research_competitor_keywords | As palavras-chave pelas quais o domínio de um concorrente é classificado e faz lances. |
get_my_brand / save_my_brand / clear_my_brand | Registre seu próprio produto/marca para que pesquisas e clones sejam personalizados. |
add_product / list_my_products / remove_product | Seu catálogo de produtos — alimenta anúncios por produto (importação do Shopify compatível). |
Criativo — clone os vencedores como imagem ou vídeo
| Ferramenta | O que faz |
|---|---|
clone_ad | Clone um anúncio vencedor da Meta de um concorrente para a sua marca — uma imagem real gerada para anúncios de imagem, um vídeo para anúncios de vídeo. |
clone_tiktok_ad | O mesmo, para um anúncio do TikTok. |
clone_video_ad | Clone completo de anúncio em vídeo com níveis de modelo selecionáveis (Seedance / Veo / Kling) — de rascunhos baratos a finais premium. |
clone_from_script | Gere um anúncio em vídeo a partir do seu próprio roteiro. |
clone_from_concept | Gere um anúncio em vídeo a partir de um conceito ou briefing em linguagem simples. |
revise_video_brief | Ajuste a lista de cenas / briefing antes de qualquer renderização. |
approve_video_clone | Aprove o briefing para iniciar a renderização (a etapa de confirmação — nada é gerado até você fazer isso). |
check_video_status | Consulte a renderização de um vídeo e receba o arquivo finalizado. |
list_my_creatives | Seus criativos gerados, prontos para publicar. |
Publicação e gerenciamento — campanhas reais
| Ferramenta | O que faz |
|---|---|
connect_ad_account | Conecte sua conta de anúncios do Google, TikTok ou Meta via OAuth. |
list_ad_accounts / list_campaigns | Veja o que está conectado e o que está em execução. |
launch_search_campaign | Publique uma campanha do Google Search (GA). |
launch_pmax_campaign | Publique uma campanha do Google Performance Max, com ativos gerados automaticamente (GA). |
launch_tiktok_campaign | Publique uma campanha de vídeo no TikTok (GA). |
launch_campaign / launch_cloned_ad | Publique um criativo clonado em uma única etapa (execução na Meta é beta). |
get_account_performance | Desempenho real da sua conta conectada. |
update_budget / pause_campaign / resume_campaign | Gerencie o que está ativo. |
As campanhas são criadas pausadas por padrão, com uma etapa explícita de confirmação antes de qualquer gasto — e as renderizações de vídeo aguardam approve_video_clone, então nenhum crédito é consumido até você autorizar. O AdWhispr nunca fabrica métricas de desempenho — a pesquisa de concorrentes relata apenas sinais verificáveis (dias de veiculação, não ROAS inventado).
Preços
Planos mensais fixos com uma generosa cota de chamadas — sem cobrança adicional por chamada, nunca.
- Grátis — 15 chamadas de agente/mês, marcas rastreadas ilimitadas, 1 clone grátis. Sem cartão.
- Pro — US$ 39/mês (US$ 31/mês na cobrança anual): 150 chamadas de agente/mês, 10 clones de imagem + 10 créditos de vídeo/mês, publicação no Google, TikTok e Meta, geração de roteiros de anúncios, playbook de concorrentes, alertas semanais de novos anúncios.
- Agência — US$ 149/mês (US$ 119/mês na cobrança anual): 3.000 chamadas de agente/mês, 50 clones de imagem + 40 créditos de vídeo/mês, assentos para equipe, comparação entre marcas, relatórios prontos para clientes.
A geração de vídeos consome créditos de vídeo (os níveis de rascunho custam menos, os finais premium custam mais); pacotes extras de clones e créditos estão disponíveis caso você fique sem.
Limites completos e teste gratuito em adwhispr.com/upgrade.
Como funciona
O Claude Desktop inicia o npx -y adwhispr-mcp-server serve, que executa mcp-remote apontando para https://adwhispr.com/api/mcp. Isso faz a ponte entre o transporte stdio local do Claude e o servidor AdWhispr via HTTP, além de gerenciar o login OAuth. Seus dados de anúncios e conta ficam no AdWhispr; este pacote não armazena nada.
Para apontar para um servidor diferente (self-hosting/testes), defina ADWHISPR_MCP_URL.
Solução de problemas
O AdWhispr não aparece no Claude após a instalação.
Feche completamente o Claude Desktop (não apenas a janela) e reabra — a configuração só é lida na inicialização. Confirme se a entrada existe em claude_desktop_config.json (caminhos acima). No macOS/Linux, verifique se npx está no seu PATH; se o Claude não conseguir encontrá-lo, defina o command para o caminho absoluto de which npx.
A janela de login do navegador nunca abre, ou o login fica em loop.
A primeira chamada de ferramenta abre um navegador para autorizar via OAuth. Se não aparecer, verifique se o seu navegador padrão consegue abrir e se nenhum firewall está bloqueando callbacks de localhost. Limpar o cache de autenticação antigo resolve a maioria dos loops:
rm -rf ~/.mcp-auth
Depois reinicie o Claude Desktop e acione uma chamada de ferramenta novamente.
"Authentication required" ou ferramentas retornam erro de autenticação.
Sua sessão do AdWhispr expirou ou não foi concluída. Execute o login novamente (limpe ~/.mcp-auth como acima), ou entre diretamente em adwhispr.com primeiro e tente novamente.
Uma ferramenta retorna mensagem de upgrade / fora da cota / "clone bloqueado". Isso é esperado no plano Grátis (15 chamadas de agente/mês, 1 clone grátis, créditos de vídeo são apenas para planos pagos). A mensagem inclui um link de desbloqueio — abra-o para fazer upgrade ou comprar um pacote de créditos. Repasse o link como está; o clone já está gerado e esperando atrás dele.
add_brand diz que uma marca não foi encontrada, ou o search_brands não retorna nada.
O add_brand resolve marcas da biblioteca pública de anúncios pelo nome — tente o nome exato da marca como aparece no Facebook. Após adicionar, a ingestão é executada em segundo plano (~40s) antes que os anúncios possam ser consultados. O search_brands só retorna marcas já rastreadas na sua conta.
Uma ferramenta de publicação diz que a conta de anúncios não está conectada.
Execute connect_ad_account primeiro — ele retorna um link OAuth para conectar Google, TikTok ou Meta. As campanhas são criadas pausadas; nada é gasto até você confirmar.
Erros de Node / npx ao publicar.
Use Node 18+ (node --version). Se um pacote antigo em cache estiver causando problemas, force uma cópia nova: npx -y adwhispr-mcp-server@latest serve.
Conectando um cliente que não seja Claude Desktop.
Aponte qualquer cliente MCP stdio para npx -y adwhispr-mcp-server serve, ou conecte-se diretamente ao endpoint remoto https://adwhispr.com/api/mcp se o seu cliente suportar servidores MCP remotos com OAuth.
Ainda com problemas? Abra uma issue em github.com/adwhispr/mcp-server/issues ou envie um e-mail para basil@adwhispr.com.
Links
- Site: https://adwhispr.com/connect?ref=mcp_directory
- Plugin Claude: https://github.com/adwhispr/claude-plugin
- Blog / guias: https://adwhispr.com/blog
- Issues: https://github.com/adwhispr/mcp-server/issues
Licença
MIT © AdWhispr