Claude Ads
La skill open-source de Claude Code que convierte tu terminal en un estratega senior de paid media para Meta, Google y TikTok. 3 agentes en paralelo, 161 checks ponderados por severidad y un Ads Health Score 0–100. Mantenida por tododeia.
Skill oficial · v2.5.0 · octubre 2026
Wizard /ads start · coach /ads next · conciencia de campaña · auditoría 0–100
Esta guía es el resumen humano del repo. Si solo quieres empezar, salta directo al wizard. Si quieres entender qué hace antes de instalar, empieza por el concepto.
01 concepto
Un especialista de paid media en tu terminal
Claude Ads no es un chatbot que te suelta consejos genéricos. Es un orquestador que despacha 3 agentes deep-specialist en paralelo — audit-google, audit-meta y audit-tiktok — cada uno con su propio checklist, sus referencias cargadas on-demand y sus pesos de severidad. Cada agente devuelve Markdown legible más un JSON validado contra un schema, y el orquestador los fusiona en un único Ads Health Score 0–100.
Ads Health Score
Un solo número 0–100 + grade A–F que resume la salud de tu cuenta, con sub-scores por plataforma para ver dónde estás sangrando.
161 checks
80 Google + 50 Meta + 28 TikTok + 3 cross-plataforma. Cada uno ponderado por severidad (crítico, alto, medio) y por impacto sobre tu spend mix.
3 agentes en paralelo
La auditoría completa corre las tres plataformas al mismo tiempo, no en secuencia. El reporte llega en una sola pasada.
Cómo se reparten los 161 checks
audit-google80 checks— Search, PMax, AI Max, Demand Gen, CTV, YouTube video.audit-meta50 checks— FB, IG, Advantage+. MCP-wired a claude.ai Facebook.audit-tiktok28 checks— Smart+, Shop, Symphony, GMV Max, Events API.cross-platform3 checks— privacy infra · diversidad creativa · cadencia de refresh.
Escala de grado
A
90–100
Solo optimizaciones menores.
B
75–89
Hay oportunidades de mejora.
C
60–74
Issues notables que requieren atención.
D
40–59
Problemas significativos presentes.
F
<40
Intervención urgente.
La idea es simple
En vez de pagar una agencia o pasar horas revisando dashboards, instalas la skill y Claude se convierte en tu especialista. Audita, te dice qué está mal por orden de impacto, te ayuda a planear nuevas campañas, revisa tus creativos, analiza a la competencia y optimiza tu presupuesto — todo desde la terminal, todo open source.
02 onboarding
De instalación fría a primera auditoría en 90 segundos
Hay dos comandos que cambian cómo se usa la skill: /ads start (un wizard de primera vez que te lleva de cero hasta un pipeline de auditoría funcional) y /ads next (un coach continuo que después de cada auditoría te dice exactamente qué arreglar siguiente).
La idea es que no tienes que leer documentación para arrancar. Instalas, escribes /ads start, contestas tres preguntas, conectas tus cuentas y ya estás listo para tu primer /ads audit.
Qué hace /ads start
1. Contexto de tu negocio
Tu industria, gasto mensual aproximado, objetivo principal (leads, ventas, tráfico, instalaciones).
2. OAuth plataforma por plataforma
Te lleva paso a paso por Meta, Google y TikTok — una a la vez. Después de cada conexión hace una llamada de verificación en vivo para confirmar que funciona.
3. Cuentas opcionales
Te ofrece (sin obligarte) crear cuenta en Meta for Developers para token propio y en Zernio si quieres publicar creativos desde /ads publish.
4. Perfil persistente
Todo queda guardado en ~/.claude-ads/profile.json. Ningún /ads futuro te lo vuelve a preguntar.
Al final te sugiere tu siguiente comando — normalmente /ads audit. Si necesitas cambiar algo después, corre /ads start edit o reinicia con /ads start reset.
Qué agrega /ads next
Después de cada auditoría, /ads next lee el JSON del resultado más reciente más tu historial guardado en ~/.claude-ads/history/ y ranquea cada quick win y critical issue por impacto × facilidad × tu mix de gasto. Te devuelve un top 3 punch list — siempre sabes la siguiente acción.
La memoria entre sesiones también detecta regresiones: si tu salud Meta cayó de 78 a 71 desde la última auditoría, eso se marca como Prioridad 0 por encima del top 3 regular.
Si registraste campañas con /ads conciencia, el coach también pone en la lista lo que pasa del lado del negocio: una campaña que trae muchos mensajes y pocos cierres, una que se llenó de basura o una a la que nunca le contaste cómo le fue.
Ejemplo de salida — /ads next
Next actions (rankeadas por impacto × facilidad para tu $6,000/mes en Meta, Google, TikTok):
1. [meta · M02 · crítico] Conversions API no desplegada
Hallazgo: 30–40% de pérdida de datos (EMQ 4.1 actual).
Recomendación: Desplegá CAPI server-side junto al Pixel.
Tiempo: 90 min · Impacto: 92
Referencia: setup-meta.md (sección CAPI)
2. [google · G43 · alto] Enhanced Conversions deshabilitado
...
3. [tiktok · T07 · alto] Spark Ads no activados
...03 conciencia
¿La campaña te trajo clientes o solo mensajes?
Meta te dice que llegaron 55 mensajes a WhatsApp. Lo que no te dice es cuántos de esos compraron, cuántos preguntaron el precio y desaparecieron, y cuántos eran spam. Eso solo lo sabes tú, y una auditoría que solo mira la plataforma puede darte un costo por lead precioso en una campaña que no cierra nada.
/ads conciencia llena ese hueco. Claude guarda lo que le cuentas de tus resultados reales, te vuelve a preguntar cada cierto tiempo y lo cruza con los números de la plataforma. Sirve para campañas de mensajes, formularios y llamadas. Si vendes en línea con píxel de compra no lo necesitas, porque la plataforma ya ve la venta.
Cómo funciona
1. Registras la campaña
Le dices cuál es, por dónde cierras (WhatsApp, Messenger, DM, formulario o llamada), cuánto vale un cliente si lo sabes y cada cuántos días quieres que te pregunte. Por defecto, cada 7.
2. Claude te pregunta cuando toca
Cada vez que abres /ads y hay un check-in vencido, te hace todas las preguntas en un solo mensaje. Si no es buen momento, le dices que luego y te vuelve a preguntar mañana.
3. Cruza tu respuesta con la plataforma
Saca gasto, clics y mensajes del mismo periodo (por MCP, API o un export) y los pone junto a lo que tú reportaste.
4. Te deja el resultado por escrito
Un conciencia-de-campana.md en tu carpeta con dos listas: lo que sabe y lo que no sabe. Cada cifra dice de cuántos check-ins sale.
Lo que te calcula
- Tasa de cierre: clientes cerrados entre conversaciones reales
- Costo por cliente cerrado, no por mensaje
- Porcentaje de contactos basura (spam, fuera de zona, no contestan)
- Mensajes que cuenta la plataforma contra conversaciones que de verdad llegaron
- ROAS real si le diste el ingreso, o estimado si le diste el valor de un cliente
- Tendencia contra el check-in anterior
Lo que no inventa
Lo que no le contestes queda como N/A, nunca como cero. Una tasa solo se calcula con los check-ins donde tienes los dos lados, y siempre dice de cuántos sale.
Cuando ya hay datos, /ads audit pone la tasa de cierre, el costo por cliente y la basura junto al costo por lead. Si no hay, el resultado de negocio sale como N/A y te ofrece registrar la campaña.
Los cuatro subcomandos
/ads conciencia registrarda de alta una o varias campañas./ads conciencia checkincontesta los check-ins pendientes./ads conciencia verte enseña el cruce sin hacerte preguntas./ads conciencia listate da la tabla de todas tus campañas registradas.
Todo se guarda en tu máquina, en ~/.claude-ads/conciencia/, un archivo por campaña.
Registrar tu primera campaña de WhatsApp
Después de tu primera auditoría. Claude toma las campañas que encontró y te pregunta lo que le falte.
/ads conciencia registrar Quiero registrar mi campaña [nombre] de [Meta / Google / TikTok]. Cierro las ventas por [WhatsApp / formulario / llamada]. Un cliente me deja en promedio [monto y moneda], si no lo sé déjalo vacío. Pregúntame cada [7] días. Si la campaña ya lleva más de una semana corriendo, hazme el primer check-in ahora.
04 plataformas
3 plataformas, 161 checks, un solo skill
v2.3.0 fue el cambio de foco: la skill bajó de 7 plataformas a las 3 con la mejor cobertura de MCP y API en vivo — Meta, Google y TikTok. YouTube ya vive dentro de /ads google porque las campañas de video se manejan desde Google Ads. Apple, LinkedIn y Microsoft quedaron fuera por falta de MCP libres y por menor volumen entre los anunciantes que la usan.
Meta Ads
50 checksaudit-metaFacebook + Instagram + Advantage+ Shopping · pixel/CAPI · diversidad creativa Andromeda · MCP-wired a claude.ai Facebook.
Google Ads
80 checksaudit-googleSearch · Performance Max · AI Max · Demand Gen · CTV · incluye YouTube video campaigns dentro del mismo /ads google.
TikTok Ads
28 checksaudit-tiktokSmart+ · GMV Max · Search Ads · TikTok Shop · Symphony · Events API · creative-first y nativo de la plataforma.
8 plantillas por industria para /ads plan <tipo>
Cuando corres /ads plan ecommerce (o cualquier otra), Claude carga la plantilla correspondiente con sus benchmarks, su estructura de campañas, su targeting y sus disclosures regulatorios. Si tu industria no encaja en ninguna, /ads plan generic arranca un cuestionario universal.
ecommerceDTC / ecom · Shopping / PMax · ROAS-driven · estacional.
ecommerce-creativeEcom con testing creativo agresivo.
local-servicePlomeros, dentistas, agencias locales · Search + LSA · call tracking.
real-estateInmobiliarias · Special Ad Category (housing) · campañas comprador/vendedor.
healthcareClínicas y salud · HIPAA · LegitScript · targeting restringido.
financeFintech y créditos · Special Ad Category · disclosures requeridos.
agencyManejo multi-cliente · framework de reporting.
genericCuestionario universal cuando ninguna otra encaja.
05 instalación
Instalar Claude Ads
La forma recomendada es como plugin nativo de Claude Code — se registra en tu marketplace y se actualiza solo cuando sale una nueva versión. Si tu setup no soporta plugins todavía, hay un script de instalación clásico que funciona igual.
Recomendado · plugin marketplace
Dos comandos dentro de Claude Code. El primero agrega el marketplace de tododeia y el segundo instala la skill como plugin con auto-update.
Registrar el marketplace
/plugin marketplace add Hainrixz/claude-adsInstalar el plugin
/plugin install claude-ads@tododeia-claude-adsAlternativa · script en una línea
Si prefieres el método de toda la vida — un curl o un irm que clona la skill en tu carpeta de Claude Code. Mismo resultado, sin auto-update.
macOS / Linux
curl -fsSL https://raw.githubusercontent.com/Hainrixz/claude-ads/main/install.sh | bashWindows (PowerShell)
irm https://raw.githubusercontent.com/Hainrixz/claude-ads/main/install.ps1 | iexVerificar la instalación
Abre Claude Code y escribe /ads start. Si Claude arranca el wizard pidiéndote industria y gasto mensual, la skill está lista. Si no, revisa que el plugin esté habilitado con /plugin list.
Requisito previo
Necesitas tener Claude Code instalado. Si todavía no lo tienes, pasa primero por Instalar Claude Code — es la guía de 5 minutos para dejar la terminal lista.
06 conectar
Conecta tus cuentas — tres caminos, dos gratis
La skill audita igual si le pegas data manualmente, pero el verdadero poder llega cuando le das acceso directo a tus cuentas de Meta, Google y TikTok. Hay tres caminos para hacerlo — dos completamente gratis y uno opcional con costo, solo si quieres publicar creativos desde /ads publish.
Capa 1 · MCP de la comunidad (gratis)
gratisServidores MCP open-source para cada plataforma. claude.ai Facebook es el camino más fácil porque la OAuth la maneja claude.ai por ti — solo conéctalo una vez en tu catálogo de MCP.
- Meta — claude.ai Facebook MCP (cableado directo al agente audit-meta)
- Google — cohnen/mcp-google-ads
- TikTok — AdsMCP/tiktok-ads-mcp-server
Capa 1 · Adaptadores directos a la API (gratis)
gratisScripts en scripts/api/ que llaman a la Marketing API oficial de cada plataforma. OAuth una sola vez por plataforma y luego $0 para siempre.
- Meta — token de acceso de Meta Business + Ad Account ID · 5 minutos de setup
- Google — Developer Token + OAuth 2.0 + Customer ID · 1 a 3 días hábiles de aprobación
- TikTok — token de TikTok for Business + Advertiser ID
Capa 3 · Zernio (opcional, solo para /ads publish)
opcional · pagaSolo si quieres que Claude publique creativos directamente a tus redes desde /ads publish. La auditoría completa funciona sin esto. Las primeras 2 cuentas conectadas son gratis para siempre.
- ZERNIO_API_KEY en tu .env
- Agencias pagan $1–$6/mes por cuenta extra a partir de la tercera
Pídele a Claude que te guíe por las credenciales
Si no quieres leer la documentación de cada plataforma, este prompt hace que Claude te lleve paso a paso. Funciona junto con el wizard de /ads start.
Tengo el skill Claude Ads instalado y ya corrí /ads start. Quiero conectar mis cuentas con la API directa para tener datos en vivo. Mis plataformas activas son: [Meta / Google / TikTok]. Para cada plataforma: 1. Dime exactamente qué credenciales necesito generar y dónde sacarlas (URLs específicas). 2. Llévame paso a paso por el OAuth. 3. Verifica con una llamada de lectura que las credenciales funcionan antes de seguir con la siguiente plataforma. 4. Guarda todo en mi perfil de ~/.claude-ads/profile.json una vez verificado.
Empieza en read-only
Modo live significa que Claude puede leer — y con algunos MCP, también escribir — en tus cuentas reales. Arranca en read-only, apunta a un sandbox o a una cuenta de bajo gasto primero, y solo habilita escritura después de un par de corridas limpias. La auditoría completa nunca necesita permisos de escritura.
07 comandos
16 comandos agrupados por intención
Cada comando activa un modo especializado de Claude. La mayor parte del tiempo solo vas a usar tres — /ads start una vez, /ads audit semanal o quincenal y /ads next después de cada auditoría. El resto está disponible para zoom-in cuando lo necesites.
Flujo principal
El camino feliz: wizard una vez, auditoría completa, coach que te dice qué hacer después.
/ads startWizard de primera vez — captura industria, gasto y objetivo. Walkthrough OAuth/MCP por plataforma con verificación en vivo. Guarda tu perfil en ~/.claude-ads/profile.json.
/ads auditAuditoría multi-plataforma con 3 agentes en paralelo. Devuelve Ads Health Score 0–100, breakdown por plataforma y lista priorizada de quick wins + critical issues.
/ads nextCoach continuo. Ranquea las 3 acciones siguientes por impacto × facilidad × tu mix de gasto. Detecta regresiones desde la última auditoría.
/ads concienciaPara campañas de WhatsApp, formulario o llamadas. Te pregunta cada tanto cuántos clientes cerraste y cuántos contactos fueron basura, y lo cruza con lo que ve la plataforma para darte la tasa de cierre real y el costo por cliente.
Especialistas por plataforma
Si quieres profundizar en una sola plataforma sin correr la auditoría completa.
/ads googleAuditoría Google Ads — 80 checks. Search, PMax, Demand Gen, CTV, YouTube video campaigns.
/ads metaAuditoría Meta Ads — 50 checks. FB / IG / Advantage+. Cableado al MCP de claude.ai Facebook.
/ads tiktokAuditoría TikTok Ads — 28 checks. Smart+, Shop, Symphony, GMV Max.
Utilidades transversales
Análisis cross-plataforma, calculadora PPC y reportes para clientes.
/ads creativeAuditoría de calidad creativa + detección de fatiga en todas las plataformas.
/ads landingRevisión de landing pages enfocada en conversión.
/ads budgetRevisión de asignación de presupuesto + estrategia de bidding.
/ads competitorInteligencia de anuncios de competidores entre todas las plataformas conectadas.
/ads plan <tipo>Plan estratégico desde 8 plantillas por industria — ecommerce, local-service, real-estate, healthcare, finance, agency, generic.
/ads mathCalculadora PPC: CPA, ROAS, break-even, LTV:CAC, MER.
/ads testDiseño de A/B test con hipótesis, sample size y duración.
/ads reportReporte PDF de auditoría para entregar a clientes.
/ads update <plataforma|all>Refresca las referencias internas con cambios de los últimos 30 días en Google, Meta y TikTok.
Publicación
Salir del read-only y empujar creativos a tus redes — vía Zernio.
/ads publishPublica creativos a tus cuentas conectadas vía Zernio. Las primeras 2 cuentas son gratis para siempre; agencias pagan $1–$6/mes por cuenta extra.
Sub-comandos útiles
/ads next show— top 10 sin prompts de walkthrough, solo la lista./ads next compare— diff completo entre tus dos últimas auditorías./ads start edit— vuelve a correr el wizard para cambiar industria o conexiones./ads publish --dry-run— planea la publicación sin publicar nada.
08 en la práctica
Prompts para empezar hoy
Estos prompts son la base de una rutina de auditoría semanal. Cópialos, ajusta los detalles entre corchetes con la realidad de tu negocio y ejecútalos en Claude Code una vez que ya corriste /ads start.
Primera auditoría completa multi-plataforma
Dispara los 3 agentes en paralelo y pídele a Claude que te entregue el reporte priorizado por impacto en gasto.
/ads audit Mi gasto mensual aproximado es: $[cantidad] repartido en [Meta / Google / TikTok]. Mi objetivo principal del trimestre es: [conversiones / leads / ventas / tráfico]. Quiero recibir: 1. Mi Ads Health Score general y el grade A–F. 2. Sub-scores por plataforma para identificar dónde estoy sangrando. 3. Los 5 critical issues más urgentes con tiempo estimado de fix. 4. Los quick wins que pueda implementar hoy en menos de una hora cada uno. 5. Cualquier compliance flag (Special Ad Categories, Consent Mode V2) que aparezca. Cuando termines, recordame correr /ads next para que me priorices el top 3 según mi mix de gasto.
Plan estratégico desde plantilla por industria
Para arrancar una nueva campaña o entrar a una nueva plataforma. Claude carga la plantilla, te hace las preguntas que faltan y entrega el plan completo.
/ads plan [ecommerce / ecommerce-creative / local-service / real-estate / healthcare / finance / agency / generic] Producto o servicio: [descripción breve en 1–2 líneas]. Mercado: [país o región]. Presupuesto mensual disponible: $[cantidad]. Objetivo principal: [leads / ventas / instalaciones / awareness]. Plataformas donde quiero arrancar: [Meta / Google / TikTok / todas]. Entregable: 1. Estructura de campañas recomendada por plataforma. 2. Audiencias y exclusiones específicas para esta industria. 3. Reparto de presupuesto por plataforma con razones. 4. KPIs objetivo con benchmarks de la industria. 5. Disclosures regulatorios obligatorios si aplica.
Inteligencia de competencia cross-plataforma
Cuando quieres entender qué están haciendo tus 3 competidores principales antes de planear creativos o ajustar bidding.
/ads competitor Mis competidores principales son: [competidor 1], [competidor 2], [competidor 3]. Mi industria es: [industria]. Mis plataformas activas son: [Meta / Google / TikTok]. Para cada competidor: 1. Tipos de anuncios activos y volumen estimado. 2. Ángulos creativos y mensajes principales que usan. 3. Audiencias y geos donde están pujando. 4. Patrones de creatives (formato, duración, hooks). Cierra con 3 oportunidades concretas donde pueda diferenciarme o superar su posicionamiento.
Más skills de Claude Code
Claude Ads es una pieza del stack. Si quieres explorar más habilidades o crear las tuyas, pasa por Crea Claude Skills o Agencia Digital Completa para una colección de 900+ habilidades listas.
Guía de la comunidad
Claude Ads es la skill open-source de tododeia para correr una agencia de paid media dentro de Claude Code. Esta guía vive en la bóveda de tododeia, junto a otros recursos libres para construir con IA.
Claude Meta Ads
Conectar Meta sin que te banee la cuenta
Claude Copywriter
Copy de anuncios antes de subirlos
29 Skills de Marketing
El stack completo más allá de paid
¿En qué etapa estás hoy?
Si recién instalaste la skill, arranca por /ads start y deja que el wizard te conecte Meta, Google y TikTok una a la vez. Si ya corriste tu primera /ads audit, pasa a /ads next y arregla el top 3 de la semana. Si ya manejas campañas activas con Claude, agenda /ads update all una vez al mes off-peak para refrescar las referencias.
Proyecto open source de tododeia
Claude Ads es nuestro proyecto open-source, mantenido por tododeia.com con licencia MIT. Parte del original de AgriciDaniel y hoy lo mantiene Enrique Rocha. Versión actual v2.5.0. Es 100% gratuito, modificable y tuyo para siempre.
Guía gratis
Únete a la comunidad
Crea tu cuenta gratis con tu correo y la guía se abre aquí mismo. Te sirve para todas las guías. Si el código no te llega, revisa spam o Promociones.