imrenagicom/adsctl

O que é?

Recursos principais

• 01Retorna envelopes JSON versionados por padrão, adequados para agentes de IA e scripts de shell.
• 02Exige perfil e escopo explícitos de conta para operações de escrita em anúncios, com prévias em dry-run.
• 03Lê tokens de acesso da Meta de arquivos externos ou variáveis de ambiente, sem nunca armazenar os valores na configuração.
• 04Oferece consultas nativas ao Insights, jobs assíncronos, resumos, classificações e exportação em CSV/JSONL.
• 05Executa regras de monitoramento determinísticas e somente leitura e informa mudanças entre snapshots de contas.
• 06Oferece suporte a lançamentos de campanhas em várias etapas que podem ser retomados, com registros de estado e reconciliação.

Casos de uso

• Permitir que um agente de IA gere relatórios de desempenho de campanhas e sinalize problemas de veiculação.
• Agendar verificações de contas somente leitura no CI ou no cron e fazer os jobs falharem quando houver ocorrências.
• Pausar anúncios em massa ou ajustar orçamentos em contas de anúncios de clientes usando um script.
• Publicar posts, Reels ou carrosséis no Instagram por meio de um pipeline automatizado.

Início rápido

1. 1

   Execute o script oficial de instalação indicado no README

2. 2

   Carregue a configuração do PATH no seu shell

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

   Verifique se a CLI é executada

   adsctl version

Antes de usar

• !Até o momento, apenas anúncios da Meta foram implementados; o Google será um adaptador futuro.
• !Você precisa criar um app de desenvolvedor da Meta e fornecer um token de acesso por conta própria; a CLI não cuida do OAuth.
• !No Windows, não há suporte à inicialização persistente nem à execução do monitor.

Em coleções

Tópicos

Perguntas frequentes

O que é adsctl?

CLI em Go preparado para agentes de IA inspecionarem, monitorarem, gerarem relatórios e lançarem campanhas de anúncios da Meta, com saída JSON e escopo explícito de conta. adsctl é uma ferramenta de linha de comando em Go e Cobra para trabalhar com contas de anúncios. A Meta (anúncios do Facebook e Instagram) é a primeira plataforma compatível; há um adapter para Google planejado. Por padrão, a ferramenta retorna JSON, exige escopo explícito de conta para operações de escrita e lê credenciais de arquivos externos de token ou de variáveis de ambiente, em vez de armazená-las na configuração.

adsctl é gratuito? Qual é a licença?

adsctl é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

adsctl ainda é mantido?

Manutenção ativa. O último commit de adsctl foi em 5 de nov. de 2026.

Para que posso usar adsctl?

Permitir que um agente de IA gere relatórios de desempenho de campanhas e sinalize problemas de veiculação. Agendar verificações de contas somente leitura no CI ou no cron e fazer os jobs falharem quando houver ocorrências. Pausar anúncios em massa ou ajustar orçamentos em contas de anúncios de clientes usando um script. Publicar posts, Reels ou carrosséis no Instagram por meio de um pipeline automatizado.

Como instalar adsctl?

Execute o script oficial de instalação indicado no README Carregue a configuração do PATH no seu shell: source "$HOME/.adsctl/env" Verifique se a CLI é executada: adsctl version

Onde consigo adsctl?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/imrenagicom/adsctl