Repolode
Enviar
imrenagicom

imrenagicom/adsctl

CLI de Go preparado para agentes de IA que permite inspeccionar, monitorear, generar informes y lanzar campañas de Meta Ads, con salida JSON y alcance de cuenta explícito.

Alternativa open source a:Meta Ads Manager

Ver en GitHub
Estrellas
76
Forks
6
Issues abiertos
0
Último commit
anteayer

¿Qué es?

adsctl es una herramienta de línea de comandos basada en Go y Cobra para gestionar cuentas publicitarias. Meta (anuncios de Facebook e Instagram) es la primera plataforma compatible; hay un adaptador para Google previsto. Devuelve JSON de forma predeterminada, exige especificar explícitamente el alcance de la cuenta para las operaciones de escritura y lee las credenciales de archivos de tokens externos o variables de entorno, en lugar de guardarlas en la configuración.

La CLI permite descubrir recursos (cuentas, campañas, conjuntos de anuncios, anuncios, creatividades, píxeles y audiencias); consultar Insights nativos y generar informes asíncronos con resúmenes, clasificaciones y exportación a CSV/JSONL; y ejecutar reglas de monitoreo de solo lectura en una sola ejecución para señalar problemas de entrega y métricas. Las operaciones de escritura incluyen crear, actualizar, pausar y archivar objetos de campaña; cambiar presupuestos con vistas previas de dry-run; y ejecutar lanzamientos en varios pasos que registran su estado y permiten reanudarlos y conciliarlos tras una interrupción.

El repositorio también incluye tres skills para agentes (informes y operaciones, auditorías de rendimiento de Meta y configuración) y se puede instalar como plugin para Codex, Claude Code y Google Antigravity. Incluye comandos para publicar en Instagram imágenes, Reels, Stories y carruseles, y ofrece binarios precompilados para Linux, macOS y Windows.

Funciones clave

  • 01Devuelve por defecto respuestas JSON con versiones, adecuadas para agentes de IA y scripts de shell.
  • 02Exige especificar explícitamente el perfil y el alcance de la cuenta para las operaciones de escritura publicitaria, con vistas previas de dry-run.
  • 03Lee los tokens de acceso de Meta desde archivos externos o variables de entorno; nunca guarda sus valores en la configuración.
  • 04Ofrece consultas nativas de Insights, tareas asíncronas, resúmenes, clasificaciones y exportación a CSV/JSONL.
  • 05Ejecuta reglas de monitoreo deterministas y de solo lectura, e informa de los cambios entre instantáneas de una cuenta.
  • 06Admite lanzamientos de campañas en varios pasos que se pueden reanudar, con registros de estado y conciliación.

Casos de uso

  • Permitir que un agente de IA genere informes sobre el rendimiento de campañas y señale problemas de entrega.
  • Programar comprobaciones de cuentas de solo lectura en CI o cron y hacer que los trabajos fallen si se detectan problemas.
  • Pausar anuncios en lote o ajustar presupuestos en cuentas publicitarias de clientes mediante un script.
  • Publicar posts, Reels o carruseles en Instagram desde un pipeline automatizado.

Inicio rápido

  1. 1

    Ejecuta el script de instalación oficial indicado en el README

  2. 2

    Carga la configuración de PATH en tu shell

    source "$HOME/.adsctl/env"
  3. 3

    Comprueba que se ejecuta la CLI

    adsctl version

Antes de usarlo

  • Por ahora solo se han implementado los anuncios de Meta; Google será un adaptador futuro.
  • Debes crear una aplicación de desarrollador de Meta y proporcionar tú mismo un token de acceso; la CLI no gestiona OAuth.
  • En Windows no se admiten el lanzamiento persistente ni la ejecución del monitor.

En colecciones

Frameworks y apps de agentes de IA open sourceHerramientas de CLI y terminal

Temas

#advertising#meta-ads#cli#golang#ai-agent#marketing-automation#instagram#reporting

Preguntas frecuentes

¿Qué es adsctl?
CLI de Go preparado para agentes de IA que permite inspeccionar, monitorear, generar informes y lanzar campañas de Meta Ads, con salida JSON y alcance de cuenta explícito. adsctl es una herramienta de línea de comandos basada en Go y Cobra para gestionar cuentas publicitarias. Meta (anuncios de Facebook e Instagram) es la primera plataforma compatible; hay un adaptador para Google previsto. Devuelve JSON de forma predeterminada, exige especificar explícitamente el alcance de la cuenta para las operaciones de escritura y lee las credenciales de archivos de tokens externos o variables de entorno, en lugar de guardarlas en la configuración.
¿adsctl es gratuito? ¿Qué licencia tiene?
adsctl es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿adsctl sigue mantenido?
Mantenimiento activo. El último commit de adsctl fue el 5 nov 2026.
¿Para qué puedo usar adsctl?
Permitir que un agente de IA genere informes sobre el rendimiento de campañas y señale problemas de entrega. Programar comprobaciones de cuentas de solo lectura en CI o cron y hacer que los trabajos fallen si se detectan problemas. Pausar anuncios en lote o ajustar presupuestos en cuentas publicitarias de clientes mediante un script. Publicar posts, Reels o carruseles en Instagram desde un pipeline automatizado.
¿Cómo se instala adsctl?
Ejecuta el script de instalación oficial indicado en el README Carga la configuración de PATH en tu shell: source "$HOME/.adsctl/env" Comprueba que se ejecuta la CLI: adsctl version
¿Dónde consigo adsctl?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/imrenagicom/adsctl

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados

revive-adserver / revive-adserver

Sistema de publicación de anuncios de código abierto para que los editores publiquen, administren y midan campañas publicitarias en sus sitios web.

Productividad y apps#ad-server#advertising#php
1,5 mil+3 esta semana616PHPGPL-2.0Bien mantenidoActualizado hace 18 horas