Meta Ads CLI
por Ads UploaderLanza anuncios de Facebook con Claude Code
Ejecuta tu flujo de Ads Uploader desde tu terminal con nuestro Meta Ads CLI. Tu agente de IA lee creativos, escribe copy, monta el spec y lo envía por la API de Meta. Validación, reintentos y casos límite, todo gestionado sin esfuerzo.
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
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+.
- Inicia sesión y autentícate desde tu navegador
- Sin variables de entorno que guardar, sin tokens que compartir de forma segura con tus colegas
- Elige una cuenta por defecto una sola vez con ads account act_xxx, cambia 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
- Se complementa con nuestro Meta Ads MCP cuando prefieres chatear junto a la app web
Claude Code · /adsWeb, MCP y CLI. Un Solo Circuito.
La terminal nunca te encierra. Los builds guardados llevan un lanzamiento de una superficie a otra: empieza uno en la app web, parchéalo desde un chat con Claude o ChatGPT sobre nuestro Meta Ads MCP, y termínalo aquí con un solo comando. La misma referencia de build se abre en todas partes.
- Los builds guardados y los presets se comparten entre todas las superficies
- Bifurca un build para una variante sin tocar el original
- ¿Prefieres chatear junto a la app web? Ese es nuestro Meta Ads MCP
- Empieza donde quieras, termina donde quieras, nada queda bloqueado
Upload media, apply a preset, start the build
Meta Ads CLI vs. Ads Uploader CLI
El 29 de abril de 2026, Meta lanzó meta-ads, un wrapper de línea de comandos oficial y gratuito para la Marketing API. Expone la API objeto por objeto.
Flujo de Autenticación
- •Crea una app de Meta personalizada
- •Aprovisiona un system user
- •Asigna tus activos
- •Genera un access token con 7 scopes
- •Pega el token en .env
- •Compártelo de forma segura con tus colegas
- Ejecuta ads login
- Autentícate en tu navegador
- Cada colega inicia sesión por su cuenta
Lógica de Casos Límite
- •Las particularidades de formato las gestionas tú
- •Sin agrupación de variantes por proporción
- •Toggles crudos de la API para mejoras creativas
- •Los casos límite aparecen en producción
- •Errores genéricos, sin lógica de reintentos
- Todos los formatos de anuncio soportados de forma nativa
- Variantes por proporción agrupadas automáticamente
- Control de mejoras creativas por objetivo
- Probado en producción a escala
- Reintentos y errores legibles incluidos
Configuraciones de Anuncio Heredadas
- •Define cada campo de campaña
- •Define cada campo de ad set
- •Define cada campo creativo
- •Vuelve a especificar cada lanzamiento desde cero
- Referencia cualquier anuncio existente
- Hereda segmentación y placements
- Hereda catálogos y píxeles
- Sobrescribe solo lo que ha cambiado
Lanzar anuncios es lo único que hacemos. Hemos diseñado nuestras herramientas para ser las mejores en eso, moldeadas por millones de dólares de inversión publicitaria en nuestras propias marcas y negocios.
Chris Pollard Fundador de Ads Uploader
Las distintas formas de interactuar con la API de Meta son interesantes, pero los casos límite de la API siguen pasando factura. Cobertura de formatos, lógica de reintentos, configs válidas, herencia de anuncios existentes - llevamos años codificando todo eso en el flujo de Ads Uploader. Los marketers lanzan anuncios más rápido con nosotros que tejiendo llamadas a la API por su cuenta.
Una CLI es la interfaz adecuada para un agente de IA igual que una UI visual lo es para los clics. Mismos marketers, contextos diferentes - por eso construí la nuestra. Que Meta lance la suya es una validación bienvenida.
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