Configuración por CLI

Actualmente en beta y no disponible para usuarios en prueba. Los usuarios de pago pueden solicitar acceso en [email protected].

La mejor forma de empezar con el CLI (interfaz de línea de comandos) es entender cómo funciona Ads Uploader. El CLI sigue exactamente la misma estructura que la aplicación web. Si entiendes la aplicación web y has subido anuncios por ahí, usar el CLI te resultará inmediato.

Los preajustes que creas en la interfaz web se mantienen y son accesibles desde el CLI. A algunos usuarios les resulta más fácil configurar sus preajustes en la aplicación y luego cambiarse al CLI para el trabajo diario con campañas. Todo sigue siendo totalmente personalizable desde el propio CLI.

¿Por qué usar el CLI? Ofrece una interfaz distinta con enfoque agéntico sobre la misma infraestructura probada de Ads Uploader. Cargar varios lotes es más rápido y puedes usar IA para redactar copy y ensamblar builds de anuncios. Es otra forma de usar Ads Uploader.

La mayoría de usuarios manejan el CLI mediante un agente de IA como Claude Code o Cursor. Consulta Uso con IA al final de esta página para ver cómo entregarle el CLI a un agente una vez lo tengas configurado.

Instalación y autenticación

Instala el CLI de forma global con npm install -g @adsuploader/cli (requiere Node.js 18+), luego ejecuta ads login para autenticarte a través del navegador. Esto usa tu cuenta existente de Ads Uploader y tu conexión de Facebook.

Ejecuta el comando de login en el mismo dispositivo donde ya estás con sesión iniciada en adsuploader.com, ya que el flujo de autenticación abre una ventana del navegador para verificar tu identidad.

Configurar tu cuenta

Una vez con sesión iniciada, ejecuta ads accounts para ver todas las cuentas publicitarias conectadas a tu cuenta de Meta, luego ads account act_123456789 para definir tu cuenta por defecto. Es el mismo selector de cuentas que ves en la aplicación web.

Explorar tu cuenta

Antes de crear anuncios, puedes explorar toda la estructura de tu cuenta desde el CLI, igual que harías clic en campañas, conjuntos de anuncios y anuncios en la aplicación web.

Así encuentras el anuncio del que quieres copiar la configuración, o confirmas qué preajuste usar en tu archivo de especificación.

Subir medios

Sube imágenes y videos a la biblioteca de medios de tu cuenta publicitaria con ads upload:

ads upload hero.jpg banner.mp4 promo.mp4
ads upload ./my-creatives/

Esto devuelve un ID de lote que referenciarás al crear anuncios. Ejecuta ads uploads para ver tus lotes recientes.

La agrupación por variantes funciona automáticamente si nombras los archivos con sufijos de relación de aspecto, igual que en la aplicación web. Consulta Variantes de relación de aspecto para saber cómo nombrar tus archivos correctamente.

Crear anuncios

La creación de anuncios tiene dos pasos: preview y create.

El archivo de especificación

Un archivo JSON de especificación le dice al CLI qué construir. La especificación más simple referencia un preajuste guardado y tu lote de subida:

{ "adPresetId": "your_preset_id", "uploadId": "batch_abc123" }

También puedes copiar la configuración de un anuncio existente en vez de usar un preajuste:

{ "copyFromAd": "120233848667930472", "uploadId": "batch_abc123" }

Para encontrar el ID de anuncio correcto, explora tu cuenta con ads campaigns, ads campaign <id>, ads adset <id> y ads ad <id>.

Previsualiza primero

Siempre previsualiza antes de crear. Ejecuta ads create:preview spec.json para ver exactamente lo que se crearía sin tocar Facebook. Esto detecta errores de configuración antes de que nada vaya en vivo.

Crear

Cuando estés contento con la vista previa, ejecuta ads create spec.json. Los anuncios quedan activos por defecto, como en la aplicación web. Para crearlos en pausa, añade --status PAUSED o define "options": { "status": "PAUSED" } en la especificación.

Referencia completa

Para el formato completo del archivo de especificación, todos los comandos, flags, configuración de mejoras creativas, Carousel Ads y Flexible Ads, marcadores de nombrado de anuncios y patrones comunes, consulta la Referencia completa del CLI.

Seguimiento de trabajos

La creación de anuncios se ejecuta en segundo plano. El CLI transmite el progreso automáticamente, pero también puedes consultar un trabajo más tarde:

Consejos

• Siempre previsualiza primero. create:preview detecta errores de configuración antes de tocar Facebook.
• Los anuncios quedan activos por defecto. Usa --status PAUSED si quieres revisarlos primero en Ads Manager.
• Las subidas están atadas a una cuenta. El ID de lote solo funciona con la cuenta a la que subiste.
• Los preajustes se mantienen desde la aplicación web. Crea tus preajustes en la UI web y referéncialos por ID en el CLI.
• Ejecuta ads config para revisar tu configuración. Muestra tu cuenta actual, URL de la API y ruta de credenciales.

Uso con IA

El CLI está diseñado para ser controlado por agentes de IA como Claude Code o Cursor. Una vez instalado y autenticado, registra el archivo de skill para que tu agente entienda cada comando y opción de la especificación de esta página.

El archivo de skill viene dentro del paquete npm en node_modules/@adsuploader/cli/SKILL.md. En Claude Code, configúralo como un comando de slash personalizado (por ejemplo, /ads):

mkdir -p .claude/commands
cp node_modules/@adsuploader/cli/SKILL.md .claude/commands/ads.md

Después escribe /ads en Claude Code para cargar el skill antes de dar instrucciones. Para otras herramientas de IA como Cursor, añade SKILL.md como archivo de reglas o contexto.

Seguridad. La autenticación del CLI está vinculada a tu dirección IP y solo puede ejecutarse un trabajo de creación de anuncios a la vez por cuenta. El CLI no está pensado para integrarse con otras aplicaciones. Es una interfaz alternativa para compradores de medios avanzados.

Ejemplo de prompt

Una vez configurado, da instrucciones a tu agente de IA como:

Tengo un montón de creativos nuevos en mi carpeta downloads/ads. Súbelos y crea anuncios con los mismos ajustes que mi preajuste de campaña de ventas/compra. Agrúpalos en conjuntos de anuncios de cinco nombrados con la fecha de hoy, con un presupuesto diario de $25. Escribe copy único para cada imagen según su contenido. Pausa a nivel de conjunto de anuncios y previsualiza primero.