Conectar Claude a Meta Ads

01 / 09

Lo que necesitas

Tres cosas, y las tres son gratis.

Pieza	Para qué
Claude Code	Es donde se instala la skill y donde haces las auditorías.
Cuenta publicitaria	Una cuenta de Meta Ads en la que seas administrador, dentro de tu portfolio comercial.
Meta for Developers	Tu cuenta de desarrollador en developers.facebook.com. Se crea con tu Facebook en un minuto.

¿No quieres conectar nada todavía? Puedes empezar exportando un CSV desde el Administrador de anuncios y pasándoselo a Claude. Es la forma más segura de probarlo, y luego conectas la cuenta cuando te convenza.

02 / 09

Para que no te bloqueen la cuenta

Lo que tumba cuentas no es usar la API: es usarla como un robot. Cuatro reglas para que tu uso parezca el de una persona.

Empieza en solo lectura

Para auditar basta con leer. Dale permiso para cambiar cosas solo cuando lo necesites de verdad.

Una cosa cada vez

Nada de ráfagas de peticiones ni de revisar varias cuentas a la vez. Despacio y de una en una.

Nada se activa solo

Si Claude crea algo, lo deja en pausa. Lo activas tú desde el Administrador de anuncios.

Las creatividades, a mano

No subas imágenes ni vídeos por la API. Claude te las prepara y las subes tú.

Meta no publica una lista oficial de lo que lleva a una restricción. Estas reglas son prudencia: hacen que tu uso se parezca al de una persona y no al de un bot.

03 / 09

Instala claude-ads

Es una skill gratuita y de código abierto que audita cuentas de Meta, Google, TikTok, LinkedIn y más.

Licencia MIT y 10.034 estrellas en GitHub. Abre Claude Code y pega esto:

Claude Code

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

Reinicia Claude Code y escribe /ads: si te salen comandos como /ads meta o /ads audit, está instalada. Instalado como plugin, el nombre completo es /claude-ads:ads: elígelo en el autocompletado y funciona igual.

Si el comando de instalación da error, el autor puede haber cambiado el nombre del plugin. Mira el apartado de instalación en su repositorio y usa el que ponga ahí. Si lo tenías instalado de antes de la versión 2, quita primero el antiguo con /plugin marketplace remove agricidaniel-claude-ads y vuelve a pegar los dos comandos.

04 / 09

Crea tu app en Meta for Developers

La app es la puerta por la que Claude entra a tu cuenta. Es tuya y la puedes borrar cuando quieras.

Entra en developers.facebook.com/apps y pulsa Crear aplicación.
Ponle un nombre que reconozcas, por ejemplo Claude Auditoría, y tu correo.
En Casos de uso, marca Crear y gestionar anuncios con la API de marketing.
Si te lo pide, conéctala a tu portfolio comercial: el mismo en el que está tu cuenta publicitaria.
Revisa el resumen y pulsa Crear aplicación.

No hace falta publicar la app ni pasar la revisión de Meta para usarla con tus propias cuentas, en las que eres administrador.

05 / 09

Saca el token de acceso

El token es la llave que le das a Claude. Elige qué puede hacer con ella.

RecomendadoSolo leer

Permiso ads_read. Claude ve campañas, conjuntos, anuncios y resultados, pero no puede cambiar nada. Es lo que necesitas para auditar.

Más adelanteLeer y gestionar

Añade ads_management. Claude podrá pausar o crear en pausa, siempre que se lo confirmes. Úsalo cuando ya confíes en cómo trabaja.

Abre el Explorador de la API Graph.
Arriba a la derecha, en Aplicación de Meta, elige la app que acabas de crear.
En Permisos, añade ads_read (y ads_management solo si lo quieres ya).
Pulsa Generate Access Token, acepta y copia el token.
Ese token dura poco, unas horas. Para que dure unos 60 días, pégalo en el Depurador de tokens y pulsa Ampliar token de acceso. Copia el nuevo.
Copia también el ID de tu cuenta publicitaria: está en la dirección del Administrador de anuncios, después de act=. Escríbelo con el prefijo act_, por ejemplo act_123456789.

Quien tenga tu token puede entrar en tu cuenta publicitaria. No lo pegues en chats, capturas ni vídeos. Si se te escapa, ve a la app → Configuración → Básica y restablece la clave secreta para anular todos los tokens.

06 / 09

Guárdalo bien

El token no se pega en la conversación. Va en un archivo que Claude lee sin enseñarlo.

