Ads Uploader CLI
para Meta AdsLance Meta Ads em massa pelo terminal ou pelo seu agente de IA
A Ads Uploader CLI permite que você, ou um agente de IA como Claude Code ou Codex, lance Meta Ads em massa pelo terminal em todas as contas de anúncio que você gerencia. Aponte para um anúncio que você já roda e o novo lote copia as configurações, o público e os posicionamentos dele, na estrutura de campanhas e conjuntos de anúncios que você precisar. Cada lançamento é uma especificação que você vê em prévia antes de qualquer coisa ser criada. Funciona junto com a CLI oficial da Meta: a da Meta cria um objeto por comando, a nossa executa o lançamento inteiro.
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
- Defina uma conta padrão com ads account act_xxx, ou passe --account em cada lançamento para trabalhar entre contas de clientes
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
Comece todo lançamento 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 criar nada na 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
- Nada é criado na Meta, então nada é gasto
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.
- Copie SKILL.md para .claude/skills/ads e a skill /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
- Combina com o Ads Uploader MCP para quando você prefere conversar ao lado do app web
Web, MCP e CLI. Um circuito só.
O terminal nunca te prende. Builds salvos levam um lançamento de uma superfície a outra: comece um no app web, ajuste em um chat com Claude ou ChatGPT pelo Ads Uploader MCP e termine aqui com um comando. A mesma referência de build abre em todo lugar.
- Builds salvos e presets são compartilhados entre todas as superfícies
- Forke um build para uma variante sem tocar no original
- Prefere conversar ao lado do app web? Esse é o Ads Uploader MCP
- Comece em qualquer lugar, termine em qualquer lugar, nada fica travado
Upload media, apply a preset, start the build
CLI oficial da Meta 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 cria um objeto por comando e não tem comando em lote, então lançamentos em massa exigem loops de shell. A Ads Uploader CLI o complementa: a da Meta para relatórios e edições pontuais, a nossa para lançamentos em massa nas suas contas de anúncio. Nosso guia da Meta Ads CLI cobre a ferramenta da Meta por completo.
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
- •Sem camada documentada de novas tentativas ou de controle de ritmo
- 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