aiskillstore/marketplace

Wonda CLI

Wonda CLI ist ein Content-Erstellungs-Toolkit für terminalbasierte Agenten. Verwenden Sie es, um Bilder, Videos, Musik und Audio zu generieren; Medien zu bearbeiten und zusammenzustellen; auf sozialen Plattformen zu veröffentlichen; und Recherche/Automatisierung auf LinkedIn, Reddit und X/Twitter durchzuführen.

Installation

Wenn wonda nicht im PATH gefunden wird, installieren Sie es zuerst:

# npm
npm i -g @degausai/wonda

# Homebrew
brew tap degausai/tap && brew install wonda

Einrichtung

• Authentifizierung: wonda auth login (öffnet Browser, empfohlen) oder setzen Sie die Umgebungsvariable WONDA_API_KEY
• Überprüfung: wonda auth check

OAuth-Connector-Authentifizierung

Claude Web- und Cowork-Connector verwenden den Wonda OAuth 2.1-Flow anstelle eines CLI-API-Key-Felds. Der Connector meldet sich über Wonda im Browser an, gewährt den angeforderten Kontozugriff und erhält OAuth-Token, die an die Wonda-API-Ressource gebunden sind. Der Server tauscht diese Token nur innerhalb von Wonda gegen den internen API-Key des Kontos aus, sodass Agenten und Connector-Hosts den sk_...-Key nie sehen. Für die CLI und den lokalen stdio MCP-Pfad verwenden Sie weiterhin wonda auth login oder WONDA_API_KEY.

Claude Cowork lokales Relay

Claude Cowork (die Desktop-App) führt lokale MCP-Server auf dem Host aus, sodass es das .mcpb-Bundle oder eine lokale stdio wonda-mcp-Konfiguration direkt laden kann, inklusive WAB-Schreibvorgänge (verifiziert am 07.07.2026). Claude Web kann dies nicht. Das Wonda lokale Relay ist der alternative Pfad: Es ermöglicht dem REMOTE-Connector (Web oder Cowork), Aktionen auf dem eigenen Mac des Benutzers und der eigenen IP-Adresse auszuführen, ohne lokale MCP-Konfiguration:

1. Öffnen Sie https://wonda.sh/download während Sie angemeldet sind, und installieren Sie das notarisierte Mac-Paket.
2. Koppeln Sie das Relay mit wonda relay pair oder dem Browser-Handoff beim ersten Start. Dabei wird der vorhandene cli-auth-Flow mit einem Relay-bezogenen wrelay_...-Credential verwendet, das in der macOS-Tresor gespeichert ist. Bitten Sie den Benutzer nicht, einen API-Key oder Gerätecode einzugeben.
3. Öffnen Sie https://wonda.sh/setup, verbinden Sie LinkedIn, X und Reddit über den lokalen WAB, und genehmigen Sie dann den Wonda-Connector einmal in Claude.

Die Engine-Richtlinie lautet auto | my_machine | cloud. auto verwendet das lokale Relay, wenn es online ist, andernfalls die Cloud. my_machine darf nicht stillschweigend zurückfallen: Wenn das Relay offline ist, fragen Sie, ob auf die Cloud umgeschaltet werden soll.

Organisationen & Ausgabenkontext

Wondercat-Organisationen sind gemeinsame Geldbörsen mit eigenen Sitzen und Abrechnung. Mitglieder können aus dem Organisations-Guthaben ausgeben (anstatt ihrer persönlichen Credits), indem sie den Kontext wechseln:

• wonda organizations list (Aliase: wonda orgs list, wonda org list) – zeigt jede Organisation an, der Sie angehören, mit Ihrer Rolle und Sitzplatzplan.
• wonda use --org <slug> – dauerhafter Organisationskontext für diesen Rechner. Setzt X-Wonda-Org bei jeder Anfrage; Guthaben, Belastungen und wonda balance laufen über das Organisations-Guthaben.
• wonda use --personal – zurück zum persönlichen Kontext.
• wonda usage – ausgabenbezogene Nutzungszusammenfassung (Gesamt + Aufschlüsselung nach Modell + Projekt) für einen Zeitraum (--month 2026-05, oder --from/--to; Standard: aktueller Monat, UTC). --project <name> schränkt den Bericht auf ein Projekt ein. Im Organisationskontext wird die organisationsweite Nutzung inklusive einer Aufschlüsselung pro Mitglied gemeldet – erforderliche Rolle: Admin/Owner. Admins können auch einen vollständigen Excel-Bericht von der Organisationsseite im Web herunterladen.

