Gestionar Meta Ads desde Claude Code con frenos de seguridad

01 Qué vas a montar

02 Antes de empezar

• ✓Claude Code instalado y funcionando (claude doctor sin errores graves).
• ✓Python 3.12 o superior.
• ✓Acceso de administrador a la cuenta publicitaria y al Business Manager.
• ✓Una app en Meta for Developers y un token de usuario del sistema con permiso ads_management sobre esa cuenta.
• ✓El ID de la cuenta publicitaria con el prefijo act_.
• ✓Un presupuesto máximo de prueba decidido por escrito.
• ✓Si es posible, una cuenta o campaña de bajo riesgo para las primeras pruebas.

03 Instalación de la CLI y primera consulta

1. 1

   Crea la carpeta del proyecto

   Una carpeta por cuenta o cliente. Así cada una tiene sus reglas, su token y su registro.

2. 2

   Instala la CLI en un entorno virtual

   El paquete se llama meta-ads y el ejecutable que instala es meta. En Mac también está disponible con Homebrew.

3. 3

   Guarda las credenciales en .env

   ACCESS_TOKEN y AD_ACCOUNT_ID son obligatorias; BUSINESS_ID es opcional. Añade .env al .gitignore antes de nada.

4. 4

   Prueba en modo lectura

   Carga las variables y lista las campañas. Si responde, abre Claude Code en esa misma terminal para que herede las variables.

mkdir meta-ads-agente && cd meta-ads-agente
python3 -m venv .venv && source .venv/bin/activate
pip install meta-ads

# Crea .env con tu editor (ACCESS_TOKEN=... y AD_ACCOUNT_ID=act_...)
echo ".env" >> .gitignore
mkdir -p logs .claude

set -a && source .env && set +a
meta ads adaccount current
meta ads campaign list --output json
meta ads insights get --date-preset last_7d

claude

04 Los frenos: reglas y permisos

# Agente de Meta Ads – [nombre de la cuenta]

Herramienta: CLI meta (usa siempre --output json).

## Reglas que no se rompen
- Todo lo que crees (campañas, conjuntos, anuncios) se crea en pausa. La activación la hago yo.
- Antes de cualquier create o update, muéstrame un resumen completo y espera un «sí» explícito.
- Presupuesto diario máximo sin aprobación expresa: [importe] €.
- Los presupuestos van en céntimos: 5000 = 50,00 €.
- No borres nada. Como mucho, propón pausar.
- No leas ni muestres .env ni variables con secretos.
- Si una escritura falla, no la reintentes: explícame el error y espera.
- Anota cada escritura en logs/acciones.log: fecha, comando, parámetros y resultado (IDs).

## Contexto de la cuenta
- Objetivo principal: [ventas / clientes potenciales / tráfico]
- Mercados: [países o provincias]
- Categoría especial de anuncios: [ninguna / crédito / empleo / vivienda / temas sociales]
- Tono de los textos: [descripción]

{
  "permissions": {
    "ask": [
      "Bash(meta ads * create *)",
      "Bash(meta ads * update *)"
    ],
    "deny": [
      "Bash(meta ads * delete *)",
      "Read(./.env)"
    ]
  }
}

05 Primeros pasos después de configurar

1. 1

   Diagnóstico del entorno

   Que compruebe token, cuenta, permisos y páginas disponibles sin tocar nada.

2. 2

   Informe de solo lectura

   Últimos 7 días por campaña. Te sirve para validar que lee bien los datos.

3. 3

   Borrador sin crear nada

   Pide el plan completo de una campaña y revisa cada campo.

4. 4

   Creación en pausa

   Aprueba, deja que cree las piezas una a una y guarda los IDs.

5. 5

   Revisión y activación manual

   Revisa en el Administrador de anuncios y actívala tú. Mide y haz cambios pequeños.

Comprueba sin modificar nada que la CLI meta funciona con esta cuenta: cuenta activa, moneda, zona horaria, páginas disponibles y si el token permite crear anuncios. Dime qué falta antes de poder preparar campañas y crea logs/acciones.log si no existe.

Prepara, sin crear nada todavía, una campaña con este brief:
- Oferta: [producto o servicio]
- Objetivo: [tráfico / clientes potenciales / ventas]
- Presupuesto diario: [importe] €
- Ubicación y público: [zona, edad, intereses o público propio]
- Página de destino: [URL]

Pregúntame primero si encaja en alguna categoría especial de anuncios. Después enséñame en una tabla la campaña, el conjunto de anuncios y tres anuncios con ángulos distintos (texto principal, titular, descripción y llamada a la acción), con el presupuesto en euros y en céntimos. Espera mi aprobación.

Saca los datos de los últimos 7 días por campaña y por anuncio: gasto, impresiones, CTR, CPC, resultados y coste por resultado. Compáralos con la semana anterior, señala anuncios con frecuencia alta o rendimiento en caída y propón tres cambios concretos ordenados por impacto. No apliques ninguno.

06 Cuándo no usarlo todavía

• ✓Si el token no tiene los permisos correctos o caduca pronto.
• ✓Si aún no has probado que las creaciones quedan en pausa.
• ✓Si no tienes claro el gasto máximo aceptable para pruebas.
• ✓Si la cuenta es de un cliente y no tienes su autorización por escrito para operar con automatizaciones.
• ✓Si tus anuncios tocan sectores regulados y no has revisado las políticas de Meta y la normativa española.