Meta Ads CLI

von Ads Uploader

Facebook Ads mit Claude Code launchen

Fahre deinen Ads Uploader Workflow mit unserer Meta Ads CLI direkt aus deinem Terminal. Dein KI Agent liest Creatives, schreibt Copy, baut den Spec und pusht durch Metas API. Validierung, Retries und Edge Cases werden alle nahtlos abgedeckt.

Terminal-First Workflow

Browse, upload, preview und launch direkt aus der Kommandozeile

Für KI-Agenten gebaut

Übergib es Claude Code, Cursor oder Codex mit einer einzigen Skill-Datei

Gleiches Backend wie die Web App

Deine Presets, Konten und Meta API Verbindung bleiben gleich

Einmal installieren, einmal authentifizieren

Global mit npm installieren, ads login zur Browser-Authentifizierung ausführen und ein Standard-Werbekonto wählen. Dein bestehender Ads Uploader Account und die Facebook-Verbindung erledigen den Rest.

  • Ein npm install. Läuft überall, wo Node 18+ läuft.
  • Login und Authentifizierung im Browser
  • Keine Environment-Variablen zum Speichern, keine Tokens, die du sicher mit Teammates teilen musst
  • Standardkonto einmal mit ads account act_xxx wählen, so schnell wechseln wie Verzeichnisse
~/projects
Live Demo
$

Konto durchsuchen, ohne die Shell zu verlassen

Der gleiche Kampagnen-, Ad-Set- und Ad-Picker wie in der Web App, nur als Befehle. Finde das Ad, dessen Settings du kopieren willst, prüfe eine Preset-ID oder scanne Performance, ohne den Ads Manager zu öffnen.

  • ads campaigns listet aktive Kampagnen deines Standardkontos
  • Mit ads campaign, ads adset und ads ad tiefer einsteigen
  • Zeigt Headlines, Body-Copy, CTA, Ziel-URL und das Eltern-Ad-Set
  • Spiele jede Ad ID direkt in ein copyFromAd Spec-Feld
Browse Account
Live Demo
$

Ordner hochladen, nicht Datei für Datei

Zeig der CLI einen Ordner mit Creatives und der ganze Batch geht direkt in Metas Media Library. Variant Grouping nach Dateinamen funktioniert genauso wie in der Web App.

  • ads upload ./meine-creatives lädt ein ganzes Verzeichnis hoch
  • 1:1, 4:5, 9:16 und 16:9 Varianten werden nach Dateiname gruppiert
  • Liefert eine Batch ID zurück, auf die du im Spec verweist
  • Funktioniert mit gemounteten Google Drive, Dropbox und OneDrive Ordnern
~/projects
Live Demo
$

Eine Spec-Datei. Wiederverwendbar. Diffbar.

Statt durch Konfigurationsmasken zu klicken, beschreibst du den Launch in einer JSON Spec-Datei. Verweise auf ein gespeichertes Preset oder kopiere von einem bestehenden Ad, dann ergänze Headlines, Primary Text, Naming-Patterns und Overrides.

  • Verweise per ID auf ein Preset, das gleiche wie in der Web App
  • Oder copyFromAd, um die volle Konfig eines Ads zu spiegeln
  • Override Texte, URLs, Naming-Patterns und Creative Enhancements
  • Speichere es in git, diffe es nächste Woche, übergib es dem Team
launch-spec.json
Live Demo
1
Reusable. Reviewable. Diffable.

Preview bevor du Geld ausgibst

Jeder Launch startet als Dry Run. ads create:preview zeigt exakt, was erstellt würde - Kampagne, Ad Sets, Ads, Budgets, Status - ohne Metas API zu berühren. Fehler abfangen, bevor sie kosten.

  • Dry-Run Output entspricht dem, was der Live-Run erzeugt
  • Validiert dein Spec mit der gleichen Engine wie die Web App
  • Findet fehlende Felder, falsche Referenzen oder ungültige Kombis
  • Keine API Calls, keine Kosten, kein Risiko
Preview · Dry Run
No live changes
$

Anzeigen live, in Echtzeit

ads create startet den Launch als Background Job und streamt den Fortschritt zurück ins Terminal. Die gleiche Pipeline wie die Web App - Rate Limiting, Retries, Validierung und Creative Variations alles abgedeckt.

  • Ein Befehl pusht den ganzen Batch zu Meta
  • Live-Progress für jedes Ad Set und Ad während es entsteht
  • Mit ads jobs JOB_ID --follow weitermachen, wenn die Verbindung weg ist
  • Standardmäßig aktiv oder --status PAUSED als Sicherheitsnetz
ads create · live job
Live Demo
Ready...
--:--:--Initializing...

Übergib den Workflow einem KI-Agenten

Die CLI bringt eine Skill-Datei mit, die du in Claude Code, Cursor oder jeden Agenten droppst, der Shell-Befehle ausführen kann. Der Agent liest Creatives, schreibt Copy, baut den Spec, previewt und launcht - du bleibst am Terminal im Loop.

  • SKILL.md in .claude/commands droppen und der /ads Command erscheint
  • Jeder Command macht genau eine Sache, der Agent bleibt deterministisch
  • Spec-Dateien geben dem Agenten einen reviewbaren Plan vor dem Spend
  • Spielt zusammen mit unserem Meta Ads MCP, wenn du lieber neben der Web App chattest
