Meta Ads CLI
by Ads UploaderLancia inserzioni Facebook con Claude Code
Esegui il tuo workflow Ads Uploader dal terminale con la nostra Meta Ads CLI. Il tuo agente IA legge le creatività, scrive le copy, costruisce lo spec e pubblica tramite Meta API. Validazione, retry e edge case gestiti senza pensieri.
Sfoglia, carica, previsualizza e lancia dalla riga di comando
Affidala a Claude Code, Cursor o Codex con un solo file skill
Preset, account e connessione Meta restano gli stessi
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+.
- Accedi e autenticati nel tuo browser
- Niente variabili d'ambiente da memorizzare, niente token da condividere in modo sicuro con i compagni di team
- Scegli un account di default una volta con ads account act_xxx, cambialo veloce come cambi cartella
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
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
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
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
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
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
Meta Ads CLI vs. Ads Uploader CLI
Il 29 aprile 2026 Meta ha rilasciato meta-ads, un wrapper ufficiale gratuito da riga di comando per la Marketing API. Espone l'API un oggetto alla volta.
Workflow di autenticazione
- •Costruire una Meta app personalizzata
- •Provisioning di un system user
- •Assegnare i tuoi asset
- •Generare un access token con 7 scope
- •Incollare il token nel .env
- •Condividerlo in modo sicuro con i compagni di team
- Esegui ads login
- Autenticati nel tuo browser
- Ogni compagno di team fa il login da sé
Logica per gli edge case
- •Stranezze di formato lasciate a te da gestire
- •Nessun raggruppamento delle varianti per aspect ratio
- •Toggle API grezzi per le creative enhancement
- •Gli edge case emergono in produzione
- •Errori generici, nessuna logica di retry
- Tutti i formati di inserzione supportati nativamente
- Varianti per aspect ratio raggruppate in automatico
- Controllo delle creative enhancement per obiettivo
- Testato in produzione su grande scala
- Retry ed errori leggibili integrati
Configurazioni di inserzione ereditate
- •Definire ogni campo della campagna
- •Definire ogni campo dell'ad set
- •Definire ogni campo della creatività
- •Rispecificare ogni lancio da zero
- Referenzia qualsiasi inserzione esistente
- Eredita targeting e posizionamenti
- Eredita cataloghi e pixel
- Sovrascrivi solo quello che è cambiato
Lanciare inserzioni è tutto quello che facciamo. Abbiamo progettato i nostri tool per essere i migliori a farlo, plasmati da milioni di dollari di ad spend sui nostri brand e business.

Chris Pollard Founder of Ads Uploader
Modi diversi di interfacciarsi con la Meta API sono entusiasmanti, ma gli edge case dell'API mordono ancora. Copertura dei formati, logica di retry, config valide, ereditarietà dalle inserzioni esistenti - abbiamo passato anni a codificare tutto questo nel workflow di Ads Uploader. I marketer lanciano inserzioni più velocemente con noi che cucendo chiamate API da soli.
Una CLI è l'interfaccia giusta per un agente IA esattamente come una UI visiva lo è per i click. Stessi marketer, contesti diversi - per questo ho costruito la nostra. Che Meta rilasci la sua è una validazione benvenuta.
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 giorniProva gratuita di 7 giorni
•Nessuna carta di credito richiesta
•Cancella quando vuoi