Ads Uploader CLI
para Meta AdsLanza Meta Ads en masa desde tu terminal o agente de IA
El CLI de Ads Uploader te permite, a ti o a un agente de IA como Claude Code o Codex, lanzar Meta Ads en masa desde la terminal en todas las cuentas publicitarias que gestionas. Apúntalo a un anuncio que ya tengas activo y el nuevo lote copia su configuración, su audiencia y sus placements, con la estructura de campañas y conjuntos de anuncios que necesites. Cada lanzamiento es un spec que previsualizas antes de que se cree nada. Funciona junto al CLI oficial de Meta: el de Meta crea un objeto por comando, el nuestro ejecuta el lanzamiento completo.
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
- Define una cuenta por defecto con ads account act_xxx, o pasa --account en cada lanzamiento para trabajar con varias cuentas de clientes
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
Empieza cada lanzamiento con un dry run. ads create:preview muestra exactamente qué se crearía - campaña, ad sets, anuncios, presupuestos, estado - sin crear nada en 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
- No se crea nada en Meta, así que no se gasta nada
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.
- Copia SKILL.md en .claude/skills/ads y aparece la skill /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 el MCP de Ads Uploader 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 a través del MCP de Ads Uploader, 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? Para eso está el MCP de Ads Uploader
- Empieza donde quieras, termina donde quieras, nada queda bloqueado
Upload media, apply a preset, start the build
CLI Oficial de Meta 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. Crea un objeto por comando y no tiene comando por lotes, así que los lanzamientos en masa implican bucles de shell. El CLI de Ads Uploader lo complementa: el de Meta para reporting y ediciones puntuales, el nuestro para lanzamientos en masa en tus cuentas publicitarias. Nuestra guía de Meta Ads CLI cubre a fondo la herramienta de Meta.
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
- •Sin capa documentada de reintentos ni de control de ritmo
- 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