ClaudeClaude Code · /ads
Live Demo

Web, MCP und CLI. Ein Kreislauf.

Das Terminal sperrt dich nie ein. Gespeicherte Builds tragen einen Launch zwischen den Oberflächen: Starte ihn in der Web App, patche ihn aus einem Chat mit Claude oder ChatGPT über unseren Meta Ads MCP und bring ihn hier mit einem einzigen Befehl zu Ende. Dieselbe Build-Referenz öffnet sich überall.

  • Gespeicherte Builds und Presets werden auf jeder Oberfläche geteilt
  • Forke einen Build für eine Variante, ohne das Original anzufassen
  • Du chattest lieber neben der Web App? Genau das ist unser Meta Ads MCP
  • Starte wo du willst, mach fertig wo du willst, nichts ist festgeschrieben
One build, three surfaces
Live Demo
Web AppBuild started
Claude / ChatGPT·
CLI·
build_7fa2c9

Upload media, apply a preset, start the build

Same build reference on every surface. Nothing is locked in.

Meta Ads CLI vs. Ads Uploader CLI

Am 29. April 2026 hat Meta meta-ads veröffentlicht, einen kostenlosen offiziellen Command-Line-Wrapper für die Marketing API. Er legt die API Objekt für Objekt offen.

5 Portal Steps · 7 Scopes · Token in .env
Meta CLI
Manual setup in Meta Business Suite
1. Create a custom Meta app
2. Create a system user
3. Assign your assets to the user
4. Add the user as App Admin
5. Generate an access token (7 scopes)
Then in your terminal
$pip install meta-ads
$uv sync
$echo "ACCESS_TOKEN=..." > .env
$echo "AD_ACCOUNT_ID=..." >> .env
$meta auth status
✓ Authenticated
1 Browser Login · 0 Tokens to Share
Ads Uploader CLI
In your terminal
$npm install -g @adsuploader/cli
✓ ads command installed globally
$ads login
→ Opening browser for authentication...
✓ Authenticated as you@yourcompany.com
$ads account act_123456789012345
✓ Default account set
You're ready. Launch your first batch:
$ads upload ./creatives
$ads create my-launch.json
✓ 47 ads live in 3 minutes

Authentifizierungs-Workflow

Theirs
  • Eigene Meta App bauen
  • Einen System User anlegen
  • Deine Assets zuweisen
  • Einen Access Token mit 7 Scopes generieren
  • Den Token in .env einfügen
  • Sicher mit Teammates teilen
Ours
  • ads login ausführen
  • Im Browser authentifizieren
  • Jeder Teammate loggt sich selbst ein

Edge-Case-Logik

Theirs
  • Format-Eigenheiten musst du selbst abfangen
  • Kein Gruppieren von Seitenverhältnis-Varianten
  • Rohe API-Toggles für Creative Enhancements
  • Edge Cases tauchen erst in Production auf
  • Generische Fehler, keine Retry-Logik
Ours
  • Alle Ad-Formate nativ unterstützt
  • Seitenverhältnis-Varianten werden automatisch gruppiert
  • Per-Objective Steuerung der Creative Enhancements
  • In Production unter Last getestet
  • Retries und lesbare Fehler eingebaut

Geerbte Ad-Konfigurationen

Theirs
  • Jedes Kampagnen-Feld definieren
  • Jedes Ad-Set-Feld definieren
  • Jedes Creative-Feld definieren
  • Jeden Launch von Grund auf neu beschreiben
Ours
  • Auf jede bestehende Anzeige verweisen
  • Targeting und Placements erben
  • Kataloge und Pixel erben
  • Nur überschreiben, was sich geändert hat

Anzeigen launchen ist alles, was wir machen. Wir haben unser Tooling so designed, dass es genau darin am besten ist - geprägt von Millionen an Werbeausgaben für unsere eigenen Brands und Businesses.

Chris Pollard

Chris Pollard Gründer von Ads Uploader

Verschiedene Wege, mit Metas API zu arbeiten, sind spannend, aber die Edge Cases der API beißen trotzdem zu. Format-Coverage, Retry-Logik, valide Configs, Vererbung von bestehenden Anzeigen - wir haben Jahre damit verbracht, all das in den Ads Uploader Workflow zu encodieren. Marketer launchen Ads bei uns schneller, als wenn sie selbst API-Calls zusammenstückeln.

Eine CLI ist das richtige Interface für einen KI-Agenten, genauso wie ein visuelles UI das richtige für Klicks ist. Gleiche Marketer, andere Kontexte - deshalb habe ich unsere gebaut. Dass Meta jetzt eine eigene rausbringt, ist eine willkommene Bestätigung.

Der gleiche Ads Uploader Workflow. Jetzt von dir und deinem Agenten gefahren.

Eine Spec-Datei, ein Befehl, Anzeigen in deinem Konto.

7 Tage kostenlos testen

7 Tage kostenlos testen

Keine Kreditkarte nötig

Jederzeit kündbar