manodhithyaa-dev/GraphCode

wonda-cli

Resumen

Uso de la CLI de Wonda para generar imágenes, videos, música y audio desde la terminal, además de investigación y automatización en LinkedIn, Reddit y X/Twitter.

Flujo de trabajo

---

name: wonda-cli description: Uso de la CLI de Wonda para generar imágenes, videos, música y audio desde la terminal, además de investigación y automatización en LinkedIn, Reddit y X/Twitter.

Wonda CLI

Wonda CLI es un conjunto 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/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 entorno WONDA_API_KEY.
• Verificación: wonda auth check

Autenticación del conector OAuth

Los conectores web de Claude 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 de 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 de stdio wonda-mcp directamente, incluidas las escrituras WAB (verificado el 2026-07-07). La web de Claude 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 su IP residencial sin ninguna configuración MCP local:

1. Abre https://wonda.sh/download mientras has iniciado sesión e instala el paquete notarizado para Mac.
2. Empareja el relé con wonda relay pair o el intercambio del navegador en la primera ejecución. Esto utiliza el flujo cli-auth existente con una credencial wrelay_... con ámbito de relé almacenada en el Llavero de macOS. No le pidas al usuario que pegue una clave API ni un código de dispositivo.
3. 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 la nube en caso contrario. my_machine no debe retroceder silenciosamente: si el relé está fuera de línea, pregunta si se debe 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 X-Wonda-Org en cada solicitud; las retenciones, cargos y wonda balance se enrutan a través de la cartera de la organización.
• wonda use --personal — volver 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 el contexto de la organización, informa el uso de toda la 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 iniciar 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 carga posterior lleva el proyecto (en wonda usage, la API y el informe de Excel de la organización). wonda use --no-project deja de etiquetar; 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 — gestionar el registro en el ámbito activo. Los proyectos de la 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 con unknown_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 le 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 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 (poco común).
• Administrador: puede invitar (individualmente o en lote mediante pegado), expulsar, cambiar roles, cambiar asientos, recargar, configurar la 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 premium (habilidades, etc.) que un plan personal pago, pero solo mientras esté 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: 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 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 la primera ejecución, pero solo llega a los comandos locales siguientes y a los endpoints de autenticación/facturación. Ejecute wonda auth login, luego suscríbase.
Gratuito (con sesión iniciada, sin plan pago)	Sin acceso al producto. Suscríbase 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 de 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 transmitido) con protección antidetect / shadowban, sin límites y creación de cuentas en EE. UU.
Marcado (interruptores de eliminación por cuenta de 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 su 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 de 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íbase en https://wonda.sh/account.

Clonación de voz

Clone una voz a partir de un clip de audio de 10 s o más y utilícela en TTS. Límite estricto: 20 voces clonadas por cuenta. Coste: $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 <id-voz>

# Renombrar / redescubrir (solo local, sin llamada al proveedor)
wonda voice update <id-voz> --name "Nuevo nombre" --description "..."

# Eliminar
wonda voice delete <id-voz>

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 en un período de 7 días caducan automáticamente. Ejecutar TTS con una voz clonada renueva automáticamente su caducidad. Las voces inactivas que caducan deben volver a clonarse ($1.50 nuevamente).

Almacén de credenciales

Conserve los inicios de sesión creados en plataformas externas (Instagram, TikTok, Twitter, etc.) para que puedan reutilizarse en la próxima ejecución. Las contraseñas se cifran con AES-256-GCM usando 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 (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 borrar)
wonda credentials update <id> --username nuevousuario

# Eliminar
wonda credentials delete <id>

# Obtener y registrar por qué se está usando en una sola llamada — POST, no GET, porque
# escribe un evento de 'usado' con el motivo. Prefiere esto sobre `get` siempre que
# puedas articular el motivo.
wonda credentials use <id> --reason "flujo de registro de 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). Debe estar presente al menos uno de username / email. Se permiten múltiples registros por (website, username) — deduplícalo por tu parte 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 de la interfaz web para auditar. El registro de eventos es de solo adición y se elimina en cascada al eliminar la credencial.

Banderas de salida globales

Todos los comandos admiten estas banderas de control de salida:

• --json — Forzar salida JSON (se habilita automáticamente cuando la salida estándar se canaliza)
• --quiet — Solo mostrar el identificador principal (ID de trabajo, ID de medio, etc.) — ideal para scripting
• -o <ruta> — Descargar la 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 obtener anuncios activos: avisos de obsolescencia, alertas de incidentes, indicaciones de actualización. Los mensajes se imprimen solo en stderr, por lo que stdout/JSON permanece limpio para la canalización.

Los consejos de obsolescencia por solicitud llegan como el encabezado HTTP estándar Warning: 299 - "<mensaje>" y son mostrados 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 de sigilo 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 indetectable de Playwright). 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 inactivo 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> (y wonda brand extract) manejan un Chromium efímero con una huella digital nueva, sin persona, sin cookies. Consulta el bloque record a 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 de 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 autentica una vez y las cookies se comparten entre la acción de la CLI y el navegador de la caja de arena.