Cómo hacer que Claude audite cuentas publicitarias de forma segura en 12 plataformas

Confiar en modelos de lenguaje con tareas de producción siempre es un poco aterrador. Cuando se trata de presupuestos publicitarios, el miedo se multiplica por diez. Un movimiento incorrecto de un agente en la API de la plataforma publicitaria, y el presupuesto de un mes se va a la segmentación equivocada en un par de horas. Por eso la mayoría de los equipos todavía copian las exportaciones manualmente y las introducen en interfaces web de chatbots, obteniendo consejos vagos sin números concretos a cambio.

最近发现了一个开源仓库 claude-ads。作者尝试在 Claude Code 的代理功能之上构建一个严格的工程系统。这个想法是将 Claude 变成一个辅助的性能营销助手，具有硬性安全防护、类型安全和确定性验证检查。

Bajo el Capó

El proyecto es una colección de habilidades y herramientas CLI escritas en Python. Puedes trabajar con él a través de Claude Code, Cursor, Windsurf, Gemini o Codex. El enfoque principal aquí está en la seguridad de los datos y la predictibilidad.

El sistema soporta 12 plataformas publicitarias:

• Redes de búsqueda y sociales: Google Ads, Meta Ads, YouTube Ads, LinkedIn Ads, TikTok Ads, Microsoft Advertising, Reddit Ads, Snapchat Ads, X Ads.
• E-commerce y retail media: Apple Ads, Amazon Ads, Pinterest Ads.

En lugar de darle al modelo total libertad a través de llamadas de herramientas no controladas, el proyecto divide el flujo de trabajo en etapas aisladas.

Seguridad y Protección Contra Cargos Accidentales

La arquitectura de claude-ads se ejecuta en modo de solo lectura por defecto. Puedes ejecutar auditorías, construir hipótesis, generar textos publicitarios y analizar métricas sin arriesgar romper campañas en vivo.

Si se necesita aplicar optimizaciones, el sistema requiere pasar varios niveles de verificación:

• Los IDs exactos de cuenta y objetos se especifican explícitamente.
• Se genera un diff claro del estado antes y después de los cambios con una evaluación de la zona de impacto.
• Se establecen límites estrictos de presupuesto que el agente fundamentalmente no puede exceder.
• Para cada solicitud de escritura, se genera una clave de idempotencia y un plan de reversión de cambios.

Las operaciones completas de eliminación de entidades simplemente se eliminaron del código en la versión dos. Las credenciales de API no terminan en el contexto del modelo, informes ni historial de git: se leen exclusivamente de variables de entorno o del almacén de secretos del sistema.

Arquitectura y Evaluación de Calidad de Campañas

Dentro del repositorio, todo está dividido en niveles claros de responsabilidad.

Un único proceso conductor acepta comandos de usuario, define límites de alcance y distribuye tareas a trabajadores aislados. Cada trabajador es responsable de una pieza específica de análisis y genera JSON estricto según un esquema. Si uno de los trabajadores requeridos falla con un error, toda la ejecución se marca como parcial. El sistema no enmascarará el fallo ni presentará un informe incompleto como un resultado terminado.

La salida canónica es JSON versionado y validado. A partir de esto, la utilidad ensambla resúmenes en Markdown, páginas HTML o PDFs a través de WeasyPrint.

La puntuación de salud de la cuenta publicitaria está diseñada de manera interesante. Cada verificación tiene un estado de pass, fail, unknown o not_applicable. La completitud de los datos recopilados se evalúa por separado de la puntuación general de salud:

• Si el 80% o más de las verificaciones están cubiertas, se asigna una puntuación completa.
• Con una cobertura del 60% al 79%, la puntuación se considera preliminar.
• Si los datos son menores al 60%, la puntuación no se calcula en absoluto debido a evidencia insuficiente.
• Las funciones beta y las funciones de plataforma no disponibles se excluyen de los cálculos para evitar reducir la calificación.

Cómo es Trabajar con la Herramienta

La instalación en Claude Code se realiza a través del gestor de plugins:

/plugin marketplace add AgriciDaniel/claude-ads
/plugin install claude-ads@ai-marketing-hub-claude-ads

Si prefieres la instalación local o usas otros entornos:

git clone https://github.com/AgriciDaniel/claude-ads.git
cd claude-ads
bash install.sh --source=local

El instalador soporta Python 3.11 y 3.12 en Linux, macOS y Windows. Si faltan bibliotecas del sistema, el script fallará con un error antes de realizar cualquier cambio.

Después de la instalación, la interacción se construye alrededor de comandos de barra. Por ejemplo:

• /ads setup configura el perfil del cliente, los KPIs objetivo, los límites de presupuesto aceptables y las reglas de privacidad.
• /ads audit all ejecuta una auditoría completa de los canales conectados con cada salida vinculada a métricas fechadas.
• /ads plan calcula la distribución del presupuesto, el plan de medios y el plan de pruebas divididas.
• /ads optimize --draft prepara un borrador de cambios de ofertas y creatividades sin aplicarlos en la plataforma.
• /ads report genera el informe estructurado final.

Los atajos directos para cuentas específicas también funcionan: /ads google, /ads meta, /ads reddit.

Para Quién Será Útil el Proyecto

Es poco probable que alguien que ejecute un solo anuncio con un presupuesto de unos pocos miles de pesos necesite este repositorio. Pero si tu empresa ejecuta publicidad multi-plataforma o estás construyendo automatización interna para una agencia, hay mucho que explorar aquí.

Incluso si no usas la herramienta en su totalidad, el código fuente claude_ads_core y la estructura de directorios control-plane/ proporcionan un sólido ejemplo de cómo diseñar habilidades confiables para LLMs. En lugar de prompts de texto caóticos, el autor implementó contratos de datos, esquemas de validación y puertas de confirmación obligatorias del operador. El repositorio tiene una licencia abierta (MIT), así que puedes libremente descomponer el código en tus propios módulos.