Crea una carpeta para tus auditorías, por ejemplo meta-ads, y abre Claude Code dentro.
Crea en ella un archivo llamado .env con estas dos líneas:

.env

META_ACCESS_TOKEN=pega_aquí_tu_token
META_AD_ACCOUNT_ID=act_tu_numero

Y dale a Claude estas reglas una sola vez:

Prompt

En esta carpeta hay un archivo .env con mi token de Meta y el ID de mi cuenta.
Guarda en CLAUDE.md estas reglas para siempre:
- Lee el token desde .env. Nunca lo muestres, no lo copies a otros archivos
  y no lo escribas en la conversación.
- Si esta carpeta es un repositorio, añade .env a .gitignore.
- Trabaja en solo lectura salvo que yo te pida un cambio concreto.
- Una petición a la API cada vez, con una pausa de 2 segundos entre ellas.
- Nunca actives nada: lo que crees, en pausa.
- No subas imágenes ni vídeos por la API.
- Antes de cualquier cambio, enséñame qué vas a hacer y espera mi OK.

07 / 09

Tu primera auditoría

Un comando. Te dice qué está fallando y qué cambiar primero.

Claude Code

/ads meta

Si quieres darle contexto para que el diagnóstico tenga sentido, mejor así:

Prompt

/ads meta
Mi negocio: [qué vendes y a quién]
Objetivo de las campañas: [leads, ventas, mensajes…]
Coste por resultado al que aspiro: [cifra]
Revisa los últimos 30 días en solo lectura y dame:
1. Un resumen de cómo está la cuenta y por qué.
2. Los 5 problemas que más resultado me están quitando, del más grave al menos.
3. Qué cambiaría primero, explicado para que lo pueda hacer yo en el Administrador.

La primera vez puede tardar unos minutos: va despacio a propósito, por la regla de una petición cada vez.

08 / 09

Prompts listos

Ocho prompts para el día a día, ordenados de menos a más riesgo.

Solo mirar

Creatividades cansadas

/ads creative ¿qué anuncios se están quemando por frecuencia o caída de CTR y cuáles debería renovar primero?

Píxel y API de conversiones

/ads tracking revisa mi píxel y la API de conversiones: eventos duplicados, eventos que faltan y calidad de coincidencia. Sin cambiar nada.

Reparto del presupuesto

/ads budget ¿cómo está repartido mi presupuesto y adónde movería el dinero según los resultados de los últimos 30 días?

Tu página de destino

/ads landing revisa esta página a la que mando el tráfico y dime qué frena la conversión: URL

Mirar a la competencia

/ads competitor ¿qué formatos y mensajes usan estos competidores y en qué se diferencian de los míos? COMPETIDOR1, COMPETIDOR2

Preparar sin publicar

Un anuncio nuevo

/ads create prepárame un anuncio para [producto]: 3 versiones del texto, la idea de la imagen o el vídeo y el público. No subas ni crees nada en la cuenta.

Informe para un cliente

/ads report hazme un informe en PDF de la auditoría, claro y sin tecnicismos, para enseñárselo a mi cliente.

Cambiar algo (con permiso de gestión)

Pausar lo que no funciona

Lista los conjuntos con un coste por resultado 3× por encima de [objetivo] en los últimos 7 días, con su ID. No pauses nada: yo te digo cuáles, y de uno en uno.

09 / 09

Si algo falla

Lo que pasa	Solución
Error 190 o «token caducado»	Genera uno nuevo y amplíalo en el Depurador de tokens (paso 05). Cambia el de `.env`.
«Falta permiso»	Vuelve al Explorador de la API Graph, añade `ads_read` y genera el token otra vez.
No encuentra la cuenta	Revisa que el ID lleve delante `act_` y que seas administrador de esa cuenta.
Error de límite (por ejemplo, 17 o 80004)	Has hecho demasiadas peticiones. Para, espera una hora y recuérdale a Claude la regla de una cada vez.
/ads no aparece	Reinicia Claude Code. Si sigue sin salir, repite la instalación (paso 03).
El diagnóstico no tiene sentido	Dale contexto: qué vendes, tu objetivo y el coste por resultado al que aspiras.

claude-ads es un proyecto de código abierto de terceros (licencia MIT), no de Anthropic ni de Meta. Los menús de Meta cambian a menudo: si algo no coincide, manda su documentación oficial.

Conectar Claude a Meta Ads

Instalar

Conectar

Auditar