01 Qué hace
Cuando lanzas una auditoría, un orquestador reparte el trabajo entre tres agentes especialistas, uno por plataforma, que revisan la cuenta en paralelo con sus propias listas de comprobación. Cada uno devuelve un informe legible y un JSON validado; el orquestador los combina en una nota de salud de 0 a 100 con letra de la A a la F y una lista de arreglos rápidos y problemas críticos ordenados por impacto.
| Plataforma | Comprobaciones | Qué mira |
|---|---|---|
| Google Ads | 80 | Concordancias en búsqueda, Performance Max, AI Max, Demand Gen, CTV y campañas de vídeo de YouTube |
| Meta Ads | 50 | Píxel y API de conversiones, diversidad creativa, Advantage+, estructura de audiencias |
| TikTok Ads | 28 | Enfoque creativo, Smart+, GMV Max, anuncios de búsqueda, Events API |
| Transversal | 3 | Infraestructura de privacidad, diversidad creativa y ritmo de renovación |
02 Instalación
curl -fsSL https://raw.githubusercontent.com/Hainrixz/claude-ads/main/install.sh | bash
# Windows (PowerShell)
# irm https://raw.githubusercontent.com/Hainrixz/claude-ads/main/install.ps1 | iex/plugin marketplace add Hainrixz/claude-adsTras añadir el marketplace, abre /plugin, busca claude-ads en la pestaña de descubrimiento e instálalo; como plugin se actualiza solo. Para comprobar que funciona, escribe /ads start. Si quieres desinstalarlo, el repositorio incluye un script uninstall.sh equivalente al de instalación.
03 Cómo darle tus datos
Funciona sin conectar nada: pegas una exportación, una captura o tus cifras y audita con eso. Para datos en vivo, /ads start te guía por cada plataforma, verifica cada conexión con una llamada de lectura y guarda tu perfil (sector, gasto, objetivo) en ~/.claude-ads/profile.json para no volver a preguntar. Los tokens no se guardan en el perfil: van en variables de entorno.
Modo manual
Exportaciones o cifras pegadas. Sin configuración y válido en cualquier plan.
Conector de Facebook de Claude
Para Meta, el camino más cómodo: conectas Facebook una vez en el catálogo de conectores de Claude y el agente de Meta lo encuentra.
Servidores MCP de la comunidad
Código abierto para Google Ads, TikTok Ads y una alternativa autoalojada para Meta.
Scripts de API directa
En scripts/api/ del repositorio, uno por plataforma, que descargan datos a un JSON que el agente lee después.
export META_ACCESS_TOKEN='tu-token'
python3 scripts/api/meta_fetch.py --account-id act_123456789 -o meta-data.json
# Después, en Claude Code: /ads meta04 Los comandos que importan
| Comando | Para qué |
|---|---|
| /ads start | Asistente inicial: contexto del negocio y conexión de cuentas una a una |
| /ads audit | Auditoría completa con los tres agentes y nota de salud |
| /ads next | Las tres siguientes acciones por impacto, facilidad y reparto de gasto; detecta retrocesos |
| /ads google, /ads meta, /ads tiktok | Auditoría de una sola plataforma |
| /ads creative | Calidad creativa y fatiga de anuncios |
| /ads landing | Revisión de la página de destino orientada a conversión |
| /ads budget | Reparto de presupuesto y estrategia de puja |
| /ads plan tipo | Plan desde plantilla: ecommerce, ecommerce-creative, local-service, real-estate, healthcare, finance, agency o generic |
| /ads math | Calculadora de CPA, ROAS, punto de equilibrio, LTV:CAC y MER |
| /ads test | Diseño de tests A/B con hipótesis, tamaño de muestra y duración |
| /ads report | Informe en PDF para entregar al cliente |
| /ads update | Actualiza las referencias de cada plataforma con los cambios recientes |
05 Una rutina semanal con prompts
/ads audit
Contexto: invierto unos [importe] € al mes, repartidos así: [Meta X % / Google Y % / TikTok Z %]. Mi objetivo este trimestre es [leads / ventas / reservas] con un coste por resultado objetivo de [importe] €. Vendo en [país o región].
Quiero: nota global y por plataforma, los cinco problemas críticos con tiempo estimado de arreglo, los arreglos rápidos de menos de una hora y cualquier aviso de cumplimiento (consentimiento de cookies, categorías especiales de anuncios). Expresa los importes en euros./ads plan [plantilla]
Negocio: [descripción en dos líneas]. Mercado: España, [ciudades o provincias]. Presupuesto mensual: [importe] €. Objetivo: [objetivo]. Plataformas: [cuáles].
Entrégame estructura de campañas, audiencias y exclusiones, reparto del presupuesto razonado, indicadores objetivo y los requisitos legales o de política publicitaria que apliquen a mi sector.-
1
Lunes
Lanza /ads audit o la auditoría de la plataforma con más gasto.
-
2
Justo después
Ejecuta /ads next y aplica la primera acción de la lista.
-
3
A mitad de semana
Revisa creatividades con /ads creative si alguna campaña muestra fatiga.
-
4
Fin de mes
Genera /ads report para el cliente y compara con /ads next compare.
Preguntas frecuentes
Está planteado como herramienta de auditoría y estrategia. Algunos servidores MCP permiten escribir en la cuenta, pero no está activado por defecto y conviene mantenerlo así hasta confiar en el flujo.
El skill corre dentro de tu sesión local de Claude Code y no envía datos de tus cuentas a servidores del autor. El comando de actualización sí consulta fuentes públicas en internet, pero sin incluir tus datos.
Sí, pero indícale tu gasto mensual desde el principio. Los criterios y las referencias cambian mucho entre una cuenta de 500 € y una de 50.000 € al mes.
Con /ads start reset, que pide confirmación, o editando a mano ~/.claude-ads/profile.json. Para cambiar solo algo concreto usa /ads start edit.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.