Meta Ads CLI
Lanza anuncios de Facebook con Claude Code
Ejecuta el flujo completo de Ads Uploader desde tu terminal. Un archivo JSON describe el lanzamiento; la CLI se encarga de la validación, los reintentos y la API de Meta. Guarda los specs en git, compáralos la semana que viene, pásaselos a un colega o a un agente IA. Diseñada para testing creativo de alto volumen, donde el mismo lanzamiento se repite una y otra vez.
Explora, sube, previsualiza y lanza desde la línea de comandos
Pásaselo a Claude Code, Cursor o Codex con un único archivo skill
Tus presets, cuentas y conexión con Meta se mantienen igual
Mira la CLI en Acción
Un recorrido completo desde la instalación hasta lanzar anuncios
Instala una vez, autentícate una vez
Instala globalmente con npm, ejecuta ads login para autenticarte desde el navegador y elige una cuenta publicitaria por defecto. Tu cuenta de Ads Uploader y tu conexión con Facebook hacen el resto.
- Un npm install. Funciona donde haya Node 18+.
- OAuth desde el navegador, sin tokens manuales
- Selecciona una cuenta por defecto con ads account act_xxx
- Cambia entre cuentas tan rápido como cambias de carpeta
Explora tu Cuenta sin Salir de la Shell
El mismo selector de campañas, ad sets y anuncios que usas en la app web, pero como comandos. Encuentra el anuncio del que quieres copiar configuración, confirma un preset o revisa rendimiento sin abrir Ads Manager.
- ads campaigns lista las campañas activas de tu cuenta
- Profundiza con ads campaign, ads adset y ads ad
- Muestra titulares, texto, CTA, URL y el ad set padre
- Copia el ID de un anuncio directo a copyFromAd en tu spec
Sube Carpetas, no Archivos uno por uno
Apunta la CLI a una carpeta de creativos y todo el lote va directo a la biblioteca de medios de Meta. La agrupación por sufijos en el nombre funciona igual que en la app web.
- ads upload ./mis-creativos sube un directorio entero
- Variantes 1:1, 4:5, 9:16 y 16:9 agrupadas por nombre
- Devuelve un batch ID que referencias en tu spec
- Funciona con Google Drive, Dropbox y OneDrive montados
Un Archivo Spec. Reutilizable. Comparable.
En lugar de pasar por pantallas de configuración, describes el lanzamiento en un archivo JSON. Referencia un preset guardado o copia un anuncio existente, luego añade titulares, texto principal, patrones de nombres y ajustes finos.
- Referencia un preset por ID, el mismo que ya usas en la web
- O usa copyFromAd para clonar un anuncio existente entero
- Sobrescribe textos, URLs, nombres y mejoras creativas
- Guárdalo en git, compáralo después, pásalo a tu equipo
Previsualiza Antes de Gastar
Cada lanzamiento empieza con un dry run. ads create:preview muestra exactamente qué se crearía - campaña, ad sets, anuncios, presupuestos, estado - sin tocar la API de Meta. Detecta errores antes de que cuesten algo.
- La salida del dry run coincide con lo que se creará realmente
- Valida tu spec con el mismo motor que usa la app web
- Detecta campos faltantes, referencias mal o combinaciones inválidas
- Cero llamadas a la API, cero coste, cero riesgo
Anuncios en Vivo en Tiempo Real
ads create ejecuta el lanzamiento como un job en segundo plano y transmite el progreso a tu terminal. La misma pipeline que mueve la app web - rate limiting, reintentos, validación y variantes creativas, todo gestionado.
- Un comando publica todo el lote en Meta
- Progreso en vivo de cada ad set y anuncio creado
- Reanuda con ads jobs JOB_ID --follow si te desconectas
- Activo por defecto o --status PAUSED como red de seguridad
Pásale Todo el Flujo a un Agente de IA
La CLI incluye un archivo skill que sueltas en Claude Code, Cursor o cualquier agente capaz de ejecutar comandos. El agente lee creativos, escribe copys, monta el spec, previsualiza y lanza - tú supervisas desde la terminal.
- Suelta SKILL.md en .claude/commands y aparece el comando /ads
- Cada comando hace una sola cosa, así el agente se mantiene determinista
- Los specs le dan al agente un plan revisable antes de gastar
- Funciona junto a tu MCP para cerrar el bucle análisis-ejecución
El Mismo Flujo de Ads Uploader. Ahora en Manos Tuyas y de tu Agente.
Un archivo spec, un comando, anuncios en tu cuenta.
Empieza tu prueba de 7 díasPrueba gratuita de 7 días
•Sin tarjeta de crédito
•Cancela cuando quieras