CLI de Wonda
Wonda CLI es un conjunto de herramientas para la creación de contenido desde la terminal. Úsalo para generar imágenes, videos, música y audio; editar y componer medios; publicar en redes sociales; e investigar y automatizar en LinkedIn, Reddit y X/Twitter.
Instalación
Si wonda no se encuentra en el 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 del 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 la 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 WONDA_API_KEY.
Relé 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 los WAB (verificado 2026-07-07). Claude web no puede. El relé 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 MCP local:
- Abre
https://wonda.sh/downloadmientras has iniciado sesión e instala el paquete notarizado para Mac. - Vincula el relé con
wonda relay pairo la transferencia del navegador en el primer inicio. Esto utiliza el flujocli-authexistente con una credencialwrelay_...de ámbito de relé almacenada en el Llavero de macOS. No pidas al usuario que pegue una clave API o un 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 relé local cuando está en línea y cloud en caso contrario. my_machine no debe recurrir silenciosamente: si el relé está fuera de línea, pregunta si se desea cambiar a cloud.
Organizaciones y contexto de gasto
Las organizaciones (orgs) 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) — muestra todas las organizaciones a las 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. EstableceX-Wonda-Orgen cada solicitud; las retenciones, cargos ywonda balancese gestionan a través de la cartera de la organización.wonda use --personal— vuelve al contexto personal.wonda usage— resumen de uso solo de gasto (total + desglose por modelo + por proyecto) para un período (--month 2026-05, o--from/--to; por defecto el mes actual, UTC).--project <name>restringe el informe a un proyecto. En contexto de organización, informa el uso a nivel de organización, incluido 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 con nombre para su monitoreo. Los agentes deben verificar el proyecto activo al inicio de la tarea (wonda use lo imprime) 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, la API y el informe Excel de la organización).wonda use --no-projectdetiene el etiquetado; cambiar el contexto de organización/personal borra automáticamente el proyecto (los proyectos son por ámbito).--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 los administradores/propietarios de la organización; 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 pida a un administrador o que vuelva al contexto 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 asientos:
- 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 (individualmente o mediante pegado masivo), 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 de pago (WONDA / WONDA_PREMIUM) otorga el mismo acceso a funciones de pago (skills, etc.) que un plan personal de pago, pero solo en el contexto de la organización. wonda use --personal vuelve al plan de la cuenta personal del usuario.
Niveles de acceso
Wonda es solo de pago: todas las superficies del producto (generación, medios, publicación, scraping, análisis, skills, gemelo en la nube) requieren un plan de pago. Las cuentas nuevas no reciben 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 el primer inicio, pero solo llega a los comandos locales que se muestran a continuación más los endpoints de autenticación/facturación. Ejecuta wonda auth login y luego suscríbete. |
| Gratuito (con sesión iniciada, sin plan de 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, ...), subida/descarga de medios, publicación, scraping, análisis, análisis de video, skills (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 en WONDA, más gemelo en la nube (wonda twin: aprovisionamiento, ejecuciones programadas, inicio de sesión en streaming) con protección antidetect / shadowban, sin límites y creación de cuentas en EE. UU. |
| Marcado (interruptores de seguridad PostHog por cuenta) | Incluido en el plan de 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 un 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 de origen
wonda voice create "Limpia" --file ./raw.wav --noise-reduction --normalize-volume
# Listar voces clonadas (cada fila informa isExpired y expiresInDays)
wonda voice list
# Una voz
wonda voice get <voice-id>
# Renombrar / re-describir (solo local, sin llamada al proveedor)
wonda voice update <voice-id> --name "Nuevo Nombre" --description "..."
# Eliminar
wonda voice delete <voice-id>
Usar 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 utilizado en TTS durante 7 días caducan automáticamente. Ejecutar TTS con una voz clonada renueva automáticamente su caducidad. Las voces inactivas que caduquen deben volverse a clonar ($1.50 nuevamente).
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 con una clave del lado del servidor y solo se descifran en get.
# Crear
wonda credentials create --website instagram.com --username miusuario \
--email [email protected] --password-stdin <<< "cazador2" \
--metadata '{"signup_source":"wonda-email"}'
# Listar (se omiten las contraseñas)
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 borrar)
wonda credentials update <id> --username nuevousuario
# Eliminar
wonda credentials delete <id>
# Obtener y registrar el motivo de uso 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 anexión y se elimina en cascada al eliminar la credencial.
Banderas globales de salida
Todos los comandos admiten estas banderas de control de salida:
--json— Forzar salida JSON (se habilita automáticamente cuando la salida estándar está canalizada)--quiet— Solo muestra el identificador principal (ID de trabajo, ID de medio, etc.) — ideal para scripts-o <path>— Descargar salida a un archivo (implica--wait)--fields status,outputs— Seleccionar campos JSON específicos--jq '.outputs[0].media.url'— Filtrar la salida JSON con una expresión jq
Anuncios de la 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 buscar anuncios activos: avisos de obsolescencia, alertas de incidentes, avisos de actualización. Los mensajes se imprimen solo en stderr, por lo que stdout/JSON se mantiene limpio para la canalización.
Las sugerencias de obsolescencia por solicitud llegan como el encabezado HTTP estándar Warning: 299 - "<mensaje>" y son mostradas 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). Deshabilita solo las comprobaciones de red con WONDA_NO_UPDATE_CHECK=1.
WAB / Wonda Automation Browser (wonda wab)
El Wonda Automation Browser (WAB) es un navegador antidetect sigiloso premium, endurecido para que las plataformas no puedan identificarlo como automatización. wonda wab es el comando único para la pila de Chromium antidetect (un fork de Playwright no detectado). Tiene dos caras:
- Sesiones autenticadas. Un Chromium persistente con interfaz gráfica por persona que mantiene sesiones iniciadas para LinkedIn, X, Reddit y otros. La CLI lo inicia bajo demanda, lo deja en inactividad y enruta las lecturas/escrituras de la plataforma a través de él cada vez que un comando se ejecuta
--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) utilizan un Chromium efímero con una huella digital nueva, sin persona, sin 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, con el nombre de la cuenta, por lo que nunca escribes un nombre de persona.
La Extensión de Escritorio local wonda.mcpb utiliza esta misma ruta local de WAB 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
...