Meta Ads CLI

Lance des pubs Facebook avec Claude Code

Pilote tout le workflow Ads Uploader depuis ton terminal. Un fichier JSON décrit le lancement ; la CLI gère la validation, les retries et l'API Meta. Commit les specs en git, diff-les la semaine d'après, passe-les à un teammate ou à un agent IA. Conçue pour le creative testing à grand volume, où le même lancement doit partir encore et encore.

Workflow tout-terminal

Browse, upload, preview et launch depuis la ligne de commande

Pensée pour les agents IA

Confie-la à Claude Code, Cursor ou Codex via un seul fichier skill

Même backend que l'app web

Tes presets, comptes et connexion Meta restent inchangés

Voir la CLI en action

Un walkthrough complet de l'install au lancement des pubs

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+.
  • OAuth via navigateur, pas de jonglage manuel de tokens
  • Compte par défaut en une fois avec ads account act_xxx
  • Change de compte aussi vite que de répertoire
~/projects
Live Demo
$

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
Browse Account
Live Demo
$

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
~/projects
Live Demo
$

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
launch-spec.json
Live Demo
1
Reusable. Reviewable. Diffable.

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
Preview · Dry Run
No live changes
$

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é
ads create · live job
Live Demo
Ready...
--:--:--Initializing...

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
ClaudeClaude Code · /ads
Live Demo

Le même workflow Ads Uploader. Pilotée maintenant par toi et ton agent.

Un fichier spec, une commande, des pubs dans ton compte.

Démarrer l'essai gratuit de 7 jours

Essai gratuit de 7 jours

Sans carte bancaire

Résiliable à tout moment