Wonda CLI
Wonda CLI es un kit de herramientas de creación de contenido para agentes basados en terminal. Úsalo para generar imágenes, videos, música y audio; editar y componer medios; publicar en plataformas sociales; e investigar o automatizar en LinkedIn, Reddit y X/Twitter.
Instalación
Si wonda no se encuentra en PATH, instálalo primero:
# npm
npm i -g @degausai/wonda
# Homebrew
brew tap degausai/tap && brew install wonda
Configuración
- Autenticación:
wonda auth login(abre el navegador, recomendado) o establece la variable de entornoWONDA_API_KEY. - Verificación:
wonda auth check
Autenticación mediante conector OAuth
Los conectores de Claude web y Cowork utilizan el flujo OAuth 2.1 de Wonda en lugar de un campo de clave API en CLI. El conector inicia sesión a través de Wonda en el navegador, concede el acceso solicitado a la cuenta y recibe tokens OAuth vinculados al recurso de la API de Wonda. El servidor intercambia esos tokens por la clave API interna de la cuenta solo dentro de Wonda, por lo que los agentes y los hosts del conector nunca ven la clave sk_.... Para la CLI y la ruta local stdio MCP, sigue usando wonda auth login o la variable de entorno WONDA_API_KEY.
Relay local de Claude Cowork
Claude Cowork (la aplicación de escritorio) ejecuta servidores MCP locales en el host, por lo que puede cargar el paquete .mcpb o una configuración local stdio wonda-mcp directamente, incluyendo las escrituras WAB (verificado el 07-07-2026). Claude web no puede. El relay local de Wonda es la ruta alternativa: permite que el conector REMOTO (web o Cowork) ejecute acciones en el propio Mac del usuario y en su IP residencial sin necesidad de configuración local MCP:
- Abre
https://wonda.sh/downloadmientras estás autenticado e instala el paquete Mac notarizado. - Vincula el relay con
wonda relay pairo mediante la entrega inicial en el navegador. Esto utiliza el flujocli-authexistente con una credencialwrelay_...con ámbito de relay almacenada en el Llavero de macOS. No le pidas al usuario que pegue una clave API o código de dispositivo. - Abre
https://wonda.sh/setup, conecta LinkedIn, X y Reddit a través del WAB local con interfaz gráfica, luego aprueba el conector de Wonda una vez en Claude.
La política del motor es auto | my_machine | cloud. auto usa el relay local cuando está en línea y la nube en caso contrario. my_machine no debe caer en modo silencioso: si el relay está desconectado, pregunta si se desea cambiar a la nube.
Organizaciones y contexto de gasto
Las organizaciones de Wondercat son carteras compartidas con sus propios asientos y facturación. Los miembros pueden gastar desde la cartera de la organización (en lugar de sus créditos personales) cambiando de contexto:
wonda organizations list(alias:wonda orgs list,wonda org list): ver cada organización a la que perteneces con tu rol y plan de asiento en cada una.wonda use --org <slug>: contexto de organización persistente para esta máquina. Establece el encabezadoX-Wonda-Orgen cada solicitud; las transacciones, cargos ywonda balancese enrutan a través de la cartera de la organización.wonda use --personal: vuelve al contexto personal.wonda usage: resumen de gasto (desglose total + por modelo + por proyecto) para un período (--month 2026-05, o--from/--to; por defecto es el mes actual, UTC).--project <name>restringe el informe a un solo proyecto. En contexto de organización, reporta el uso a nivel de organización incluyendo un desglose por miembro; se requiere rol de administrador/propietario. Los administradores también pueden descargar un informe completo en Excel desde la página de la organización en la web.
Proyectos (etiquetado de gasto)
Los proyectos atribuyen el gasto a un flujo de trabajo nombrado para monitoreo. Los agentes deben verificar el proyecto activo al inicio de la tarea (wonda use lo muestra) y establecer uno por tarea cuando el operador monitorea el gasto por proyecto:
wonda use --project <name>: persistente: cada cargo posterior lleva el proyecto (enwonda usage, en la API y en el informe Excel de la organización).wonda use --no-projectdetiene el etiquetado; cambiar de contexto de organización a personal limpia el proyecto automáticamente (los proyectos tienen ámbito por contexto).--project <name>en cualquier comando: anulación única para esa invocación.wonda project list|create|delete: gestiona el registro en el ámbito activo. Los proyectos de organización solo los crean administradores/propietarios; los proyectos personales son de autoservicio. Etiquetar contra un nombre que no existe falla conunknown_project(sin nuevos buckets silenciosos, por lo que los errores tipográficos no pueden dividir los datos de monitoreo).
wonda topup siempre recarga tu cartera personal, independientemente del contexto. Recargar la cartera de la organización (y configurar la recarga automática) es solo para administradores y se realiza en la web en /organizations/<slug>. Si un miembro se queda sin créditos de la organización, el error le indica que solicite a un administrador o que vuelva al modo personal; no puede recargar la cartera de la organización desde la CLI.
Los roles dentro de una organización son independientes del plan de asiento:
- Propietario: el creador original. No puede ser degradado ni expulsado. Puede transferir la propiedad a otro miembro desde la página de la organización (raro).
- Administrador: puede invitar (individual o masivamente mediante pegado), expulsar, cambiar roles, cambiar asientos, recargar, configurar recarga automática, cambiar límites mensuales.
- Usuario: solo puede gastar dentro de la cartera de la organización (sujeto a un límite mensual por miembro si el administrador lo ha establecido).
Un asiento de organización pago (WONDA / WONDA_PREMIUM) otorga el mismo acceso a funciones pagas (habilidades, etc.) que un plan personal pago, pero solo mientras esté en contexto de organización. wonda use --personal vuelve al plan de la cuenta personal del usuario.
Niveles de acceso
Wonda es solo de pago: cada superficie de producto (generación, medios, publicación, scraping, análisis, habilidades, gemelo en la nube) requiere un plan pago. Las cuentas nuevas no obtienen créditos ni acceso al producto hasta que se suscriben.
| Nivel | Acceso |
|---|---|
| Anónimo (cuenta temporal, sin inicio de sesión) | Sin acceso al producto. La CLI crea una cuenta temporal en la primera ejecución, pero solo alcanza los comandos locales siguientes más los endpoints de autenticación/facturación. Ejecuta wonda auth login, luego suscríbete. |
| Gratuito (autenticado, sin plan pago) | Sin acceso al producto. Suscríbete en https://wonda.sh/account para usar el producto. |
WONDA ($19.99/mes, "Pro") | Todo excepto el gemelo en la nube: generación (image/generate, video/generate, ...), carga/descarga de medios, publicación, scraping, análisis, análisis de video, habilidades (wonda skill install/list/get), transiciones, recorte, correo electrónico, creación de cuentas en Reddit/LinkedIn, estilos, marca. |
WONDA_PREMIUM ($49.99/mes, "Premium") | Todo lo de WONDA, más gemelo en la nube (wonda twin: aprovisionamiento, ejecuciones programadas, inicio de sesión transmitido) con protección antidetección/sombra, sin límites y creación de cuentas en EE. UU. |
| Marcado (interruptores de seguridad por cuenta en PostHog) | Incluido en el plan pago pero aún controlable por una marca por cuenta: wonda reddit signup (redditAccountCreationEnabled), wonda email (emailServerApiEnabled), enriquecimiento de perfil público de LinkedIn (linkedinProfileEnrichmentEnabled). |
| Local (sin llamada API, sin créditos, sin plan) | Se ejecuta completamente en tu máquina, por lo que funcionan sin plan: wonda brand extract <url> (sin --save), wonda compose motion / wonda compose text, wonda wab record <url>, wonda edit ... transformaciones primitivas ffmpeg en archivos locales, y wonda doctor. Los basados en Chromium necesitan una instalación única de wonda wab install. |
Si un comando devuelve un 403 (paid_plan_required), suscríbete en https://wonda.sh/account.
Clonación de voz
Clona una voz a partir de un clip de audio de 10 segundos o más y úsala en TTS. Límite estricto: 20 voces clonadas por cuenta. Costo: $1.50 por clonación.
# Clonar desde un archivo local (se sube automáticamente a la biblioteca de medios primero)
wonda voice create "Andu" --file ./sample.mp3 --description "Mi voz"
# Clonar desde un medio existente de Wonda
wonda voice create "Marca" --media-id <uuid>
# Preprocesamiento opcional del audio fuente
wonda voice create "Limpia" --file ./raw.wav --noise-reduction --normalize-volume
# Listar voces clonadas (cada fila indica isExpired y expiresInDays)
wonda voice list
# Una voz
wonda voice get <voice-id>
# Renombrar / redescribir (solo local, sin llamada al proveedor)
wonda voice update <voice-id> --name "Nuevo Nombre" --description "..."
# Eliminar
wonda voice delete <voice-id>
Usa una voz clonada en TTS pasando el providerVoiceId de voice get como voiceId a /audio/speech:
wonda audio speech "Hola mundo" \
--model minimax-speech-2-8-hd \
--params '{"voiceId":"<providerVoiceId>"}'
Caducidad de 7 días: las voces clonadas que no se hayan usado en TTS en 7 días caducan automáticamente. Ejecutar TTS con una voz clonada renueva automáticamente su caducidad. Las voces inactivas que caduquen deben clonarse de nuevo ($1.50 otra vez).
Bóveda de credenciales
Conserva los inicios de sesión creados en plataformas externas (Instagram, TikTok, Twitter, etc.) para que puedan reutilizarse en la siguiente ejecución. Las contraseñas se cifran con AES-256-GCM mediante una clave del lado del servidor y solo se descifran al obtenerlas.
# Crear
wonda credentials create --website instagram.com --username miusuario \
--email [email protected] --password-stdin <<< "hunter2" \
--metadata '{"signup_source":"wonda-email"}'
# Listar (contraseñas omitidas)
wonda credentials list --website instagram.com
# Obtener registro completo, incluida la contraseña descifrada
wonda credentials get <id>
# Actualizar cualquier campo (usa --password-stdin para rotar; --username "" para limpiar)
wonda credentials update <id> --username nuevousuario
# Eliminar
wonda credentials delete <id>
# Obtener y registrar por qué lo usas en una sola llamada — POST, no GET, porque
# escribe un evento de 'uso' con el motivo. Prefiere esto sobre `get` siempre que
# puedas articular el motivo.
wonda credentials use <id> --reason "flujo de registro en instagram"
# Ver eventos recientes (creado / usado / rotado / actualizado) para auditoría
wonda credentials events <id>
Campos: website (obligatorio — la entrada escrita como insta se canonaliza a instagram.com), username, email, password (obligatorio), metadata (JSON arbitrario). Al menos uno de username / email debe estar presente. Se permiten múltiples registros por (website, username) — desduplica por tu cuenta si es necesario.
Registro de eventos: cada credentials get/use, create, rotación de contraseña y otras actualizaciones se registran como eventos en la credencial (actor: cli | web | system). Usa credentials events <id> o el icono de historial en la interfaz web para auditar. El registro de eventos es de solo añadidura y se elimina en cascada al borrar la credencial.
Banderas globales de salida
Todos los comandos admiten estas banderas de control de salida:
--json: fuerza la salida JSON (se activa automáticamente cuando la salida estándar se canaliza)--quiet: solo genera el identificador principal (ID de trabajo, ID de medio, etc.) — ideal para scripts-o <ruta>: descarga la salida a un archivo (implica--wait)--fields status,outputs: selecciona campos JSON específicos--jq '.outputs[0].media.url': filtra la salida JSON con una expresión jq
Anuncios de CLI y advertencias de obsolescencia
En cada comando, la CLI consulta GET /api/v1/updates (anónimo, caché de 1 hora en ~/.wonda/state.json) para obtener anuncios activos: avisos de obsolescencia, alertas de incidentes, mensajes de actualización. Los mensajes se imprimen solo en stderr, por lo que stdout/JSON se mantiene limpio para canalizaciones.
Las sugerencias de obsolescencia por solicitud llegan como el encabezado HTTP estándar Warning: 299 - "<mensaje>" y se muestran en stderr por el cliente HTTP de la CLI como [deprecated METHOD /path] <mensaje>.
Silencia ambos canales con WONDA_QUIET=1 (variable de entorno) o --quiet (bandera). Desactiva solo las comprobaciones de red con WONDA_NO_UPDATE_CHECK=1.
WAB / Wonda Automation Browser (wonda wab)
Wonda Automation Browser (WAB) es un navegador antidetect de sigilo premium, endurecido para que las plataformas no puedan identificarlo como automatización. wonda wab es el comando único para el stack de Chromium antidetect (una bifurcación indetectable de Playwright). Tiene dos caras:
- Sesiones autenticadas. Un Chromium con interfaz gráfica persistente por persona que mantiene sesiones iniciadas en LinkedIn, X, Reddit y otros. La CLI lo inicia bajo demanda, deja que se enfríe y enruta las lecturas/escrituras de la plataforma a través de él cuando un comando se ejecuta con
--via wab. Las cookies residen en el perfil de Chromium de la persona, no en~/.wonda/config.json. - Captura anónima.
wonda wab record <url>(ywonda brand extract) ejecutan un Chromium efímero con una huella digital nueva, sin persona ni cookies. Consulta el bloquerecorda continuación.
El modelo mental: tienes cuentas (una identidad por plataforma). Cada comando de plataforma enruta a las cookies de esa cuenta a través del almacén JSON plano (--via cookies, rápido, sin Chromium) o la persona de la cuenta (--via wab, Chromium antidetect en vivo). Una persona es el envoltorio de Chromium que puede contener múltiples cuentas bajo una misma huella digital. En casi todos los casos, la persona se crea automáticamente en el primer uso de --via wab, nombrada según la cuenta, por lo que nunca tienes que escribir un nombre de persona.
La extensión de escritorio local wonda.mcpb usa esta misma ruta WAB local desde Claude Desktop o Claude Code: las cookies de la plataforma permanecen en el dispositivo, las lecturas usan cookies locales y las escrituras usan el WAB local. Claude web y Cowork necesitan el conector MCP remoto en su lugar.
Inicio de sesión nativo