Projekte (Ausgaben-Tagging)

Projekte ordnen Ausgaben einem benannten Arbeitsbereich zu, um die Überwachung zu erleichtern. Agenten sollten zu Beginn einer Aufgabe das aktive Projekt überprüfen (wonda use zeigt es an) und ein Projekt pro Aufgabe festlegen, wenn der Betreiber die Ausgaben nach Projekt verfolgt:

• wonda use --project <name> – dauerhaft: Jede nachfolgende Belastung trägt das Projekt (in wonda usage, der API und dem Organisations-Excel-Bericht). wonda use --no-project stoppt das Tagging; ein Wechsel des Organisations-/persönlichen Kontexts löscht das Projekt automatisch (Projekte sind pro Bereich).
• --project <name> bei jedem Befehl – einmalige Überschreibung für diesen Aufruf.
• wonda project list|create|delete – Verwaltung des Registers im aktiven Bereich. Organisationsprojekte werden nur von Organisations-Admins/Ownern erstellt; persönliche Projekte sind Self-Service. Ein Tagging gegen einen nicht existierenden Namen schlägt mit unknown_project fehl (keine stillen neuen Buckets, Tippfehler können die Überwachungsdaten nicht aufteilen).

wonda topup lädt immer Ihr persönliches Guthaben auf, unabhängig vom Kontext. Das Aufladen des Organisations-Guthabens (und die Konfiguration von automatischem Aufladen) ist nur für Admins möglich und erfolgt im Web unter /organizations/<slug>. Wenn einem Mitglied die Organisations-Credits ausgehen, teilt der Fehler mit, einen Admin zu fragen oder zum persönlichen Guthaben zurückzukehren – sie können das Organisations-Guthaben nicht über die CLI aufladen.

Rollen innerhalb einer Organisation sind getrennt vom Sitzplan:

• Owner: Der ursprüngliche Ersteller. Kann nicht herabgestuft oder entfernt werden. Kann die Eigentümerschaft von der Organisationsseite auf ein anderes Mitglied übertragen (selten).
• Admin: Kann einladen (einzeln oder per Masseneinfügen), entfernen, Rollen ändern, Sitzplätze ändern, aufladen, automatisches Aufladen konfigurieren, monatliche Limits ändern.
• User: Kann nur innerhalb des Organisations-Guthabens ausgeben (vorbehaltlich eines vom Admin festgelegten monatlichen Limits pro Mitglied).

Ein bezahlter Organisationssitz (WONDA / WONDA_PREMIUM) gewährt den gleichen bezahlten Funktionszugriff (Skills, usw.) wie ein persönlicher bezahlter Plan, jedoch nur im Organisationskontext. wonda use --personal fällt auf den persönlichen Kontoplan des Benutzers zurück.

Zugriffsstufen

Wonda ist nur gegen Bezahlung verfügbar: Jede Produktoberfläche (Generierung, Medien, Veröffentlichung, Scraping, Analyse, Skills, Cloud-Twin) erfordert einen bezahlten Plan. Neue Konten erhalten keine Credits und keinen Produktzugriff, bis sie ein Abonnement abschließen.

Stufe	Zugriff
Anonym (temporäres Konto, kein Login)	Kein Produktzugriff. Die CLI erstellt beim ersten Start ein temporäres Konto, erreicht aber nur die unten stehenden lokalen Befehle plus die Authentifizierungs-/Abrechnungsendpunkte. Führen Sie wonda auth login aus und schließen Sie dann ein Abonnement ab.
Free (eingeloggt, kein bezahlter Plan)	Kein Produktzugriff. Abonnieren Sie unter https://wonda.sh/account, um das Produkt zu nutzen.
WONDA ($19.99/Monat, "Pro")	Alles außer Cloud-Twin: Generierung (image/generate, video/generate, ...), Medien-Upload/-Download, Veröffentlichung, Scraping, Analysen, Videoanalyse, Skills (wonda skill install/list/get), Übergänge, Clipping, E-Mail, Reddit/LinkedIn-Kontoerstellung, Stile, Brand.
WONDA_PREMIUM ($49.99/Monat, "Premium")	Alles in WONDA, plus Cloud-Twin (wonda twin: Bereitstellung, geplante Ausführungen, gestreamter Login) mit Antidetect-/Schattenbann-Schutz, keine Begrenzungen und US-Kontoerstellung.
Flagged (per-Konto PostHog-Kill-Switches)	Im bezahlten Plan enthalten, aber dennoch durch ein Flag pro Konto steuerbar: wonda reddit signup (redditAccountCreationEnabled), wonda email (emailServerApiEnabled), öffentliche LinkedIn-Profilanreicherung (linkedinProfileEnrichmentEnabled).
Lokal (kein API-Aufruf, keine Credits, kein Plan)	Läuft vollständig auf Ihrem Rechner, daher ohne Plan nutzbar: wonda brand extract <url> (ohne --save), wonda compose motion/wonda compose text, wonda wab record <url>, wonda edit ... ffmpeg-Primitiv-Transformationen auf lokalen Dateien und wonda doctor. Die Chromium-basierten benötigen eine einmalige wonda wab install.

