Meta Ads CLI
by Ads UploaderLance Meta Ads com Claude Code
Execute seu fluxo Ads Uploader pelo terminal com nossa Meta Ads CLI. Seu agente de IA lê criativos, escreve copy, monta a especificação e publica pela API da Meta. Validação, novas tentativas e casos de borda tratados sem atrito.
Navegue, suba, visualize e lance pela linha de comando
Entregue para Claude Code, Cursor ou Codex com um único arquivo de skill
Seus presets, contas e conexão com a Meta continuam os mesmos
Instale uma vez, autentique uma vez
Instale globalmente com npm, rode ads login para autenticar pelo navegador e escolha uma conta de anúncio padrão. Sua conta Ads Uploader existente e a conexão com Facebook fazem o trabalho pesado.
- Um npm install. Funciona em qualquer lugar com Node 18+.
- Faça login e autentique no navegador
- Sem variáveis de ambiente para armazenar, sem tokens para compartilhar com segurança com colegas de equipe
- Escolha uma conta padrão uma vez com ads account act_xxx, troque tão rápido quanto troca de diretório
Navegue pela conta sem sair do shell
O mesmo seletor de campanha, conjunto de anúncios e anúncio que você usa no app web, mas como comandos. Encontre o anúncio de onde quer copiar configurações, confirme um preset ID ou verifique performance sem abrir o Ads Manager.
- ads campaigns lista campanhas ativas na sua conta padrão
- Aprofunde com ads campaign, ads adset e ads ad
- Mostra títulos, corpo do texto, CTA, URL de destino e conjunto de anúncios pai
- Copie qualquer ad ID direto para um campo copyFromAd da especificação
Suba pastas, não arquivos um por um
Aponte a CLI para uma pasta de criativos e o lote inteiro vai direto para a biblioteca de mídia da Meta. O agrupamento de variações por sufixo de nome de arquivo funciona exatamente como no app web.
- ads upload ./meus-criativos sobe um diretório inteiro
- Variações 1:1, 4:5, 9:16 e 16:9 agrupadas automaticamente por nome de arquivo
- Retorna um batch ID para você referenciar no arquivo de especificação
- Funciona com pastas montadas do Google Drive, Dropbox e OneDrive
Um arquivo de especificação. Reutilizável. Comparável.
Em vez de clicar por telas de configuração, você descreve o lançamento em um arquivo JSON de especificação. Referencie um preset salvo ou copie de qualquer anúncio existente, depois adicione títulos, texto principal, padrões de nomenclatura e sobrescritas.
- Referencie um preset salvo por ID, o mesmo criado no app web
- Ou use copyFromAd para espelhar a configuração completa de um anúncio existente
- Sobrescreva textos, URLs, padrões de nomenclatura e aprimoramentos criativos
- Salve no git, compare na semana seguinte, entregue a um colega
Visualize antes de gastar
Todo lançamento começa com uma simulação. ads create:preview mostra exatamente o que seria criado, campanha, conjuntos de anúncios, anúncios, orçamentos e status, sem tocar na API da Meta. Encontre erros de configuração antes que custem dinheiro.
- A saída do dry run corresponde ao que a execução real criará
- Valida sua especificação contra o mesmo motor usado pelo app web
- Mostra campos ausentes, referências ruins ou combinações inválidas
- Sem chamadas de API, sem cobranças, sem risco
Veja anúncios entrarem no ar em tempo real
ads create executa o lançamento como um job em background e transmite o progresso para o terminal. A mesma pipeline que alimenta o app web cuida de rate limiting, novas tentativas, validação e variações criativas.
- Um comando publica o lote inteiro na Meta
- Progresso ao vivo para cada conjunto e anúncio conforme são criados
- Retome com ads jobs JOB_ID --follow se você se desconectar
- Lance ativo por padrão ou use --status PAUSED como rede de segurança
Entregue o fluxo inteiro a um agente de IA
A CLI vem com um arquivo de skill para colocar no Claude Code, Cursor ou qualquer agente que execute comandos shell. O agente lê criativos, escreve copy, monta a especificação, visualiza e lança, enquanto você continua no controle pelo terminal.
- Coloque SKILL.md em .claude/commands e o comando /ads aparece
- Cada comando tem uma única finalidade, para o agente continuar determinístico
- Arquivos de especificação dão ao agente um plano revisável antes de qualquer gasto
- Funciona junto com seu setup MCP para ciclos de análise até execução
Claude Code · /adsMeta Ads CLI vs. Ads Uploader CLI
Em 29 de abril de 2026, a Meta lançou meta-ads, um wrapper oficial gratuito de linha de comando para a Marketing API. Ele expõe a API um objeto por vez.
Fluxo de autenticação
- •Criar um app Meta personalizado
- •Provisionar um usuário de sistema
- •Atribuir seus ativos
- •Gerar um token de acesso com 7 escopos
- •Colar o token no .env
- •Compartilhar com segurança com colegas de equipe
- Rode ads login
- Autentique no navegador
- Cada colega de equipe faz login por conta própria
Lógica para casos de borda
- •Peculiaridades de formato ficam para você resolver
- •Sem agrupamento de variações por proporção
- •Toggles brutos de API para aprimoramentos criativos
- •Casos de borda aparecem em produção
- •Erros genéricos, sem lógica de nova tentativa
- Todos os formatos de anúncio suportados nativamente
- Variações de proporção agrupadas automaticamente
- Controle de aprimoramento criativo por objetivo
- Testado em produção em escala
- Novas tentativas e erros legíveis integrados
Configurações de anúncios herdadas
- •Defina cada campo da campanha
- •Defina cada campo do conjunto de anúncios
- •Defina cada campo do criativo
- •Especifique cada lançamento do zero
- Referencie qualquer anúncio existente
- Herde segmentação e posicionamentos
- Herde catálogos e pixels
- Sobrescreva apenas o que mudou
Lançar anúncios é tudo que fazemos. Projetamos nossas ferramentas para serem as melhores nisso, moldadas por milhões de dólares em verba de mídia nos nossos próprios negócios e marcas.
Chris Pollard Founder of Ads Uploader
Diferentes formas de interagir com a API da Meta são empolgantes, mas os casos de borda da API ainda machucam. Cobertura de formatos, lógica de novas tentativas, configurações válidas, herança de anúncios existentes: passamos anos codificando tudo isso no fluxo da Ads Uploader. Marketers lançam anúncios mais rápido conosco do que costurando chamadas de API por conta própria.
Uma CLI é a interface certa para um agente de IA da mesma forma que uma UI visual é para cliques. Mesmos marketers, contextos diferentes: foi por isso que criei a nossa. A Meta lançar a própria é uma validação bem-vinda.
O mesmo fluxo Ads Uploader. Agora guiado por você e seu agente.
Um arquivo de especificação, um comando, anúncios na sua conta.
Começar teste grátis de 7 diasTeste grátis de 7 dias
•Não precisa de cartão de crédito
•Cancele quando quiser