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.

Flujo desde la Terminal

Explora, sube, previsualiza y lanza desde la línea de comandos

Pensado para Agentes de IA

Pásaselo a Claude Code, Cursor o Codex con un único archivo skill

Mismo Backend que la App Web

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
~/projects
Live Demo
$

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
Browse Account
Live Demo
$

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
~/projects
Live Demo
$

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
launch-spec.json
Live Demo
1
Reusable. Reviewable. Diffable.

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
Preview · Dry Run
No live changes
$

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
ads create · live job
Live Demo
Ready...
--:--:--Initializing...

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
ClaudeClaude Code · /ads
Live Demo

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ías

Prueba gratuita de 7 días

Sin tarjeta de crédito

Cancela cuando quieras