Wenn ein Befehl einen 403-Fehler (paid_plan_required) zurückgibt, abonnieren Sie unter https://wonda.sh/account.

Sprachklonung

Klonen Sie eine Stimme aus einem 10+ Sekunden langen Audio-Clip und verwenden Sie sie in TTS. Hartes Limit: 20 geklonte Stimmen pro Konto. Kosten: 1,50 $ pro Klon.

# Von einer lokalen Datei klonen (wird automatisch zuerst in die Medienbibliothek hochgeladen)
wonda voice create "Andu" --file ./sample.mp3 --description "Meine Stimme"

# Von vorhandenen Wonda-Medien klonen
wonda voice create "Brand" --media-id <uuid>

# Optionale Quell-Audio-Vorverarbeitung
wonda voice create "Clean" --file ./raw.wav --noise-reduction --normalize-volume

# Geklonte Stimmen auflisten (jede Zeile meldet isExpired und expiresInDays)
wonda voice list

# Eine Stimme
wonda voice get <voice-id>

# Umbenennen / Neubeschreiben (nur lokal, kein Provider-Aufruf)
wonda voice update <voice-id> --name "Neuer Name" --description "..."

# Löschen
wonda voice delete <voice-id>

Verwenden Sie eine geklonte Stimme in TTS, indem Sie die providerVoiceId von voice get als voiceId an /audio/speech übergeben:

wonda audio speech "Hallo Welt" \
  --model minimax-speech-2-8-hd \
  --params '{"voiceId":"<providerVoiceId>"}'

7-Tage-Ablauf: Geklonte Stimmen, die nicht innerhalb von 7 Tagen in TTS verwendet wurden, laufen automatisch ab. Die Ausführung von TTS mit einer geklonten Stimme verlängert automatisch deren Ablauf. Stimmen, die ungenutzt bleiben, müssen erneut geklont werden (wieder 1,50 $).

Credential-Tresor

Speichert Logins, die auf externen Plattformen (Instagram, TikTok, Twitter, usw.) erstellt wurden, für die Wiederverwendung beim nächsten Lauf. Passwörter werden mit AES-256-GCM mit einem serverseitigen Schlüssel verschlüsselt und nur bei get entschlüsselt.

# Erstellen
wonda credentials create --website instagram.com --username myhandle \
  --email [email protected] --password-stdin <<< "hunter2" \
  --metadata '{"signup_source":"wonda-email"}'

# Auflisten (Passwörter ausgelassen)
wonda credentials list --website instagram.com

# Vollständigen Datensatz inklusive entschlüsseltem Passwort abrufen
wonda credentials get <id>

# Beliebiges Feld aktualisieren (--password-stdin zum Rotieren; --username "" zum Leeren)
wonda credentials update <id> --username neuerhandle

# Löschen
wonda credentials delete <id>

# Abrufen + Grund der Verwendung in einem Aufruf – POST, nicht GET, weil
# es ein 'used'-Ereignis mit dem Grund schreibt. Bevorzugen Sie dies gegenüber `get`, wann immer Sie den Grund angeben können.
wonda credentials use <id> --reason "Instagram-Anmeldeflow"

# Aktuelle Ereignisse anzeigen (erstellt / verwendet / rotiert / aktualisiert) für die Überprüfung
wonda credentials events <id>

