CLI Wonda
La CLI Wonda est une boîte à outils de création de contenu pour agents en terminal. Utilisez-la pour générer des images, vidéos, musique et audio ; éditer et composer des médias ; publier sur les réseaux sociaux ; et effectuer des recherches/automatisations sur LinkedIn, Reddit et X/Twitter.
Installation
Si wonda n'est pas trouvé dans le PATH, installez-le d'abord :
# npm
npm i -g @degausai/wonda
# Homebrew
brew tap degausai/tap && brew install wonda
Configuration
- Authentification :
wonda auth login(ouvre un navigateur, recommandé) ou définissez la variable d'environnementWONDA_API_KEY - Vérification :
wonda auth check
Authentification par connecteur OAuth
Les connecteurs Claude web et Cowork utilisent le flux OAuth 2.1 de Wonda au lieu d'un champ de clé API en 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 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 le bundle .mcpb ou une configuration stdio locale wonda-mcp directement, y compris les écritures WAB (vérifié le 07/07/2026). 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 propre Mac de l'utilisateur et son IP résidentielle sans aucune configuration MCP locale :
- Ouvrez
https://wonda.sh/downloadtout en étant connecté et installez le package Mac notarié. - Appairez le relais avec
wonda relay pairou via la transaction de navigateur au premier lancement. Cela utilise le fluxcli-authexistant avec un identifiantwrelay_...à portée de 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 graphique, 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 basculer silencieusement : 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 dépenses, les frais etwonda balancepassent par le portefeuille de l'org.wonda use --personal— retour au personnel.wonda usage— résumé d'utilisation (total + répartition par modèle + par projet) pour une période (--month 2026-05, ou--from/--to; par défaut le mois en cours, UTC).--project <nom>restreint le rapport à un seul projet. En contexte d'org, il rapporte l'utilisation à l'échelle de l'organisation, y compris une répartition par membre — rôle admin/propriétaire requis. Les administrateurs peuvent également télécharger un rapport Excel complet depuis la page de l'org 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 <nom>— persistant : chaque frais ultérieur porte le projet (danswonda usage, l'API et le rapport Excel de l'org).wonda use --no-projectarrête l'étiquetage ; le changement de contexte org/personnel efface automatiquement le projet (les projets sont par portée).--project <nom>sur n'importe quelle commande — remplacement unique pour cet appel.wonda project list|create|delete— gérer le registre dans la portée active. Les projets d'org sont créés uniquement par les admins/propriétaires de l'org ; les projets personnels sont en libre-service. L'étiquetage avec un nom qui n'existe pas échoue avecunknown_project(pas de nouveaux buckets silencieux, donc les fautes de frappe ne peuvent pas diviser les données de suivi).
wonda topup recharge toujours votre portefeuille personnel, quel que soit le contexte. Recharger le portefeuille de l'org (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 org, l'erreur lui demande de contacter un administrateur ou de repasser en personnel — il ne peut pas recharger le portefeuille org 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 pas être rétrogradé ou expulsé. Peut transférer la propriété à un autre membre depuis la page de l'org (rare).
- Administrateur : peut inviter (un ou plusieurs via collage), expulser, modifier les rôles, modifier les sièges, recharger, configurer le rechargement automatique, modifier les limites mensuelles.
- Utilisateur : peut uniquement dépenser dans le portefeuille de l'org (sous réserve d'une limite mensuelle par membre si l'administrateur en a défini une).
Un siège org payant (WONDA / WONDA_PREMIUM) accorde le même accès aux fonctionnalités payantes (compétences, etc.) qu'un plan personnel payant, mais uniquement dans le contexte de l'org. wonda use --personal revient au plan du compte personnel de l'utilisateur.
Niveaux d'accès
Wonda est payant uniquement : chaque surface produit (génération, médias, publication, scraping, analyse, compétences, jumeau cloud) nécessite un plan payant. Les nouveaux comptes n'ont aucun crédit et aucun accès aux produits jusqu'à ce qu'ils s'abonnent.
| Niveau | Accès |
|---|---|
| Anonyme (compte temporaire, sans connexion) | Aucun accès produit. La CLI crée un compte temporaire au premier lancement, mais il n'atteint que les commandes locales ci-dessous plus les points de terminaison d'authentification/facturation. 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 $/mois, « 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 comptes reddit/linkedin, styles, marque. |
| WONDA_PREMIUM (49,99 $/mois, « Premium ») | Tout ce qui est dans WONDA, plus le jumeau cloud (wonda twin : provisionnement, exécutions planifiées, connexion diffusée) avec protection antidetection / shadowban, 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). |
| Local (aucun appel API, aucun crédit, aucun plan) | Fonctionne entièrement sur votre machine, donc sans plan : wonda brand extract <url> (sans --save), wonda compose motion/wonda compose text, wonda wab record <url>, wonda edit ... transformations primitives ffmpeg sur des fichiers locaux, et wonda doctor. Ceux basés sur Chromium nécessitent une installation unique wonda wab install. |
Si une commande renvoie une 403 (paid_plan_required), abonnez-vous sur https://wonda.sh/account.
Clonage vocal
Clonez une voix à partir d'un clip audio de 10 s+ et utilisez-la en TTS. Limite stricte : 20 voix clonées par compte. Coût : 1,50 $ par clone.
# Cloner à partir d'un fichier local (téléversé automatiquement dans 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 en option
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>
Utilisez une voix clonée en TTS en passant le providerVoiceId de voice get comme voiceId à /audio/speech :
wonda audio speech "Bonjour le monde" \
--model minimax-speech-2-8-hd \
--params '{"voiceId":"<providerVoiceId>"}'
Expiration à 7 jours : les voix clonées qui n'ont pas été utilisées en TTS dans les 7 jours expirent automatiquement. Exécuter un TTS avec une voix clonée rafraîchit automatiquement son expiration. Les voix inactives qui expirent doivent être reclonées (1,50 $ à nouveau).
Coffre-fort d'identifiants
Persistez les connexions créées sur des plateformes externes (Instagram, TikTok, Twitter, etc.) pour pouvoir les réutiliser au prochain lancement. Les mots de passe sont chiffrés en AES-256-GCM avec une clé côté serveur et ne sont déchiffrés que sur 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 pivoter ; --username "" pour effacer)
wonda credentials update <id> --username nouveaupseudo
# Supprimer
wonda credentials delete <id>
# Récupérer et enregistrer la raison de l'utilisation en un appel — POST, pas GET, car
# cela écrit un événement 'utilisé' avec la raison. Préférez cela à `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é / pivoté / mis à jour) pour audit
wonda credentials events <id>
Champs : website (obligatoire — une entrée typée comme insta est normalisé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 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— Force la sortie JSON (activé automatiquement lorsque la sortie standard est redirigée)--quiet— Ne sort que l'identifiant principal (ID de tâche, ID de média, etc.) — idéal pour les scripts-o <chemin>— 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
Sur chaque commande, la CLI interroge GET /api/v1/updates (anonyme, cache de 1h 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 sur stderr uniquement, donc stdout/JSON reste propre pour le piping.
Les indices de dépréciation par requête arrivent sous forme d'en-tête HTTP standard Warning: 299 - "<message>" et sont transmis à stderr par le client HTTP de la CLI sous forme de [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 premium antidetection, renforcé pour que les plateformes ne puissent pas le reconnaître comme de l'automatisation. wonda wab est la commande unique pour la pile Chromium antidetection (un fork Playwright non détecté). Il a deux facettes :
- Sessions authentifiées. Un Chromium avec interface graphique persistant par personnage qui détient les sessions connectées pour LinkedIn, X, Reddit et autres. La CLI le lance à la demande, le laisse en veille et achemine les lectures/écritures de la plateforme via lui lorsqu'une commande s'exécute avec
--via wab. Les cookies vivent dans le profil Chromium du personnage, pas dans~/.wonda/config.json. - Capture anonyme.
wonda wab record <url>(etwonda brand extract) pilotent un Chromium éphémère avec une empreinte numérique fraîche, sans personnage, 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 via soit le magasin JSON plat (--via cookies, rapide, sans Chromium) soit le personnage du compte (--via wab, Chromium antidetection en direct). Un personnage est l'enveloppe Chromium qui peut contenir plusieurs comptes avec une seule empreinte. Dans presque tous les cas, le personnage est créé automatiquement lors de la première utilisation de --via wab, nommé d'après le compte, de sorte que vous ne tapez jamais de nom de personnage.
L'extension de bureau locale wonda.mcpb utilise ce même chemin WAB local depuis Claude Desktop ou Claude Code : les cookies de la plateforme restent sur l'appareil, les lectures utilisent les cookies locaux et les écritures utilisent le WAB local. Claude web et Cowork ont besoin du connecteur MCP distant à la place.
Connexion native
...
[la suite a été tronquée pour la traduction]