AdWhispr
Chatea con los anuncios de Meta (Facebook/Instagram) de cualquier marca dentro de Claude — investiga la biblioteca de anuncios de un competidor, descubre sus anuncios ganadores más longevos, extrae ganchos y formatos, y clona anuncios ganadores para tu propia marca.
Documentación
adwhispr-mcp-server
Investiga los anuncios de cualquier marca, clona los ganadores y lánzalos — desde un chat. Esto conecta Claude (o cualquier cliente MCP) con AdWhispr — el ciclo completo en una sola conversación:
- Investiga la biblioteca de anuncios de un competidor (Meta + TikTok) y descubre sus anuncios ganadores de mayor duración y comprobados
- Clona el creativo ganador — imagen o video — para tu propia marca
- Lánzalo como una campaña real: Google Search y Performance Max (GA), TikTok (GA), Meta (beta)
"Encuentra el anuncio de mayor duración de mi mayor competidor, clónalo para mi marca y lánzalo en TikTok con un presupuesto de $50/día."
Es un puente open-source y ligero hacia el servidor MCP remoto de AdWhispr (https://adwhispr.com/api/mcp). El inicio de sesión ocurre automáticamente a través de tu navegador la primera vez.
Instalación (Claude Desktop) — 3 pasos
npx adwhispr-mcp-server config
- Ejecuta el comando anterior. Añade AdWhispr a tu configuración de Claude Desktop.
- Cierra y vuelve a abrir Claude Desktop por completo.
- Inicia un chat — se abrirá una ventana del navegador una vez para iniciar sesión en AdWhispr. Listo.
Luego prueba:
"Busca en AdWhispr los anuncios de mayor duración de Nike." "¿Qué ganchos está usando Hims en sus anuncios de Meta?" "Clona el mejor anuncio de Cal AI para mi marca en example.com." "Lanza ese clon en Google como campaña de Search, $30/día, en pausa."
Configuración manual
¿Prefieres editar la configuración tú mismo? Añade esto a claude_desktop_config.json:
{
"mcpServers": {
"adwhispr": {
"command": "npx",
"args": ["-y", "adwhispr-mcp-server", "serve"]
}
}
}
Ubicación del archivo de configuración:
- macOS
~/Library/Application Support/Claude/claude_desktop_config.json - Windows
%APPDATA%\Claude\claude_desktop_config.json - Linux
~/.config/Claude/claude_desktop_config.json
Otros clientes MCP
Cualquier cliente MCP que ejecute un comando stdio funciona — apúntalo a npx -y adwhispr-mcp-server serve, o conéctate directamente al endpoint remoto https://adwhispr.com/api/mcp si tu cliente soporta servidores MCP remotos con OAuth (Claude.ai, modo desarrollador de ChatGPT, Cursor, Claude Code).
Herramientas
Investigación — inteligencia de competidores
| Herramienta | Qué hace |
|---|---|
find_competitors | Encuentra marcas verificadas como activamente publicitando ahora mismo en tu nicho, clasificadas por número de anuncios activos — sin adivinanzas. |
search_brands | Encuentra marcas rastreadas en AdWhispr por nombre (devuelve recuentos de anuncios + IDs). |
add_brand | Comienza a rastrear una nueva marca competidora (inicia la ingesta de la biblioteca de anuncios). |
get_brand_ads | Los anuncios de una marca con ganchos, formatos, días en ejecución y enlaces a creativos. |
get_brand_stats | Estadísticas agregadas: recuentos de anuncios, distribuciones de ganchos/formatos, rangos de gasto. |
search_ads | Búsqueda semántica en los anuncios de una marca por concepto ("antes/después", "prueba social"). |
compare_brands | Compara 2–3 marcas lado a lado. |
generate_brief | Brief competitivo para una marca: curva de longevidad, mejores ganchos, mezcla de formatos, veredicto. |
research_tiktok_ads | Investiga los anuncios de TikTok de un competidor (video, miniaturas, fechas de publicación). |
research_keywords | Inteligencia de palabras clave de Google: volumen, competencia, rangos de CPC. |
research_competitor_keywords | Las palabras clave por las que el dominio de un competidor se posiciona y puja. |
get_my_brand / save_my_brand / clear_my_brand | Recuerda tu propio producto/marca para que la investigación y los clones sean personalizados. |
add_product / list_my_products / remove_product | Tu catálogo de productos — impulsa anuncios por producto (importación de Shopify compatible). |
Creativos — clona los ganadores como imagen o video
| Herramienta | Qué hace |
|---|---|
clone_ad | Clona un anuncio ganador de Meta de un competidor para tu marca — una imagen generada real para anuncios de imagen, un video para anuncios de video. |
clone_tiktok_ad | Lo mismo, para un anuncio de TikTok. |
clone_video_ad | Clon completo de anuncio de video con niveles de modelo seleccionables (Seedance / Veo / Kling) — desde borradores baratos hasta finales premium. |
clone_from_script | Genera un anuncio de video a partir de tu propio guion. |
clone_from_concept | Genera un anuncio de video a partir de un concepto o brief en inglés sencillo. |
revise_video_brief | Ajusta la lista de tomas / el brief antes de que se renderice nada. |
approve_video_clone | Aprueba el brief para iniciar el renderizado (el paso de confirmación — no se genera nada hasta que lo hagas). |
check_video_status | Consulta un renderizado de video y obtén el archivo final. |
list_my_creatives | Tus creativos generados, listos para lanzar. |
Lanzamiento y gestión — campañas reales
| Herramienta | Qué hace |
|---|---|
connect_ad_account | Conecta tu cuenta de anuncios de Google, TikTok o Meta con OAuth. |
list_ad_accounts / list_campaigns | Ve qué está conectado y qué está en ejecución. |
launch_search_campaign | Lanza una campaña de Google Search (GA). |
launch_pmax_campaign | Lanza una campaña de Google Performance Max, con activos auto-generados (GA). |
launch_tiktok_campaign | Lanza una campaña de video de TikTok (GA). |
launch_campaign / launch_cloned_ad | Lanza un creativo clonado en un solo paso (la ejecución en Meta está en beta). |
get_account_performance | Rendimiento real desde tu cuenta conectada. |
update_budget / pause_campaign / resume_campaign | Gestiona lo que está activo. |
Las campañas se crean en pausa por defecto con un paso de confirmación explícito antes de que se gaste nada — y los renderizados de video esperan a approve_video_clone, para que no se quemen créditos hasta que des luz verde. AdWhispr nunca inventa métricas de rendimiento — la investigación de competidores solo reporta señales que pueden verificarse (días en ejecución, no ROAS inventado).
Precios
Planes mensuales fijos con una generosa asignación de llamadas — sin facturación por llamada adicional, nunca.
- Gratis — 15 llamadas de agente/mes, marcas rastreadas ilimitadas, 1 clon gratis. Sin tarjeta.
- Pro — $39/mes ($31/mes facturado anualmente): 150 llamadas de agente/mes, 10 clones de imagen + 10 créditos de video/mes, lanzamiento en Google, TikTok y Meta, generación de guiones publicitarios, playbook de competidores, alertas semanales de nuevos anuncios.
- Agencia — $149/mes ($119/mes facturado anualmente): 3,000 llamadas de agente/mes, 50 clones de imagen + 40 créditos de video/mes, asientos de equipo, comparación entre marcas, informes listos para clientes.
La generación de video consume créditos de video (los niveles de borrador cuestan menos, los finales premium más); hay paquetes adicionales de clones y créditos disponibles si te quedas sin.
Límites completos + prueba en adwhispr.com/upgrade.
Cómo funciona
Claude Desktop lanza npx -y adwhispr-mcp-server serve, que ejecuta mcp-remote apuntando a https://adwhispr.com/api/mcp. Eso conecta el transporte stdio local de Claude con el servidor de AdWhispr a través de HTTP y maneja el inicio de sesión OAuth. Tus datos de anuncios y tu cuenta viven en AdWhispr; este paquete no almacena nada.
Para apuntar a un servidor diferente (auto-alojamiento/pruebas), establece ADWHISPR_MCP_URL.
Solución de problemas
AdWhispr no aparece en Claude después de la instalación.
Cierra Claude Desktop por completo (no solo la ventana) y vuelve a abrirlo — la configuración solo se lee al iniciar. Confirma que la entrada existe en claude_desktop_config.json (rutas arriba). En macOS/Linux asegúrate de que npx esté en tu PATH; si Claude no puede encontrarlo, establece command a la ruta absoluta desde which npx.
La ventana de inicio de sesión del navegador nunca se abre, o el inicio de sesión se repite.
La primera llamada a una herramienta abre un navegador para autorizar vía OAuth. Si no aparece, verifica que tu navegador predeterminado pueda abrirse y que ningún firewall esté bloqueando las devoluciones de llamada de localhost. Limpiar la caché de autenticación obsoleta soluciona la mayoría de los bucles:
rm -rf ~/.mcp-auth
Luego reinicia Claude Desktop y vuelve a activar una llamada a una herramienta.
"Se requiere autenticación" o las herramientas devuelven un error de autenticación.
Tu sesión de AdWhispr expiró o no se completó. Vuelve a ejecutar el inicio de sesión (limpia ~/.mcp-auth como arriba), o inicia sesión directamente en adwhispr.com primero, y luego reintenta.
Una herramienta devuelve un mensaje de actualización / fuera de cuota / "clon bloqueado". Eso es esperado en el nivel Gratis (15 llamadas de agente/mes, 1 clon gratis, los créditos de video son solo de planes de pago). El mensaje incluye un enlace de desbloqueo — ábrelo para actualizar o comprar un paquete de créditos. Reenvía el enlace tal cual; el clon se genera y espera detrás de él.
add_brand dice que una marca no se encuentra, o search_brands no devuelve nada.
add_brand resuelve marcas desde la biblioteca pública de anuncios por nombre — prueba con el nombre exacto de la marca tal como aparece en Facebook. Después de añadirla, la ingesta se ejecuta en segundo plano (~40s) antes de que los anuncios sean consultables. search_brands solo devuelve marcas ya rastreadas en tu cuenta.
Una herramienta de lanzamiento dice que una cuenta de anuncios no está conectada.
Ejecuta connect_ad_account primero — devuelve un enlace OAuth para conectar Google, TikTok o Meta. Las campañas se crean en pausa; nada se gasta hasta que confirmes.
Errores de Node / npx al lanzar.
Usa Node 18+ (node --version). Si un paquete antiguo en caché se comporta mal, fuerza una copia nueva: npx -y adwhispr-mcp-server@latest serve.
Conectar un cliente que no sea Claude Desktop.
Apunta cualquier cliente MCP stdio a npx -y adwhispr-mcp-server serve, o conéctate directamente al endpoint remoto https://adwhispr.com/api/mcp si tu cliente soporta servidores MCP remotos con OAuth.
¿Sigue atascado? Abre un issue en github.com/adwhispr/mcp-server/issues o envía un correo a basil@adwhispr.com.
Enlaces
- Sitio web: https://adwhispr.com/connect?ref=mcp_directory
- Plugin de Claude: https://github.com/adwhispr/claude-plugin
- Blog / guías: https://adwhispr.com/blog
- Issues: https://github.com/adwhispr/mcp-server/issues
Licencia
MIT © AdWhispr