Felder: website (erforderlich – Eingabe wie insta wird zu instagram.com kanonisiert), username, email, password (erforderlich), metadata (beliebiges JSON). Mindestens eines von username / email muss vorhanden sein. Mehrere Datensätze pro (website, username) sind zulässig – deduplizieren Sie bei Bedarf auf Ihrer Seite.

Ereignisprotokoll: Jeder credentials get/use, create, Passwort-Rotation und andere Aktualisierungen werden als Ereignisse auf dem Credential aufgezeichnet (Akteur: cli | web | system). Verwenden Sie credentials events <id> oder das Verlaufssymbol in der Weboberfläche zur Überprüfung. Das Ereignisprotokoll ist append-only und wird beim Löschen des Credentials kaskadiert.

Globale Ausgabe-Flags

Alle Befehle unterstützen diese Ausgabesteuerungs-Flags:

• --json – JSON-Ausgabe erzwingen (automatisch aktiviert, wenn stdout weitergeleitet wird)
• --quiet – Nur die primäre Kennung ausgeben (Job-ID, Medien-ID usw.) – ideal für Skripte
• -o <pfad> – Ausgabe in Datei herunterladen (impliziert --wait)
• --fields status,outputs – Bestimmte JSON-Felder auswählen
• --jq '.outputs[0].media.url' – JSON-Ausgabe mit einem jq-Ausdruck filtern

CLI-Ankündigungen & Veraltungswarnungen

Bei jedem Befehl ruft die CLI GET /api/v1/updates ab (anonym, 1h Cache in ~/.wonda/state.json) für aktive Ankündigungen: Veraltungshinweise, Vorfälle, Upgrade-Aufforderungen. Nachrichten werden nur auf stderr ausgegeben, sodass stdout/JSON für die Weiterleitung sauber bleibt.

Veraltungshinweise pro Anfrage treffen als HTTP-Header Warning: 299 - "<message>" ein und werden vom HTTP-Client der CLI auf stderr als [deprecated METHOD /path] <message> ausgegeben.

Beide Kanäle lassen sich mit WONDA_QUIET=1 (Umgebungsvariable) oder --quiet (Flag) stummschalten. Nur die Netzwerk-Checks mit WONDA_NO_UPDATE_CHECK=1 deaktivieren.

WAB / Wonda Automation Browser (wonda wab)

Der Wonda Automation Browser (WAB) ist ein Premium-Stealth-Antidetect-Browser, der gehärtet ist, sodass Plattformen ihn nicht als Automatisierung erkennen können. wonda wab ist der eine Befehl für den Antidetect-Chromium-Stack (ein nicht erkannter Playwright-Fork). Er hat zwei Gesichter:

• Authentifizierte Sitzungen. Ein persistenter, headfuller Chromium pro Persona, der angemeldete Sitzungen für LinkedIn, X, Reddit und Co. hält. Die CLI startet ihn bei Bedarf, lässt ihn im Leerlauf auslaufen und leitet Plattform-Lese-/Schreibvorgänge durch ihn, wenn ein Befehl mit --via wab ausgeführt wird. Cookies leben im Chromium-Profil der Persona, nicht in ~/.wonda/config.json.
• Anonyme Erfassung. wonda wab record <url> (und wonda brand extract) treiben einen flüchtigen Chromium mit einem neuen Fingerabdruck an, ohne Persona, ohne Cookies. Siehe den record-Block unten.

Das mentale Modell: Sie haben Konten (eine Identität pro Plattform). Jeder Plattformbefehl leitet zu den Cookies dieses Kontos entweder über den flachen JSON-Speicher (--via cookies, schnell, kein Chromium) oder über die Persona (--via wab, Live-Antidetect-Chromium). Eine Persona ist die Chromium-Hülle, die mehrere Konten unter einem Fingerabdruck aufnehmen kann. In fast allen Fällen wird die Persona bei der ersten Verwendung von --via wab automatisch erstellt, benannt nach dem Konto, sodass Sie nie einen Persona-Namen eingeben müssen.

Die lokale wonda.mcpb Desktop-Erweiterung verwendet diesen gleichen lokalen WAB-Pfad von Claude Desktop oder Claude Code: Plattform-Cookies bleiben auf dem Gerät, Lesevorgänge verwenden lokale Cookies und Schreibvorgänge verwenden den lokalen WAB. Claude Web und Cowork benötigen stattdessen den Remote-MCP-Connector.

**Native Logins...