Meta Ads CLI

Lancia inserzioni Facebook con Claude Code

Esegui l'intero workflow Ads Uploader direttamente dal tuo terminale. Un file JSON descrive il lancio; la CLI si occupa di validazione, retry e Meta API. Salva gli spec in git, fai diff la settimana dopo, passali a un collega o a un agente IA. Pensata per il creative testing ad alto volume, dove lo stesso lancio deve partire ancora e ancora.

Workflow tutto-terminale

Sfoglia, carica, previsualizza e lancia dalla riga di comando

Pensata per gli agenti IA

Affidala a Claude Code, Cursor o Codex con un solo file skill

Stesso backend della web app

Preset, account e connessione Meta restano gli stessi

Guarda la CLI in azione

Un walkthrough completo dall'installazione al lancio degli annunci

Installa una volta, autenticati una volta

Installa globalmente con npm, esegui ads login per autenticarti tramite browser e scegli un account pubblicitario di default. Il tuo account Ads Uploader e la connessione Facebook fanno il resto.

  • Un npm install. Gira ovunque ci sia Node 18+.
  • OAuth via browser, niente token da gestire a mano
  • Account di default in un colpo con ads account act_xxx
  • Cambia account veloce come cambi cartella
~/projects
Live Demo
$

Sfoglia l'account senza uscire dalla shell

Lo stesso selettore di campagne, ad set e annunci della web app, ma come comandi. Trova l'annuncio da cui copiare le impostazioni, conferma un preset ID o controlla le performance senza aprire Ads Manager.

  • ads campaigns elenca le campagne attive del tuo account
  • Approfondisci con ads campaign, ads adset e ads ad
  • Mostra headline, body, CTA, URL di destinazione e l'ad set padre
  • Pesca qualsiasi ID direttamente in un campo copyFromAd
Browse Account
Live Demo
$

Carica cartelle, non file uno a uno

Punta la CLI a una cartella di creatività e tutto il batch va dritto nella media library di Meta. Il raggruppamento per suffisso del nome funziona uguale alla web app.

  • ads upload ./miei-creativi carica un'intera directory
  • Varianti 1:1, 4:5, 9:16 e 16:9 raggruppate dal nome file
  • Restituisce un batch ID da referenziare nel file spec
  • Funziona con Google Drive, Dropbox e OneDrive montati
~/projects
Live Demo
$

Un file spec. Riutilizzabile. Diffabile.

Invece di cliccare schermate di configurazione, descrivi il lancio in un file JSON. Referenzia un preset salvato o copia da un annuncio esistente, poi sovrapponi headline, primary text, naming pattern e override.

  • Referenzia un preset per ID, lo stesso che usi sulla web app
  • O copyFromAd per replicare l'intera config di un annuncio
  • Override testi, URL, naming pattern e creative enhancement
  • Salvalo in git, fai diff la settimana dopo, passalo al team
launch-spec.json
Live Demo
1
Reusable. Reviewable. Diffable.

Previsualizza prima di spendere

Ogni lancio inizia con un dry run. ads create:preview mostra esattamente cosa verrebbe creato - campagna, ad set, annunci, budget, stato - senza toccare la Meta API. Becca gli errori prima che costino.

  • Il dry run mostra esattamente quello che il run live creerà
  • Valida lo spec con lo stesso motore della web app
  • Trova campi mancanti, riferimenti errati o combinazioni invalide
  • Zero chiamate API, zero costi, zero rischio
Preview · Dry Run
No live changes
$

Annunci live in tempo reale

ads create esegue il lancio come job in background e trasmette il progresso al terminale. La stessa pipeline che muove la web app - rate limiting, retry, validazione e variazioni creative, tutto gestito.

  • Un comando pubblica l'intero batch su Meta
  • Progresso live per ogni ad set e annuncio mentre nasce
  • Riprendi con ads jobs JOB_ID --follow se ti disconnetti
  • Attivo di default o --status PAUSED come rete di sicurezza
ads create · live job
Live Demo
Ready...
--:--:--Initializing...

Affida l'intero workflow a un agente IA

La CLI include un file skill da droppare in Claude Code, Cursor o qualunque agente in grado di eseguire comandi shell. L'agente legge le creatività, scrive le copy, costruisce lo spec, previsualizza e lancia - tu resti sul terminale.

  • Trascina SKILL.md in .claude/commands e compare il comando /ads
  • Ogni comando fa una cosa sola, così l'agente resta deterministico
  • Gli spec danno all'agente un piano rivedibile prima di ogni spesa
  • Si integra con il tuo MCP per chiudere il loop analisi-esecuzione
ClaudeClaude Code · /ads
Live Demo

Lo stesso workflow Ads Uploader. Ora guidato da te e dal tuo agente.

Un file spec, un comando, annunci nel tuo account.

Inizia la prova gratuita di 7 giorni

Prova gratuita di 7 giorni

Nessuna carta di credito richiesta

Cancella quando vuoi