Meta Ads CLI
von Ads UploaderFacebook 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.
Browse, upload, preview und launch direkt aus der Kommandozeile
Übergib es Claude Code, Cursor oder Codex mit einer einzigen Skill-Datei
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
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
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
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
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
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
Ü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 deinem MCP-Setup für Analyse-zu-Execution Loops
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.
Authentifizierungs-Workflow
- •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
- ads login ausführen
- Im Browser authentifizieren
- Jeder Teammate loggt sich selbst ein
Edge-Case-Logik
- •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
- 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
- •Jedes Kampagnen-Feld definieren
- •Jedes Ad-Set-Feld definieren
- •Jedes Creative-Feld definieren
- •Jeden Launch von Grund auf neu beschreiben
- 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 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 testen7 Tage kostenlos testen
•Keine Kreditkarte nötig
•Jederzeit kündbar