Agentic Meta Ads
Neun Agenten bauen deine Meta-Kampagne. Du gibst sie frei.

Installation
Lade das ZIP über den Link aus der Mail (es liegt auch in deinem Konto) und entpacke es an einen festen Ort, zum Beispiel nach ~/VisionPictures/. Dann in Claude Code:
/plugin marketplace add ~/VisionPictures/VisionPictures-Agentic-Meta-Ads
/plugin install meta-ads@visionpictures
Claude Code neu starten (oder /reload-plugins). Im Terminal geht dasselbe mit claude plugin marketplace add … und claude plugin install meta-ads@visionpictures.
Voraussetzungen
- Claude Code (Terminal, Desktop-App oder IDE) und Python 3.8 oder neuer als
python3. Sonst nichts zu installieren. - Ein Meta-Business-Portfolio mit Facebook-Seite und einem Werbekonto mit Zahlungsart, am besten auch ein Instagram-Profikonto und ein Pixel auf deiner Website.
- Deine Bilder und Videos (4:5 oder 1:1 für den Feed, 9:16 für Stories und Reels) und eine Zielseite.
Konten verbinden
Sag in Claude Code: „set up Meta Ads“. Der Einrichtungs-Skill führt dich in neun Schritten durch Portfolio, Seite, Instagram, Werbekonto, App, Systemnutzer, Rechte, Token und Pixel. Er sagt dir genau, was du klickst, und prüft nach jedem Schritt mit doctor, ob alles stimmt.
Logins, Rechte und Zahlungsdaten gibst du selbst ein. Der Token geht aus der Zwischenablage direkt in ~/.config/meta-ads/credentials.env (Rechte 600) und nie in den Chat.
Erste Kampagne
Sag zum Beispiel:
Build a sales campaign for my cold brew. Germany and Austria, 50 EUR a day, images are in ./media, the shop is https://…
- Der Skill schreibt das Briefing und fragt einmal nach, was fehlt.
- Der Stratege plant Struktur, Budget und Testplan.
- Texter, Creative, Zielgruppe, Tracking und Richtlinien arbeiten parallel.
- Der Builder führt alles in
campaign-plan.jsonzusammen, der QA-Agent prüft den Plan unabhängig. - Meta prüft jedes Objekt im Testmodus (
validate_only), angelegt wird dabei nichts. - Du siehst die Zusammenfassung, danach entsteht alles pausiert. Nach Metas Prüfung zeigt der Skill Vorschauen.
- Aktiviert wird erst mit deinem Satz samt Betrag, zum Beispiel „Ja, starte mit 50 EUR am Tag.“
Später: „Wie laufen meine Anzeigen?“ startet die Auswertung mit dem Analysten.
Die Agenten
| Agent | Aufgabe |
|---|---|
ads-strategist | Ziel, Ereignis, Struktur, Budget, Konzepte mal Varianten, Testplan |
ads-copywriter | Primärtext, Überschrift, Beschreibung, Handlungsaufruf, alternative Hooks |
ads-creative | Prüft Größen und Seitenverhältnisse, ordnet Feed- und 9:16-Dateien zu, nennt fehlende Formate |
ads-audience | Orte, Alter, Advantage+-Zielgruppe, Retargeting-Zielgruppen |
ads-tracking | Pixel auf der Zielseite, Ereignis, UTM-Parameter |
ads-compliance | Werberichtlinien, Sonderkategorien, EU-Begünstigter und Zahler, Behauptungen |
ads-builder | Der einzige Agent, der baut, aktiviert oder Budgets ändert |
ads-qa | Unabhängige Prüfung des Plans, bevor etwas gesendet wird |
ads-analyst | Ergebnisse, Diagnose, nächster Test, Vorschläge; ändert nie etwas |
Kommandozeile
Die Agenten rufen das CLI selbst auf. Von Hand geht es so:
python3 <plugin>/skills/launch/scripts/metaads.py --help
python3 <plugin>/skills/launch/scripts/metaads.py doctor
python3 <plugin>/skills/launch/scripts/metaads.py plan check campaign-plan.json
python3 <plugin>/skills/launch/scripts/metaads.py build campaign-plan.json --validate
Weitere Befehle: connect, whoami, accounts, pages, instagram, pixels, audiences, campaigns, insights, media, plan init, upload, build, review, preview, activate, budget, pause. Mit --json für Maschinen.
Sicherheit
- Kampagnen, Anzeigengruppen und Anzeigen entstehen nur mit Status PAUSED.
activateundbudgetlaufen nur mit--confirmund deinem Satz, der den berechneten Tagesbetrag enthält. Jede Aktivierung steht in~/.config/meta-ads/audit.log.- Nur Facebook und Instagram. Audience Network, Messenger und Threads werden nie genutzt.
- Kein Löschbefehl. Pausieren geht immer.
- Keine Dubletten: Ein Bau ist über die Namen wiederholbar und läuft nach einem Abbruch weiter.
- Metas Ratenlimits werden eingehalten, standardmäßig eine Änderung je 15 Sekunden.
Grenzen von Version 1
Website-Ziele (Verkäufe, Leads, Traffic), ein Text je Anzeige, Tagesbudgets, Bild- und Videoanzeigen. Keine Sofortformulare, Kataloge oder App-Kampagnen und keine automatische Anlage von Zielgruppen. Getestet auf macOS; Linux und Windows sind noch nicht getestet.
Wichtig
Kein Erfolgsversprechen: Ergebnisse hängen von Angebot, Creatives, Markt, Budget und Metas Systemen ab. Werbekosten rechnet Meta über dein Werbekonto ab, du bist der Werbetreibende und verantwortlich für Inhalte und Rechte. Der Richtlinien-Agent gibt Hinweise, keine Rechtsberatung. Agentic Meta Ads ist nicht mit Meta Platforms verbunden. Volltext in DISCLAIMER.md im ZIP.
Entfernen
/plugin uninstall meta-ads@visionpictures
Danach ~/.config/meta-ads löschen und den Token in den Business-Einstellungen unter Systemnutzer widerrufen.
Lizenz
Eigene und Kundenprojekte. Keine Weitergabe und kein Weiterverkauf der Dateien. Volltext im ZIP und unter Lizenz.