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.4.0 · mayo 2026
Wizard /ads start · coach continuo /ads next · auditoría 0–100 con grade A–F
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
La novedad de v2.4.0 son 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.
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 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.
04 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.
05 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.
06 comandos
15 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.
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.
07 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. Versión actual v2.4.0. Es 100% gratuito, modificable y tuyo para siempre.