Meta Ads CLI
par Ads UploaderLance des pubs Facebook avec Claude Code
Pilote ton workflow Ads Uploader depuis ton terminal avec notre Meta Ads CLI. Ton agent IA lit les creatives, écrit les copys, monte le spec et pousse via l'API Meta. Validation, retries et edge cases gérés sans accroc.
Browse, upload, preview et launch depuis la ligne de commande
Confie-la à Claude Code, Cursor ou Codex via un seul fichier skill
Tes presets, comptes et connexion Meta restent inchangés
Installe une fois, authentifie-toi une fois
Installe globalement avec npm, lance ads login pour t'authentifier dans le navigateur, puis choisis un compte publicitaire par défaut. Ton compte Ads Uploader et ta connexion Facebook font le reste.
- Un npm install. Partout où tourne Node 18+.
- Connecte-toi et authentifie-toi dans ton navigateur
- Pas de variables d'environnement à stocker, pas de tokens à partager en sécurité avec tes teammates
- Choisis un compte par défaut une bonne fois avec ads account act_xxx, puis change-en aussi vite que tu changes de répertoire
Explore ton compte sans quitter le shell
Le même picker de campagnes, ad sets et ads que dans l'app web, mais en commandes. Trouve la pub dont tu veux copier la config, valide un preset ID ou regarde les performances sans ouvrir Ads Manager.
- ads campaigns liste les campagnes actives de ton compte
- Plonge plus loin avec ads campaign, ads adset et ads ad
- Affiche headlines, body, CTA, URL de destination et l'ad set parent
- Pousse n'importe quel ad ID direct dans un champ copyFromAd
Upload des dossiers, pas des fichiers un par un
Pointe la CLI sur un dossier de creatives et tout le batch part direct dans la media library Meta. Le grouping de variantes par suffixe de nom marche exactement comme dans l'app web.
- ads upload ./mes-creatives upload tout un répertoire
- Variantes 1:1, 4:5, 9:16 et 16:9 groupées par nom de fichier
- Renvoie un batch ID que tu référence dans ton spec
- Fonctionne avec Google Drive, Dropbox et OneDrive montés
Un seul fichier spec. Réutilisable. Diffable.
Au lieu de cliquer dans des écrans de config, tu décris le lancement dans un fichier JSON. Référence un preset enregistré ou copie depuis une pub existante, puis ajoute headlines, texte principal, patterns de noms et overrides.
- Référence un preset par ID, le même que dans l'app web
- Ou copyFromAd pour cloner toute la config d'une pub existante
- Override textes, URLs, noms et creative enhancements
- Commit-le en git, diff-le la semaine suivante, partage-le à l'équipe
Preview avant de dépenser
Chaque lancement commence par un dry run. ads create:preview montre exactement ce qui serait créé - campagne, ad sets, ads, budgets, status - sans toucher l'API Meta. Choppe les erreurs avant qu'elles coûtent quelque chose.
- Le dry-run reflète exactement ce que le run live va créer
- Valide ton spec avec le même moteur que l'app web
- Détecte champs manquants, mauvaises références ou combos invalides
- Zéro appel API, zéro coût, zéro risque
Regarde les pubs partir en live, en temps réel
ads create lance le launch comme un job en background et stream le progrès dans ton terminal. La même pipeline qui fait tourner l'app web - rate limiting, retries, validation et variantes creatives, tout est géré.
- Une commande pousse tout le batch sur Meta
- Progrès live pour chaque ad set et ad au moment de la création
- Reprends avec ads jobs JOB_ID --follow si tu te déconnectes
- Actif par défaut ou --status PAUSED comme filet de sécurité
Confie tout le workflow à un agent IA
La CLI ship avec un fichier skill que tu drop dans Claude Code, Cursor ou n'importe quel agent capable de lancer des commandes shell. L'agent lit les creatives, écrit les copys, monte le spec, preview et launch - toi tu restes au terminal.
- Drop SKILL.md dans .claude/commands et la commande /ads apparaît
- Chaque commande fait une seule chose, l'agent reste déterministe
- Les specs donnent à l'agent un plan relisable avant tout spend
- Marche avec ton setup MCP pour boucler analyse-vers-exécution
Claude Code · /adsMeta Ads CLI vs. Ads Uploader CLI
Le 29 avril 2026, Meta a sorti meta-ads, un wrapper officiel et gratuit en ligne de commande pour la Marketing API. Il expose l'API un objet à la fois.
Workflow d'authentification
- •Crée une app Meta custom
- •Provisionne un system user
- •Assigne tes assets
- •Génère un access token avec 7 scopes
- •Colle le token dans .env
- •Partage-le en sécurité avec tes teammates
- Lance ads login
- Authentifie-toi dans ton navigateur
- Chaque teammate se connecte lui-même
Logique des edge cases
- •Les bizarreries de format restent à ta charge
- •Pas de grouping des variations par aspect ratio
- •Toggles API bruts pour les creative enhancements
- •Les edge cases sortent en production
- •Erreurs génériques, pas de retry logic
- Tous les formats de pubs supportés nativement
- Variations par aspect ratio groupées automatiquement
- Contrôle des creative enhancements par objectif
- Testé en production à grande échelle
- Retries et erreurs lisibles intégrés
Configurations de pubs héritées
- •Définis chaque champ de campagne
- •Définis chaque champ d'ad set
- •Définis chaque champ de creative
- •Re-spécifie chaque lancement de zéro
- Référence n'importe quelle pub existante
- Hérite du targeting et des placements
- Hérite des catalogs et pixels
- Override seulement ce qui change
Lancer des pubs, c'est tout ce qu'on fait. On a conçu nos outils pour être les meilleurs là-dessus, façonnés par des millions de dollars de spend publicitaire sur nos propres marques et business.
Chris Pollard Fondateur d'Ads Uploader
Différentes façons d'interfacer avec l'API Meta, c'est excitant, mais les edge cases de l'API mordent toujours. Couverture des formats, retry logic, configs valides, héritage depuis des pubs existantes - on a passé des années à encoder tout ça dans le workflow Ads Uploader. Les marketers lancent des pubs plus vite avec nous qu'en bricolant les appels API eux-mêmes.
Une CLI est la bonne interface pour un agent IA, comme une UI visuelle l'est pour les clics. Mêmes marketers, contextes différents - c'est pour ça que j'ai construit la nôtre. Que Meta sorte la sienne, c'est une validation bienvenue.
Le même workflow Ads Uploader. Piloté maintenant par toi et ton agent.
Un fichier spec, une commande, des pubs dans ton compte.
Démarrer l'essai gratuit de 7 joursEssai gratuit de 7 jours
•Sans carte bancaire
•Résiliable à tout moment