Claude Ads
Skill de código abierto para operaciones de medios pagados con agentes: auditorías con evidencia, planes y cambios de cuenta en borrador en doce plataformas publicitarias
Claude Ads es un paquete de skills con licencia MIT que convierte Claude Code —o Codex, Gemini, Cursor y otros hosts de Agent Skills— en un operador de medios pagados en doce plataformas publicitarias. Lee exportaciones o lecturas de API autorizadas de la cuenta y devuelve auditorías respaldadas por evidencia, planes de medios, briefs creativos, pasadas de monitorización e informes JSON versionados. Todos los adaptadores son de solo lectura por defecto: aplicar un cambio exige una capacidad habilitada, un diff explícito de antes y después, aprobación del propietario dentro de los límites de la cuenta y un plan de reversión. Es una capa de operaciones para quien ya invierte en anuncios, no una forma de dejar de pensar en ellos.
Qué es Claude Ads
El repositorio se describe como operaciones de medios pagados portátiles y pensadas para Claude, dirigidas a agencias, consultores y equipos de performance internos. En concreto, es un conjunto de skills y agentes trabajadores que carga un asistente de código: una skill y un worker de auditoría por plataforma, más pasadas de planificación, creatividad, monitorización y reporting entre plataformas. El README enumera doce superficies de primer nivel: Google Ads, Meta Ads, YouTube Ads, LinkedIn Ads, TikTok Ads, Microsoft Advertising, Reddit Ads, Snapchat Ads y X Ads en el lado de búsqueda, vídeo y social, con Apple Ads, Amazon Ads y Pinterest Ads cubriendo comercio y retail media. Claude Code es el runtime canónico; los mismos archivos de skill se documentan como utilizables desde Codex, Gemini, Cursor, Windsurf y Goose donde esos hosts soportan Agent Skills.
Las tripas son más disciplinadas de lo habitual en esta categoría. Un conductor controla el alcance, la política y el artefacto final; los workers analizan porciones acotadas y devuelven hallazgos válidos contra esquema; la salida canónica es JSON versionado, y las versiones en Markdown, HTML y PDF son representaciones de ese mismo bundle validado. Cuando un worker requerido falla, la ejecución se marca como parcial: el README es explícito en que una ejecución parcial nunca se presenta en silencio como una auditoría completa. El repositorio público es MIT, está en 7.804 estrellas a 2026-08-04 y su última versión publicada fue la v2.0.1 en julio de 2026. Es Python, y quiere CPython 3.11 o 3.12, con Playwright para la captura en navegador y WeasyPrint para el renderizado de PDF.
Para qué sirven realmente los comandos
La superficie de comandos se lee como un ciclo completo de compra de medios, lo que ayuda a ver dónde un agente puede aportar y dónde estructuralmente no. Agrupados por la tarea que hacen:
- Configuración y auditoría `/ads setup` construye el perfil de cliente, cuenta, KPI, privacidad y salvaguardas; `/ads audit` ejecuta una pasada completa o acotada respaldada por evidencia. Esta es la mitad que de verdad se beneficia de un agente: el trabajo tedioso con forma de checklist que casi nadie hace con la frecuencia debida.
- Planificar y crear `/ads plan` produce planes de canal, presupuesto, competencia y medición; `/ads create` produce briefs de copy, imagen, vídeo y foto de producto. Borradores, en otras palabras. El criterio sobre qué lanzar sigue siendo tuyo.
- Lanzar y optimizar, siempre primero en borrador `/ads launch --draft` y `/ads optimize --draft` producen un plan de mutación sin tocar la cuenta. El flag es el diseño: nada llega a una cuenta viva por defecto.
- Monitorizar, experimentar, reportar Comprobaciones de ritmo, entrega, tracking, fatiga y políticas; diseño y lectura de tests controlados; y un bundle JSON validado. El bucle de monitorización es donde un anunciante pequeño suele perder dinero, porque nadie mira a diario.
La parte que merece copiarse aunque nunca lo instales
Dos decisiones de diseño de este repositorio merecen robarse para cualquier sistema que gaste dinero en tu nombre. La primera es que cada adaptador es de solo lectura hasta que una operación concreta se habilita deliberadamente, y aplicar un cambio exige entonces todo esto: una capacidad probada para esa operación exacta, IDs explícitos de cuenta y objeto, un diff legible de antes y después con radio de impacto, aprobación del propietario dentro de límites definidos, una clave de idempotencia con destino de auditoría y reversión, y una verificación de que el estado remoto sigue cumpliendo la precondición. Sin límites configurados no hay escritura, y el borrado permanente sencillamente no está soportado.
La segunda es cómo maneja lo que no sabe. Los controles resuelven a pass, fail, unknown o not-applicable, y los unknown reducen la cobertura de evidencia sin mover la puntuación de salud, de modo que una auditoría floja se reporta como floja y no como buenas noticias. Una cobertura del 80% o más se califica, del 60 al 79% es provisional y por debajo del 60% se declara evidencia insuficiente. Es una propiedad rara en el software con IA, donde el fallo habitual es un resumen confiado construido sobre los datos que casualmente cargaron. Si estás evaluando cualquier agente que toque presupuesto, pregunta qué hace cuando falta una fuente: la respuesta separa los proyectos serios de las demos.
También conviene decir los límites honestos. Es una capa de operaciones, no un comprador de medios: sigues poniendo tú las cuentas, el presupuesto y la decisión. Una maquinaria de doce plataformas es más de lo que necesita un fundador que gasta unos cientos al mes, y la cadena de dependencias de Python más Playwright más WeasyPrint es un coste de instalación real. Y una auditoría de una cuenta mal segmentada te dice exactamente con qué eficiencia estás comprando el tráfico equivocado: el retorno de la inversión publicitaria mejora arreglando la oferta al menos tan a menudo como arreglando la campaña.
Una nota de primera mano sobre gestionar tus propios anuncios
Nosotros gestionamos Google Ads para AgentCeres —el AI Growth Officer de agentceres.com— y llegamos por nuestra cuenta a la misma postura con la que viene este repositorio, que es parte de por qué merece cubrirse. Nuestras herramientas publicitarias son de solo lectura por defecto: los scripts extraen informes y una instantánea diaria, y cualquier cambio en la cuenta es una decisión deliberada caso por caso, no algo que ejecute una automatización. Cada cambio recibe una entrada de registro el mismo día que dice qué cambió, por qué, cómo verificarlo y cómo revertirlo. Ese registro ha sido más útil que cualquier panel, porque la pregunta que de verdad necesitas responder dos semanas después es qué cambio movió el número.
La otra cosa que nos enseñó nuestra propia cuenta es dónde está la palanca, y no está donde apuntan las herramientas de auditoría. El único cambio que más importó fue pausar un término genérico de alto volumen que estaba comprando visitantes fuera de nuestro perfil de cliente ideal: no un ajuste de puja, no una renovación creativa. Ninguna optimización arregla una campaña dirigida a la gente equivocada; la segmentación está aguas arriba de todo lo que un motor de puntuación puede medir. Si estás antes de esa decisión, ¿debería una startup temprana invertir en anuncios? es la pregunta más útil, y nuestro Gestor de Publicidad Pagada redacta campañas y mantiene el gasto detrás de una aprobación. Para la mitad orgánica del mismo stack, marketingskills es el vecino más cercano de este proyecto.
FAQ
- ¿Claude Ads es gratis?
- El repositorio público tiene licencia MIT y no requiere ninguna membresía, así que puedes instalarlo y usarlo sin coste de software. El README también apunta a un mirror comunitario donde los miembros de un grupo de pago tienen acceso anticipado, algo que conviene saber pero que no bloquea la versión pública. Tus costes reales son los tokens de modelo que consumen las auditorías y el propio acceso a las APIs de las plataformas.
- ¿Va a cambiar mi cuenta publicitaria?
- No, salvo que te esfuerces bastante. Los adaptadores son de solo lectura por defecto, y una escritura exige una capacidad habilitada para esa operación exacta, IDs de objeto explícitos, un diff de antes y después, aprobación del propietario dentro de límites de gasto definidos y un plan de reversión; sin límite configurado, no hay escritura. Tanto `launch` como `optimize` están documentados como primero-en-borrador, así que la salida normal es un plan de mutación que revisas.
- ¿Hace falta ser técnico para usarlo?
- Más de lo que sugiere el envoltorio de herramienta de marketing. La instalación es un git clone más un script de instalación o un comando de plugin de Claude Code, y el conjunto completo espera un entorno Python 3.11 o 3.12, una carga de navegador Playwright para la captura y librerías de sistema para renderizar PDF. Si te manejas en una terminal es una tarde; si no, la salida de la auditoría sigue siendo legible pero llegar hasta ella es un obstáculo real.
- ¿Sustituye a una agencia?
- Sustituye la parte de auditoría e informes de lo que hace una agencia, que es genuinamente la más sistemática y la más desatendida. No sustituye las decisiones de criterio —a qué mercado apuntar, cuál debe ser la oferta, cuándo dejar de gastar— y no puede concluir que la campaña está bien y el problema es la landing. Una forma útil de verlo es que hace más rápido a un buen operador y le da al fundador que no tiene ninguno una checklist difícil de saltarse.
You built it. Now grow it.
AgentCeres is a managed AI marketing team — specialists draft the SEO, social, and outreach that fill your links, you approve what ships. 14-day free trial, from $39/month.