CLI-Konfiguration

Aktuell in Beta und nicht für Trial-Nutzer verfügbar. Zahlende Nutzer können unter [email protected] Zugriff anfragen.

Der beste Weg, mit dem CLI (Command Line Interface) zu starten, ist zu verstehen, wie Ads Uploader funktioniert. Das CLI folgt exakt derselben Struktur wie die Web-App. Wenn du die Web-App verstehst und dort schon Anzeigen hochgeladen hast, wird dir das CLI sofort vertraut sein.

Alle Presets, die du im Web-Interface baust, stehen auch im CLI zur Verfügung. Manche Nutzer finden es am einfachsten, ihre Presets in der App einzurichten und für das Tagesgeschäft aufs CLI zu wechseln. Alles bleibt aus dem CLI heraus voll anpassbar.

Warum das CLI nutzen? Es bietet ein anderes Interface mit agentischem Fokus auf derselben erprobten Ads Uploader-Infrastruktur. Das Laden mehrerer Batches ist schneller, und du kannst KI nutzen, um Anzeigentext zu schreiben und Anzeigen-Builds zusammenzustellen. Es ist eine weitere Art, Ads Uploader zu verwenden.

Die meisten Nutzer steuern das CLI über einen KI-Agenten wie Claude Code oder Cursor. Siehe Nutzung mit KI am Ende dieser Seite, wie du das CLI an einen Agenten übergibst, sobald alles eingerichtet ist.

Installation und Authentifizierung

Installiere das CLI global mit npm install -g @adsuploader/cli (benötigt Node.js 18+), dann führe ads login aus, um dich per Browser zu authentifizieren. Das nutzt dein bestehendes Ads Uploader-Konto und deine Facebook-Verbindung.

Führe den Login-Befehl auf demselben Gerät aus, auf dem du bei adsuploader.com angemeldet bist, da der Auth-Flow ein Browserfenster öffnet, um deine Identität zu verifizieren.

Konto einrichten

Einmal eingeloggt, führe ads accounts aus, um alle mit deinem Meta-Konto verbundenen Werbekonten zu sehen, dann ads account act_123456789, um deinen Standard festzulegen. Das ist derselbe Kontoauswahl-Dialog wie in der Web-App.

Konto durchsuchen

Bevor du Anzeigen erstellst, kannst du deine gesamte Kontostruktur aus dem CLI durchsuchen - genauso wie du dich in der Web-App durch Kampagnen, Ad Sets und Anzeigen klicken würdest.

So findest du die Anzeige, deren Einstellungen du kopieren willst, oder bestätigst, welches Preset du in deiner Spec-Datei verwenden willst.

Medien hochladen

Lade Bilder und Videos in die Medienbibliothek deines Werbekontos mit ads upload:

ads upload hero.jpg banner.mp4 promo.mp4
ads upload ./my-creatives/

Das gibt eine Batch-ID zurück, die du beim Anlegen von Anzeigen referenzierst. Führe ads uploads aus, um deine letzten Batches zu sehen.

Varianten-Gruppierung funktioniert automatisch, wenn du Dateien mit Verhältnis-Suffixen benennst, genau wie in der Web-App. Wie du Dateien korrekt benennst, findest du unter Seitenverhältnis-Varianten.

Anzeigen erstellen

Die Anzeigenerstellung hat zwei Schritte: preview und create.

Die Spec-Datei

Eine JSON-Spec-Datei sagt dem CLI, was gebaut werden soll. Die einfachste Spec referenziert ein gespeichertes Preset und deinen Upload-Batch:

{ "adPresetId": "your_preset_id", "uploadId": "batch_abc123" }

Du kannst auch Einstellungen einer bestehenden Anzeige kopieren, statt ein Preset zu verwenden:

{ "copyFromAd": "120233848667930472", "uploadId": "batch_abc123" }

Die richtige Anzeigen-ID findest du über ads campaigns, ads campaign <id>, ads adset <id> und ads ad <id>.

Erst Preview

Preview immer vor dem Erstellen. Führe ads create:preview spec.json aus, um exakt zu sehen, was erstellt würde, ohne Facebook zu berühren. So werden Konfigurationsfehler abgefangen, bevor etwas live geht.

Erstellen

Wenn du mit dem Preview zufrieden bist, führe ads create spec.json aus. Anzeigen gehen standardmäßig live, wie in der Web-App. Um sie stattdessen pausiert zu erstellen, ergänze --status PAUSED oder setze "options": { "status": "PAUSED" } in der Spec.

Vollständige Referenz

Das komplette Spec-Format, alle Befehle, Flags, Creative-Enhancements-, Carousel- und Flexible-Ad-Konfigurationen, Anzeigen-Namens-Platzhalter und gängige Muster findest du in der CLI-Vollständigen Referenz.

Job-Tracking

Die Anzeigenerstellung läuft im Hintergrund. Das CLI streamt den Fortschritt automatisch, aber du kannst einen Job auch später prüfen:

Tipps

• Immer zuerst Preview. create:preview fängt Konfigurationsfehler ab, bevor Facebook berührt wird.
• Anzeigen gehen standardmäßig live. Nutze --status PAUSED, wenn du sie erst in Ads Manager prüfen willst.
• Uploads sind an ein Konto gebunden. Die Batch-ID funktioniert nur mit dem Konto, in das du hochgeladen hast.
• Presets sind aus der Web-App übernommen. Baue deine Presets in der Web-UI und referenziere sie im CLI per ID.
• Führe ads config aus, um dein Setup zu prüfen. Zeigt dein aktuelles Konto, die API-URL und den Pfad zu den Anmeldedaten.

Nutzung mit KI

Das CLI ist darauf ausgelegt, von KI-Agenten wie Claude Code oder Cursor gesteuert zu werden. Wenn du installiert und authentifiziert hast, registriere die Skill-Datei, damit dein Agent jeden Befehl und jede Spec-Option auf dieser Seite versteht.

Die Skill-Datei liegt im npm-Paket unter node_modules/@adsuploader/cli/SKILL.md. In Claude Code richte sie als eigenen Slash-Befehl ein (z. B. /ads):

mkdir -p .claude/commands
cp node_modules/@adsuploader/cli/SKILL.md .claude/commands/ads.md

Dann tippst du /ads in Claude Code, um das Skill zu laden, bevor du Anweisungen gibst. Für andere KI-Tools wie Cursor fügst du SKILL.md als Rule oder Kontext-Datei hinzu.

Sicherheit. Die CLI-Authentifizierung ist an deine IP-Adresse gebunden, und pro Konto kann immer nur ein Ad-Creation-Job gleichzeitig laufen. Das CLI ist nicht dafür gedacht, in andere Anwendungen eingebunden zu werden. Es ist ein alternatives Interface für fortgeschrittene Media-Buyer.

Beispiel-Prompt

Sobald alles eingerichtet ist, gib deinem KI-Agenten Anweisungen wie:

Ich habe einen Haufen neuer Ad-Creatives in meinem downloads/ads-Ordner. Lade sie hoch und erstelle Anzeigen mit denselben Einstellungen wie mein Sales-Purchase-Kampagnen-Preset. Gruppiere sie in Ad Sets zu je fünf, benannt mit dem heutigen Datum, mit $25 Tagesbudget. Schreibe für jedes Bild einen eigenen Text basierend auf dem Bildinhalt. Auf Ad-Set-Ebene pausieren und erst Preview ausführen.