Wonda CLI
Wonda CLI est une boîte à outils de création de contenu pour les agents fonctionnant en terminal. Utilisez-la pour générer des images, vidéos, musique et audio ; éditer et composer des médias ; publier sur les plateformes sociales ; et effectuer des recherches/automatisation sur LinkedIn, Reddit et X/Twitter.
Installation
Si wonda n'est pas trouvé dans le PATH, installez-le d'abord. Les installations recommandées sont les installateurs de bureau signés (CLI + icône de la barre d'état + relais toujours actif, zéro étape supplémentaire) : macOS brew install --cask degausai/tap/wonda-app (ou le fichier wonda-macos.pkg depuis les releases), Windows winget/wonda-windows-setup.exe. Les canaux CLI uniquement ci-dessous fonctionnent partout et peuvent ajouter l'application de bureau plus tard avec wonda app install :
# npm
npm i -g @degausai/wonda
# Homebrew
brew tap degausai/tap && brew install wonda
Configuration
- Auth :
wonda auth login(ouvre le navigateur, recommandé) ou définissez la variable d'environnementWONDA_API_KEY - Vérification :
wonda auth check
Authentification du connecteur OAuth
Les connecteurs Claude web et Cowork utilisent le flux OAuth 2.1 de Wonda au lieu d'un champ de clé API dans la CLI. Le connecteur se connecte via Wonda dans le navigateur, accorde l'accès au compte demandé et reçoit des jetons OAuth liés à la ressource de l'API Wonda. Le serveur échange ces jetons contre la clé API interne du compte uniquement à l'intérieur de Wonda, de sorte que les agents et les hôtes du connecteur ne voient jamais la clé sk_.... Pour la CLI et le chemin MCP stdio local, continuez à utiliser wonda auth login ou WONDA_API_KEY.
Relais local Claude Cowork
Claude Cowork (l'application de bureau) exécute des serveurs MCP locaux sur l'hôte, il peut donc charger directement le bundle .mcpb ou une configuration locale stdio wonda-mcp, y compris les écritures WAB (vérifié le 2026-07-07). Claude web ne le peut pas. Le relais local Wonda est le chemin alternatif : il permet au connecteur DISTANT (web ou Cowork) d'exécuter des actions sur le Mac de l'utilisateur et sur son IP résidentielle sans aucune configuration MCP locale :
- Ouvrez
https://wonda.sh/downloadtout en étant connecté et installez le package Mac notarié. - Associez le relais avec
wonda relay pairou la première remise de main du navigateur. Ceci utilise le fluxcli-authexistant avec un identifiantwrelay_...propre au relais stocké dans le Trousseau macOS. Ne demandez pas à l'utilisateur de coller une clé API ou un code d'appareil. - Ouvrez
https://wonda.sh/setup, connectez LinkedIn, X et Reddit via le WAB local avec interface, puis approuvez le connecteur Wonda une fois dans Claude.
La politique du moteur est auto | my_machine | cloud. auto utilise le relais local lorsqu'il est en ligne et le cloud sinon. my_machine ne doit pas revenir silencieusement en arrière : si le relais est hors ligne, demandez s'il faut passer au cloud.
Organisations et contexte de dépenses
Les organisations Wondercat sont des portefeuilles partagés avec leurs propres sièges et facturation. Les membres peuvent dépenser à partir du portefeuille de l'organisation (au lieu de leurs crédits personnels) en changeant de contexte :
wonda organizations list(alias :wonda orgs list,wonda org list) — voir chaque organisation à laquelle vous appartenez avec votre rôle et votre plan de siège.wonda use --org <slug>— contexte d'organisation persistant pour cette machine. DéfinitX-Wonda-Orgsur chaque requête ; les retenues, les frais etwonda balancetransitent par le portefeuille de l'organisation.wonda use --personal— retour au contexte personnel.wonda usage— résumé d'utilisation uniquement pour les dépenses (total + détail par modèle + par projet) pour une période (--month 2026-05, ou--from/--to; par défaut le mois en cours, UTC).--project <name>restreint le rapport à un seul projet. En contexte d'organisation, il rapporte l'utilisation à l'échelle de l'organisation, y compris une ventilation par membre — rôle d'administrateur/propriétaire requis. Les administrateurs peuvent également télécharger un rapport Excel complet depuis la page de l'organisation sur le web.
Projets (étiquetage des dépenses)
Les projets attribuent les dépenses à un flux de travail nommé pour le suivi. Les agents doivent vérifier le projet actif au début de la tâche (wonda use l'affiche) et en définir un par tâche lorsque l'opérateur surveille les dépenses par projet :
wonda use --project <name>— persistant : chaque charge ultérieure porte le projet (danswonda usage, l'API et le rapport Excel de l'organisation).wonda use --no-projectarrête l'étiquetage ; le changement de contexte organisation/personnel efface automatiquement le projet (les projets sont par périmètre).--project <name>sur n'importe quelle commande — remplacement ponctuel pour cette invocation.wonda project list|create|delete— gérer le registre dans le périmètre actif. Les projets d'organisation sont créés uniquement par les administrateurs/propriétaires de l'organisation ; les projets personnels sont en libre-service. L'étiquetage avec un nom qui n'existe pas échoue avecunknown_project(pas de nouveaux compartiments silencieux, donc les fautes de frappe ne peuvent pas diviser les données de suivi).
wonda topup rechargé toujours votre portefeuille personnel, quel que soit le contexte. Recharger le portefeuille de l'organisation (et configurer le rechargement automatique) est réservé aux administrateurs et se fait sur le web à /organizations/<slug>. Si un membre manque de crédits d'organisation, l'erreur lui demande de contacter un administrateur ou de repasser en personnel — il ne peut pas recharger le portefeuille de l'organisation depuis la CLI.
Les rôles au sein d'une organisation sont distincts du plan de siège :
- Propriétaire: le créateur original. Ne peut être rétrogradé ni expulsé. Peut transférer la propriété à un autre membre depuis la page de l'organisation (rare).
- Administrateur: peut inviter (individuellement ou par lot via collage), expulser, changer les rôles, changer les sièges, recharger, configurer le rechargement automatique, modifier les limites mensuelles.
- Utilisateur: peut uniquement dépenser dans le portefeuille de l'organisation (soumis à une limite mensuelle par membre si l'administrateur en a défini une).
Un siège d'organisation payant (WONDA / WONDA_PREMIUM) accorde le même accès aux fonctionnalités payantes (compétences, etc.) qu'un plan personnel payant, mais uniquement en contexte d'organisation. wonda use --personal revient au plan du compte personnel de l'utilisateur.
Niveaux d'accès
Wonda est payant : chaque surface produit nécessite un plan payant, y compris les appels API, les lectures de plateforme locales, l'automatisation du navigateur, la composition de médias, l'édition de fichiers, les diagnostics, la génération, la publication, le scraping, l'analyse, les compétences, le fonctionnement du relais et le jumeau cloud. Avant qu'une commande produit n'effectue un travail, la CLI effectue une vérification des droits en direct auprès de Wonda. La vérification échoue de manière sécurisée lorsque l'accès ne peut pas être vérifié. Les nouveaux comptes n'ont aucun accès produit jusqu'à ce qu'ils s'abonnent, et un solde de crédit positif ne remplace pas un plan.
| Niveau | Accès |
|---|---|
| Anonyme (pas de connexion) | Aucun accès produit. L'authentification, la configuration, les tarifs, la découverte/sélection d'organisation, la complétion du shell et les commandes d'arrêt local restent disponibles pour que l'utilisateur puisse s'abonner, récupérer ou arrêter les services en arrière-plan. Exécutez wonda auth login, puis abonnez-vous. |
| Gratuit (connecté, sans plan payant) | Aucun accès produit. Abonnez-vous sur https://wonda.sh/account pour utiliser le produit. |
WONDA (19,99 $/mo, "Pro") | Tout sauf le jumeau cloud : génération (image/generate, video/generate, ...), téléchargement/téléversement de médias, publication, scraping, analyses, analyse vidéo, compétences (wonda skill install/list/get), transitions, découpage, email, création de compte reddit/linkedin, styles, marque. |
WONDA_PREMIUM (49,99 $/mo, "Premium") | Tout ce qui est dans WONDA, plus le jumeau cloud (wonda twin : provisionnement, exécutions planifiées, connexion diffusée) avec protection anti-détection / ombre, sans limites et création de comptes US. |
| Signalé (interrupteurs PostHog par compte) | Inclus dans le plan payant mais toujours verrouillable par un indicateur par compte : wonda reddit signup (redditAccountCreationEnabled), wonda email (emailServerApiEnabled), enrichissement de profil LinkedIn public (linkedinProfileEnrichmentEnabled). |
Si une commande renvoie une 403 (paid_plan_required), abonnez-vous sur https://wonda.sh/account.
Ceci s'applique également au chemin MCP stdio local car MCP exécute la même CLI. Les cookies et données de la plateforme restent sur l'appareil, mais la commande doit d'abord recevoir une décision d'accès payant réussie de GET /api/v1/auth/access. Une installation uniquement relais peut utiliser son identifiant wrelay_... pour cette sonde de droits. L'identifiant limité ne peut toujours pas appeler les API de compte ordinaires.
Clonage vocal
Clonez une voix à partir d'un clip audio de 10 s+ et utilisez-la dans la TTS. Limite stricte : 20 voix clonées par compte. Coût : 1,50 $ par clone.
# Cloner à partir d'un fichier local (téléversement automatique vers la médiathèque d'abord)
wonda voice create "Andu" --file ./sample.mp3 --description "Ma voix"
# Cloner à partir d'un média wonda existant
wonda voice create "Marque" --media-id <uuid>
# Prétraitement audio source facultatif
wonda voice create "Propre" --file ./raw.wav --noise-reduction --normalize-volume
# Lister les voix clonées (chaque ligne indique isExpired et expiresInDays)
wonda voice list
# Une voix
wonda voice get <voice-id>
# Renommer / re-décrire (local uniquement, sans appel au fournisseur)
wonda voice update <voice-id> --name "Nouveau Nom" --description "..."
# Supprimer
wonda voice delete <voice-id>
Utiliser une voix clonée dans TTS en passant le providerVoiceId de voice get comme voiceId à /audio/speech :
wonda audio speech "Bonjour tout le monde" \
--model minimax-speech-2-8-hd \
--params '{"voiceId":"<providerVoiceId>"}'
Expiration de 7 jours : les voix clonées qui n'ont pas été utilisées dans TTS pendant 7 jours expirent automatiquement. Lancer TTS avec une voix clonée renouvelle automatiquement son expiration. Les voix inactives qui expirent doivent être reclonées (1,50 $ à nouveau).
Coffre d'identifiants
Conservez les connexions créées sur des plateformes externes (Instagram, TikTok, Twitter, etc.) afin qu'elles puissent être réutilisées lors de la prochaine exécution. Les mots de passe sont chiffrés en AES-256-GCM avec une clé côté serveur et ne sont déchiffrés que lors du get.
# Créer
wonda credentials create --website instagram.com --username monpseudo \
--email [email protected] --password-stdin <<< "hunter2" \
--metadata '{"signup_source":"wonda-email"}'
# Lister (mots de passe omis)
wonda credentials list --website instagram.com
# Obtenir l'enregistrement complet, y compris le mot de passe déchiffré
wonda credentials get <id>
# Mettre à jour n'importe quel champ (utilisez --password-stdin pour faire tourner ; --username "" pour effacer)
wonda credentials update <id> --username nouveaupseudo
# Supprimer
wonda credentials delete <id>
# Récupérer + enregistrer la raison pour laquelle vous l'utilisez en un seul appel — POST, pas GET, car
# il écrit un événement 'utilisé' avec la raison. Préférez ceci à `get` chaque fois que vous
# pouvez articuler la raison.
wonda credentials use <id> --reason "flux d'inscription instagram"
# Voir les événements récents (créé / utilisé / tourné / mis à jour) pour audit
wonda credentials events <id>
Champs : website (obligatoire — une saisie typée comme insta est canonisée en instagram.com), username, email, password (obligatoire), metadata (JSON arbitraire). Au moins l'un de username / email doit être présent. Plusieurs enregistrements par (website, username) sont autorisés — dédupliquez de votre côté si nécessaire.
Journal des événements : chaque credentials get/use, create, rotation de mot de passe et autres mises à jour sont enregistrés comme événements sur l'identifiant (acteur : cli | web | system). Utilisez credentials events <id> ou l'icône d'historique de l'interface web pour auditer. Le journal des événements est en ajout seul et se propage en cascade lors de la suppression de l'identifiant.
Indicateurs de sortie globaux
Toutes les commandes prennent en charge ces indicateurs de contrôle de sortie :
--json— Forcer la sortie JSON (activé automatiquement lorsque stdout est redirigé)--quiet— Sortir uniquement l'identifiant principal (ID de tâche, ID de média, etc.) — idéal pour les scripts-o <path>— Télécharger la sortie vers un fichier (implique--wait)--fields status,outputs— Sélectionner des champs JSON spécifiques--jq '.outputs[0].media.url'— Filtrer la sortie JSON avec une expression jq
Annonces CLI et avertissements de dépréciation
À chaque commande, la CLI interroge GET /api/v1/updates (anonyme, cache de 1 h dans ~/.wonda/state.json) pour les annonces actives : avis de dépréciation, alertes d'incident, invites de mise à niveau. Les messages sont imprimés uniquement sur stderr, donc stdout/JSON reste propre pour la redirection.
Les conseils de dépréciation par requête arrivent via l'en-tête HTTP standard Warning: 299 - "<message>" et sont affichés sur stderr par le client HTTP de la CLI comme [deprecated METHOD /path] <message>.
Silencez les deux canaux avec WONDA_QUIET=1 (variable d'environnement) ou --quiet (indicateur). Désactivez uniquement les vérifications réseau avec WONDA_NO_UPDATE_CHECK=1.
WAB / Wonda Automation Browser (wonda wab)
Le Wonda Automation Browser (WAB) est un navigateur furtif anti-détection premium, durci pour que les plateformes ne puissent pas le reconnaître comme de l'automatisation. wonda wab est la commande unique pour la pile Chromium anti-détection (un fork Playwright non détecté). Il a deux faces :
- Sessions authentifiées. Un seul Chromium avec interface graphique persistant par persona qui contient les sessions connectées pour LinkedIn, X, Reddit et autres. La CLI le lance à la demande, le laisse tourner en veille et achemine les lectures/écritures de la plateforme via lui chaque fois qu'une commande s'exécute
--via wab. Les cookies vivent dans le profil Chromium de la persona, pas dans~/.wonda/config.json. - Capture anonyme.
wonda wab record <url>(etwonda brand extract) pilote un Chromium éphémère avec un nouvel fingerprint, sans persona, sans cookies. Voir le blocrecordci-dessous.
Le modèle mental : vous avez des comptes (une identité par plateforme). Chaque commande de plateforme achemine vers les cookies de ce compte soit via le magasin JSON plat (--via cookies, rapide, pas de Chromium) soit via la persona du compte (--via wab, Chromium anti-détection en direct). Une persona est l'enveloppe Chromium qui peut contenir plusieurs comptes sous un même fingerprint. Dans un
…
[tronqué pour la traduction]