Werbe-Tools bestehen fast nur aus Dashboards, und deshalb lassen sie sich fast nicht automatisieren. Ein Dashboard kannst du nicht per Cron ausführen, du kannst es nicht an jq weiterleiten, und du kannst einen Terminal-Agenten nicht bitten, darauf zu klicken. Die Hermoso CLI gibt es, damit die Anzeigenarbeit kein Ort mehr ist, den du besuchst, sondern etwas, das du skripten kannst.
Installieren und anmelden:
npm install -g hermoso
hermoso auth login
auth login startet einen Loopback-Listener und öffnet den Browser, dasselbe Muster, das gh und firebase verwenden. Du musst also nichts einfügen. Der erstellte Schlüssel wird nach ~/.hermoso/config.json geschrieben, mit Rechten nur für den Eigentümer (Verzeichnis 0700, Datei 0600), weil er echte Ausgabenbefugnis trägt. Für CI speichert hermoso auth login --token <key> einen Schlüssel ohne Rückfrage, und HERMOSO_TOKEN / HERMOSO_API_BASE überschreiben die Konfiguration aus der Umgebung.
Die Befehle
Jeder Befehl akzeptiert --json, und genau darum geht es: Die lesbare Zeile ist eine Zugabe, das JSON ist der verbindliche Vertrag.
| Befehl | Was er tut |
|---|---|
hermoso capabilities | Gültige Modell-IDs und ihre exakten Credit-Kosten. Führe diesen Befehl zuerst aus. Er ist kostenlos und nur lesend, und damit hörst du auf, Modellnamen zu raten. |
hermoso credits | Guthaben, Nutzung in der aktuellen Sitzung und zuletzt berechnete Aufrufe. |
hermoso brand --domain example.com | Liest eine Website in ein Markenprofil (Produkte, Farbpalette, Logo, Tonalität), auf dem spätere Renders aufbauen. |
hermoso competitors --domain example.com | Findet direkte Wettbewerber und ähnliche Marken, von denen sich lohnt zu lernen. |
hermoso ads --company "Brand" | Holt die tatsächlich laufenden Anzeigen dieses Werbetreibenden aus den Werbebibliotheken von Meta, Google und LinkedIn, dedupliziert und sortiert. |
hermoso research "longest-running protein bar ads" | Recherche in natürlicher Sprache über die Bibliotheken und zusätzlich organisches TikTok. Zurückgegeben werden die gefundenen Anzeigen. |
hermoso create --brand … --product … --format video | Macht aus einem Briefing ein fertiges Anzeigenkonzept: Textvarianten plus ein Bildkonzept oder ein Video-Storyboard, mit den Modell-IDs für das Rendering. |
hermoso generate image --prompt "…" --ref ./bottle.png | Rendert und gibt eine ausgelieferte URL zurück. --ref setzt dein echtes Produkt ein, sodass das Etikett im Bild deine tatsächliche SKU zeigt. |
hermoso jobs / hermoso fetch <url> | Prüft laufende Renders. Löst jedes Asset in eine anklickbare URL und eine direkte Download-URL auf. |
hermoso mcp | Stellt die vollständige MCP-Oberfläche mit über 922 Tools über stdio bereit, dieselben Tools, die der gehostete Server anbietet. |
Zwei Oberflächen, ein Paket, und warum das wichtig ist
Terminal-Agenten bezahlen Tools zweimal: einmal im Manifest, das sie im Kontext mitführen, und einmal in den Tokens, die jeder Aufruf kostet. Ein Manifest mit über 922 Tools ist nicht kostenlos. Deshalb liefert dasselbe Paket beide Oberflächen aus und überlässt dem Agenten die Wahl:
- MCP (
hermoso mcpoder der gehostetehttps://app.hermoso.ai/mcp), wenn du die volle Oberfläche und reich typisierte Argumente willst. - Unterprozess-Befehle, wenn du den token-sparsamen Weg willst: Der Agent ruft ein Programm auf, liest JSON und lädt nie ein Manifest. Dieses Muster nutzen die mitgelieferten Claude-Skills.
Beide greifen auf dieselbe API zu, rechnen dieselben Credits ab und schreiben in dieselbe Bibliothek. Auf keiner Seite bleibt also etwas hängen.
Was sich zu skripten lohnt
- Eine wöchentliche Mitbewerber-Analyse.
hermoso competitorsinhermoso adsleiten, mit der Vorwoche vergleichen, und du hast einen laufenden Bericht darüber, was dein Markt angefangen und aufgehört hat zu schalten. - Kreative Batches für einen Katalog. Schleife über die SKUs, rendere pro Produkt eine auf das Produkt gestützte Anzeige und sammle die zurückgegebenen URLs. Das ist die Art Arbeit, die in einer Oberfläche wirklich mühsam ist.
- Eine Credit-Sperre in CI.
hermoso credits --json | jq .balanceund lass die Pipeline fehlschlagen, bevor ein langer Batch gegen ein leeres Guthaben startet. - Modellauswahl mit Blick auf die Kosten.
hermoso capabilities --jsonliefert die exakten Kosten je Modell. Ein Skript kann damit das günstigste Modell wählen, das das Briefing erfüllt, statt ein Modell fest einzutragen.
Veröffentlichen und Kampagnen
Die CLI-Unterbefehle decken Recherche und Erstellung ab. Veröffentlichen, Planen und Kampagnenverwaltung auf Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads und AppLovin Ads liegen in der MCP-Oberfläche. Erreichbar sind sie aus demselben Paket mit hermoso mcp, über den gehosteten Endpunkt oder über das Web-Studio. Veröffentlichungsziele sind Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram und Google Business Profile.
Was ohne Rückfrage nicht passiert
Ein Agent mit Budget ist nur nützlich, wenn der mögliche Schaden begrenzt ist. Deshalb wird die Ausgabenkontrolle im Server durchgesetzt und nicht im Prompt. Meta-Kampagnen, Anzeigensets und Anzeigen werden PAUSED angelegt, und das lässt sich nicht überschreiben. Die Statusschalter, mit denen echte Werbeausgaben starten können (auf jeder Werbeplattform, darunter set_meta_campaign_status, set_google_ads_status, set_microsoft_ads_status, set_reddit_ads_status, set_linkedin_ads_status, set_pinterest_ads_status, set_x_ads_status und set_openai_ads_status), laufen nur mit einem ausdrücklichen Bestätigungs-Flag. Dieselbe Sperre gilt für das Anlegen einer aktivierten Google-Ads-Anzeigengruppe, Anzeige oder Keyword unter einem bereits aktivierten übergeordneten Element, weil dieses bei der nächsten Auktion ausgeliefert wird. Auch Löschungen erfordern eine Bestätigung. Auf der Generierungsseite veröffentlicht hermoso_capabilities die exakten Credit-Kosten jedes Modells, bevor etwas läuft. Jeder Render reserviert zunächst eine Schätzung und rechnet danach die tatsächlichen Kosten ab. Schlägt der Auftrag fehl, wird also erstattet, statt dich stillschweigend zu belasten.
Arbeitest du lieber in einem Agenten als in einer Shell? Siehe Marketing-Automatisierung mit Claude Code und die vollständige MCP- & CLI-Referenz.
Häufig gestellt
Gibt es ein Kommandozeilen-Tool zum Schalten von Anzeigen?
Ja. npm install -g hermoso installiert die Hermoso CLI. Sie recherchiert Mitbewerber-Anzeigen in den Werbebibliotheken von Meta, Google und LinkedIn, erstellt aus einer Website ein Markenprofil, plant und rendert fertige Bild- und Videoanzeigen und meldet Credits und Aufträge. Jeder Befehl hat eine --json-Ausgabe für Skripte. Dasselbe Paket stellt außerdem den vollständigen MCP-Server mit über 922 Tools über stdio bereit.
Wie authentifiziere ich mich bei der Hermoso CLI?
Führe hermoso auth login aus. Es öffnet eine Browser-Anmeldung über Loopback (dasselbe Muster wie gh und firebase) und speichert den erstellten Schlüssel unter ~/.hermoso/config.json mit Rechten nur für den Eigentümer (Verzeichnis 0700, Datei 0600). Für CI speichert hermoso auth login --token <key> einen Schlüssel ohne Rückfrage. HERMOSO_TOKEN und HERMOSO_API_BASE überschreiben die Konfiguration aus der Umgebung.
Kann ich die Ausgabe an jq weiterleiten?
Ja. Jeder Befehl akzeptiert --json und gibt ein strukturiertes Objekt aus. Das ist der vorgesehene Vertrag. Die lesbare Zeile ist nur eine Zugabe. hermoso credits --json | jq .balance ist eine nützliche Sperre in CI, bevor ein langer Render-Batch startet.
Warum die CLI statt des MCP-Servers nutzen?
Wegen der Token-Kosten. Ein MCP-Client lädt das Tool-Manifest in den Kontext, und über 922 Tools sind nicht kostenlos. Ein Terminal-Agent, der Unterprozess-Befehle aufruft und JSON liest, trägt gar kein Manifest mit sich. Beide Oberflächen greifen auf dieselbe API zu, rechnen dieselben Credits ab und schreiben in dieselbe Bibliothek, du kannst sie also mischen.
Kann die CLI auf Facebook veröffentlichen oder Meta-Anzeigen verwalten?
Veröffentlichen, Planen und Kampagnenverwaltung auf Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads und AppLovin Ads liegen in der MCP-Oberfläche und nicht in den CLI-Unterbefehlen. Erreichbar sind sie aus demselben Paket über hermoso mcp, über den gehosteten Endpunkt unter https://app.hermoso.ai/mcp oder über das Web-Studio. Veröffentlichungsziele sind Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram und Google Business Profile.
Funktioniert es mit einem lokalen Server?
Ja. Setze HERMOSO_API_BASE auf deinen eigenen Ursprung, zum Beispiel http://localhost:3000, dann zielen CLI und MCP-Server beide darauf. Eine localhost-Basis braucht kein Auth-Token.
Verwandt
Renders laufen als serverseitige Aufträge, die du abfragst. Ein wiederholter Post ist sicher, auch wenn das Ergebnis des ersten Versuchs unbekannt ist. Die Details stehen unter Aufträge und Idempotenz.
Richtest du es lieber direkt in Claude Code ein? Siehe Claude Code Marketing.
Installiere die CLI, melde dich im Browser an, und deine erste Mitbewerber-Analyse ist einen Befehl entfernt. Kostenloses Konto, über 250 verdienbare Gratis-Credits, keine Karte.
Kostenlos starten → MCP-Dokumentation lesen →