Wonda CLI
Wonda CLI é um kit de ferramentas de criação de conteúdo para agentes baseados em terminal. Use-o para gerar imagens, vídeos, música e áudio; editar e compor mídia; publicar em plataformas sociais; e pesquisar/automatizar no LinkedIn, Reddit e X/Twitter.
Instalação
Se wonda não for encontrado no PATH, instale primeiro:
# npm
npm i -g @degausai/wonda
# Homebrew
brew tap degausai/tap && brew install wonda
Configuração
- Autenticação:
wonda auth login(abre o navegador, recomendado) ou defina a variável de ambienteWONDA_API_KEY - Verificação:
wonda auth check
Autenticação via conector OAuth
Os conectores Claude web e Cowork usam o fluxo OAuth 2.1 da Wonda em vez de um campo de chave de API no CLI. O conector faz login através da Wonda no navegador, concede o acesso solicitado à conta e recebe tokens OAuth vinculados ao recurso da API Wonda. O servidor troca esses tokens pela chave de API interna da conta apenas dentro da Wonda, portanto agentes e hosts de conectores nunca veem a chave sk_.... Para o CLI e o caminho MCP stdio local, continue usando wonda auth login ou WONDA_API_KEY.
Retransmissão local para Claude Cowork
O Claude Cowork (aplicativo desktop) executa servidores MCP locais no host, então pode carregar o pacote .mcpb ou uma configuração local wonda-mcp stdio diretamente, escritas WAB incluídas (verificado em 07/07/2026). O Claude web não. A retransmissão local Wonda é o caminho alternativo: permite que o conector REMOTO (web ou Cowork) execute ações no próprio Mac do usuário e IP residencial sem qualquer configuração MCP local:
- Acesse
https://wonda.sh/downloadenquanto estiver logado e instale o pacote Mac notarizado. - Emparelhe a retransmissão com
wonda relay pairou a transferência manual no primeiro uso. Isso usa o fluxocli-authexistente com uma credencialwrelay_...com escopo de retransmissão armazenada no chaveiro do macOS. Não peça ao usuário para colar uma chave de API ou código de dispositivo. - Acesse
https://wonda.sh/setup, conecte LinkedIn, X e Reddit através do WAB local com interface, e então aprove o conector Wonda uma vez no Claude.
A política do mecanismo é auto | my_machine | cloud. auto usa a retransmissão local quando está online e a nuvem caso contrário. my_machine não deve cair silenciosamente em fallback: se a retransmissão estiver offline, pergunte se deve mudar para nuvem.
Organizações e contexto de gastos
As organizações Wondercat são carteiras compartilhadas com seus próprios assentos e faturamento. Os membros podem gastar da carteira da organização (em vez de seus créditos pessoais) alternando o contexto:
wonda organizations list(atalhos:wonda orgs list,wonda org list) — veja todas as organizações das quais você faz parte com sua função e plano de assento em cada uma.wonda use --org <slug>— contexto de organização fixo para esta máquina. DefineX-Wonda-Orgem cada requisição; retenções, cobranças ewonda balancepassam pela carteira da organização.wonda use --personal— volta ao pessoal.wonda usage— resumo de uso apenas de gastos (total + por modelo + por projeto) para um período (--month 2026-05, ou--from/--to; padrão é o mês atual, UTC).--project <nome>restringe o relatório a um projeto. No contexto de organização, relata o uso em toda a organização, incluindo uma divisão por membro — função de administrador/proprietário necessária. Administradores também podem baixar um relatório completo em Excel da página da organização na web.
Projetos (etiquetagem de gastos)
Projetos atribuem gastos a um fluxo de trabalho nomeado para monitoramento. Agentes devem verificar o projeto ativo no início da tarefa (wonda use imprime) e definir um por tarefa quando o operador monitora gastos por projeto:
wonda use --project <nome>— fixo: cada cobrança subsequente carrega o projeto (emwonda usage, na API e no relatório Excel da organização).wonda use --no-projectpara de etiquetar; alternar o contexto de organização/pessoal limpa o projeto automaticamente (projetos têm escopo por contexto).--project <nome>em qualquer comando — substituição única para aquela invocação.wonda project list|create|delete— gerencia o registro no escopo ativo. Projetos de organização são criados apenas por administradores/proprietários da organização; projetos pessoais são autoatendimento. Etiquetar contra um nome que não existe falha comunknown_project(sem novos buckets silenciosos, então erros de digitação não podem dividir os dados de monitoramento).
wonda topup sempre recarrega sua carteira pessoal, independentemente do contexto. Recarregar a carteira da organização (e configurar recarga automática) é apenas para administradores e acontece na web em /organizations/<slug>. Se um membro ficar sem créditos da organização, o erro informa para pedir a um administrador ou voltar ao pessoal — eles não podem recarregar a carteira da organização pelo CLI.
As funções dentro de uma organização são separadas do plano de assento:
- Proprietário: o criador original. Não pode ser rebaixado ou removido. Pode transferir a propriedade para outro membro a partir da página da organização (raro).
- Administrador: pode convidar (individualmente ou em lote via colagem), remover, alterar funções, alterar assentos, recarregar, configurar recarga automática, alterar limites mensais.
- Usuário: pode apenas gastar dentro da carteira da organização (sujeito a um limite mensal por membro, se o administrador definiu um).
Um assento de organização pago (WONDA / WONDA_PREMIUM) concede o mesmo acesso a recursos pagos (habilidades, etc.) que um plano pessoal pago, mas apenas no contexto da organização. wonda use --personal volta ao plano da conta pessoal do usuário.
Níveis de acesso
Wonda é pago: toda superfície de produto (geração, mídia, publicação, raspagem, análise, habilidades, gêmeo na nuvem) requer um plano pago. Novas contas não recebem créditos e nenhum acesso ao produto até assinarem.
| Nível | Acesso |
|---|---|
| Anônimo (conta temporária, sem login) | Nenhum acesso ao produto. O CLI cria uma conta temporária na primeira execução, mas atinge apenas os comandos locais abaixo, mais os endpoints de autenticação/faturamento. Execute wonda auth login e depois assine. |
| Gratuito (logado, sem plano pago) | Nenhum acesso ao produto. Assine em https://wonda.sh/account para usar o produto. |
WONDA ($19.99/mês, "Pro") | Tudo, exceto gêmeo na nuvem: geração (image/generate, video/generate, ...), upload/download de mídia, publicação, raspagem, análise, análise de vídeo, habilidades (wonda skill install/list/get), transições, corte, e-mail, criação de conta reddit/linkedin, estilos, marca. |
WONDA_PREMIUM ($49.99/mês, "Premium") | Tudo no WONDA, mais gêmeo na nuvem (wonda twin: provisionamento, execuções agendadas, login transmitido) com proteção antidetecção / sombra, sem limites e criação de conta nos EUA. |
| Sinalizado (kill-switches PostHog por conta) | Incluído no plano pago, mas ainda pode ser controlado por uma flag por conta: wonda reddit signup (redditAccountCreationEnabled), wonda email (emailServerApiEnabled), enriquecimento de perfil público do LinkedIn (linkedinProfileEnrichmentEnabled). |
| Local (sem chamada de API, sem créditos, sem plano) | Executado inteiramente na sua máquina, portanto funciona sem plano: wonda brand extract <url> (sem --save), wonda compose motion/wonda compose text, wonda wab record <url>, wonda edit ... transformações primitivas ffmpeg em arquivos locais e wonda doctor. Os baseados em Chromium precisam de wonda wab install uma vez. |
Se um comando retornar 403 (paid_plan_required), assine em https://wonda.sh/account.
Clonagem de voz
Clone uma voz a partir de um clipe de áudio de 10s+ e use-a em TTS. Limite fixo: 20 vozes clonadas por conta. Custo: $1.50 por clone.
# Clonar de um arquivo local (faz upload automático para biblioteca de mídia primeiro)
wonda voice create "Andu" --file ./sample.mp3 --description "Minha voz"
# Clonar de mídia wonda existente
wonda voice create "Marca" --media-id <uuid>
# Pré-processamento opcional do áudio fonte
wonda voice create "Limpa" --file ./raw.wav --noise-reduction --normalize-volume
# Listar vozes clonadas (cada linha reporta isExpired e expiresInDays)
wonda voice list
# Uma voz
wonda voice get <voice-id>
# Renomear / re-descrever (local, sem chamada de provedor)
wonda voice update <voice-id> --name "Novo Nome" --description "..."
# Excluir
wonda voice delete <voice-id>
Use uma voz clonada em TTS passando providerVoiceId de voice get como voiceId para /audio/speech:
wonda audio speech "Olá mundo" \
--model minimax-speech-2-8-hd \
--params '{"voiceId":"<providerVoiceId>"}'
Expiração de 7 dias: vozes clonadas que não são usadas em TTS dentro de 7 dias são expiradas automaticamente. Executar TTS com uma voz clonada renova automaticamente sua expiração. Vozes ociosas que expiram devem ser clonadas novamente ($1.50 novamente).
Cofre de credenciais
Persista logins criados em plataformas externas (Instagram, TikTok, Twitter, etc.) para que possam ser reutilizados na próxima execução. As senhas são criptografadas com AES-256-GCM usando uma chave do lado do servidor e descriptografadas apenas em get.
# Criar
wonda credentials create --website instagram.com --username meuhandle \
--email [email protected] --password-stdin <<< "hunter2" \
--metadata '{"signup_source":"wonda-email"}'
# Listar (senhas omitidas)
wonda credentials list --website instagram.com
# Obter registro completo, incluindo senha descriptografada
wonda credentials get <id>
# Atualizar qualquer campo (use --password-stdin para girar; --username "" para limpar)
wonda credentials update <id> --username novohandle
# Excluir
wonda credentials delete <id>
# Buscar + registrar por que você está usando em uma chamada — POST, não GET, porque
# escreve um evento 'usado' com o motivo. Prefira isso em vez de `get` sempre que
# puder articular o motivo.
wonda credentials use <id> --reason "fluxo de cadastro instagram"
# Ver eventos recentes (criado / usado / girado / atualizado) para auditoria
wonda credentials events <id>
Campos: website (obrigatório — entrada tipada como insta é canonicalizada para instagram.com), username, email, password (obrigatório), metadata (JSON arbitrário). Pelo menos um de username/email deve estar presente. Múltiplos registros por (website, username) são permitidos — deduza do seu lado se necessário.
Registro de eventos: toda credentials get/use, create, rotação de senha e outras atualizações são registradas como eventos na credencial (ator: cli | web | system). Use credentials events <id> ou o ícone de histórico na interface web para auditar. O registro de eventos é somente anexação e a cascata é excluída na exclusão da credencial.
Flags globais de saída
Todos os comandos suportam estas flags de controle de saída:
--json— Forçar saída JSON (ativado automaticamente quando a saída padrão é redirecionada)--quiet— Apenas saída do identificador principal (ID do job, ID da mídia, etc.) — ideal para scripts-o <caminho>— Baixar saída para arquivo (implica--wait)--fields status,outputs— Selecionar campos JSON específicos--jq '.outputs[0].media.url'— Filtrar saída JSON com uma expressão jq
Anúncios do CLI e avisos de descontinuação
Em cada comando, o CLI consulta GET /api/v1/updates (anônimo, cache de 1h em ~/.wonda/state.json) por anúncios ativos: avisos de descontinuação, alertas de incidentes, prompts de atualização. As mensagens são impressas apenas em stderr, para que stdout/JSON permaneçam limpos para redirecionamento.
Dicas de descontinuação por requisição chegam como o cabeçalho HTTP padrão Warning: 299 - "<mensagem>" e são exibidas em stderr pelo cliente HTTP do CLI como [deprecated METHOD /path] <mensagem>.
Silencie ambos os canais com WONDA_QUIET=1 (variável de ambiente) ou --quiet (flag). Desabilite apenas as verificações de rede com WONDA_NO_UPDATE_CHECK=1.
WAB / Wonda Automation Browser (wonda wab)
O Wonda Automation Browser (WAB) é um navegador antidetecção furtivo premium, endurecido para que plataformas não possam identificá-lo como automação. wonda wab é o único comando para o stack Chromium antidetecção (um fork do Playwright não detectado). Ele tem duas faces:
- Sessões autenticadas. Um Chromium persistente com interface por persona que mantém sessões logadas para LinkedIn, X, Reddit e outros. O CLI o inicia sob demanda, deixa-o ocioso e roteia leituras/escritas através dele sempre que um comando roda
--via wab. Cookies vivem no perfil Chromium da persona, não em~/.wonda/config.json. - Captura anônima.
wonda wab record <url>(ewonda brand extract) conduzem um Chromium efêmero com uma impressão digital nova, sem persona, sem cookies. Veja o blocorecordabaixo.
O modelo mental: você tem contas (uma identidade por plataforma). Cada comando de plataforma roteia para os cookies dessa conta através do armazenamento JSON simples (--via cookies, rápido, sem Chromium) ou da persona da conta (--via wab, Chromium antidetecção ao vivo). Uma persona é o invólucro Chromium que pode conter múltiplas contas sob uma impressão digital. Em quase todos os casos, a persona é criada automaticamente no primeiro uso de --via wab, nomeada após a conta, então você nunca digita um nome de persona.
A extensão de desktop local wonda.mcpb usa este mesmo caminho WAB local do Claude Desktop ou Claude Code: cookies de plataforma permanecem no dispositivo, leituras usam cookies locais e escritas usam o WAB local. Claude web e Cowork precisam do conector MCP remoto.
Login nativo
...