Zum Inhalt

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.json zusammen, 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

AgentAufgabe
ads-strategistZiel, Ereignis, Struktur, Budget, Konzepte mal Varianten, Testplan
ads-copywriterPrimärtext, Überschrift, Beschreibung, Handlungsaufruf, alternative Hooks
ads-creativePrüft Größen und Seitenverhältnisse, ordnet Feed- und 9:16-Dateien zu, nennt fehlende Formate
ads-audienceOrte, Alter, Advantage+-Zielgruppe, Retargeting-Zielgruppen
ads-trackingPixel auf der Zielseite, Ereignis, UTM-Parameter
ads-complianceWerberichtlinien, Sonderkategorien, EU-Begünstigter und Zahler, Behauptungen
ads-builderDer einzige Agent, der baut, aktiviert oder Budgets ändert
ads-qaUnabhängige Prüfung des Plans, bevor etwas gesendet wird
ads-analystErgebnisse, 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.
  • activate und budget laufen nur mit --confirm und 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.

Hilfe

Schau ins FAQ oder schreib dem Support.

Bleib auf dem Laufenden

Neue Packs, Updates, ab und zu ein Angebot.

Kein Spam. Abmeldung jederzeit.