Wonda CLI
Wonda CLI は、ターミナルベースのエージェント向けコンテンツ作成ツールキットです。画像、動画、音楽、音声の生成、メディアの編集と合成、ソーシャルプラットフォームへの公開、そして LinkedIn、Reddit、X/Twitter にわたるリサーチと自動化に使用します。
インストール
wonda が PATH に見つからない場合は、最初にインストールしてください。推奨されるインストール方法は、署名付きデスクトップインストーラー(CLI + トレイアイコン + 常時オンリレー、追加手順不要)です。macOS では brew install --cask degausai/tap/wonda-app(またはリリースから wonda-macos.pkg)、Windows では winget/wonda-windows-setup.exe を使用します。以下の CLI のみのチャネルはどこでも動作し、後で wonda app install でデスクトップアプリを追加できます。
# npm
npm i -g @degausai/wonda
# Homebrew
brew tap degausai/tap && brew install wonda
セットアップ
- 認証:
wonda auth login(ブラウザを開く、推奨)または環境変数WONDA_API_KEYを設定 - 確認:
wonda auth check
OAuth コネクタ認証
Claude web および Cowork コネクタは、CLI API キーフィールドの代わりに Wonda の OAuth 2.1 フローを使用します。コネクタはブラウザで Wonda にサインインし、要求されたアカウントアクセスを許可し、Wonda API リソースにバインドされた OAuth トークンを受け取ります。サーバーはそのトークンをアカウントの内部 API キーに交換する処理を Wonda 内部でのみ行うため、エージェントやコネクタホストが sk_... キーを見ることはありません。CLI およびローカル stdio MCP パスでは、引き続き wonda auth login または WONDA_API_KEY を使用してください。
Claude Cowork ローカルリレー
Claude Cowork(デスクトップアプリ)はホスト上でローカル MCP サーバーを実行するため、.mcpb バンドルまたはローカルの stdio wonda-mcp 設定を直接読み込むことができ、WAB 書き込みも含まれます(2026-07-07 確認済み)。Claude web はそれができません。Wonda ローカルリレーは代替パスです。リモートコネクタ(web または Cowork)が、ユーザー自身の Mac と自宅 IP 上で、ローカル MCP 設定なしでアクションを実行できるようにします。
- サインインした状態で
https://wonda.sh/downloadを開き、公証済み Mac パッケージをインストールします。 wonda relay pairまたは初回起動時のブラウザハンドオフでリレーをペアリングします。これにより、macOS キーチェーンに保存されたリレースコープのwrelay_...資格情報を使用して既存のcli-authフローを利用します。ユーザーに API キーやデバイスコードを貼り付けるよう求めないでください。https://wonda.sh/setupを開き、ヘッドフルなローカル WAB を介して LinkedIn、X、Reddit を接続し、Claude で Wonda コネクタを承認します。
エンジンポリシーは auto | my_machine | cloud です。auto はローカルリレーがオンラインの場合はそれを使用し、そうでない場合はクラウドを使用します。my_machine はサイレントフォールバックしてはいけません。リレーがオフラインの場合は、クラウドに切り替えるかどうかを確認します。
組織と支出コンテキスト
Wondercat 組織は、独自のシートと請求を持つ共有ウォレットです。メンバーはコンテキストを切り替えることで、(個人クレジットの代わりに)組織ウォレットから支出できます。
wonda organizations list(エイリアス:wonda orgs list、wonda org list)— 自分の役割と各組織のシートプランを含む、所属するすべての組織を表示します。wonda use --org <slug>— このマシンにスティッキーな組織コンテキストを設定します。すべてのリクエストにX-Wonda-Orgを設定し、ホールド、チャージ、およびwonda balanceは組織ウォレット経由でルーティングされます。wonda use --personal— 個人に戻します。wonda usage— 期間(--month 2026-05、または--from/--to。デフォルトは現在の月、UTC)の支出のみの使用量サマリー(合計 + モデル別 + プロジェクト別内訳)。--project <name>でレポートを 1 つのプロジェクトに制限します。組織コンテキストでは、メンバー別の内訳を含む組織全体の使用量を報告します(管理者/所有者ロールが必要)。管理者は Web の組織ページから完全な Excel レポートをダウンロードすることもできます。
プロジェクト(支出タグ付け)
プロジェクトは、支出を監視のための名前付きワークストリームに属性付けます。エージェントはタスク開始時にアクティブなプロジェクトを確認し(wonda use で表示)、オペレーターがプロジェクトごとに支出を監視している場合はタスクごとに 1 つのプロジェクトを設定する必要があります。
wonda use --project <name>— スティッキー: 以降のすべてのチャージにプロジェクトが付与されます(wonda usage、API、組織 Excel レポート内)。wonda use --no-projectでタグ付けを停止します。組織/個人コンテキストを切り替えると、プロジェクトは自動的にクリアされます(プロジェクトはスコープごとです)。- 任意のコマンドに
--project <name>— その呼び出しの 1 回限りのオーバーライド。 wonda project list|create|delete— アクティブスコープ内のレジストリを管理します。組織プロジェクトは組織の管理者/所有者のみが作成できます。個人プロジェクトはセルフサービスです。存在しない名前に対するタグ付けはunknown_projectで失敗します(新しいバケットがサイレントに作成されることはないため、タイプミスによって監視データが分割されることはありません)。
wonda topup は、コンテキストに関係なく、常に個人ウォレットにチャージします。組織ウォレットのチャージ(および自動チャージの設定)は管理者専用であり、Web の /organizations/<slug> で行われます。メンバーが組織クレジットを使い果たした場合、エラーは管理者に問い合わせるか個人に戻すように指示します。メンバーは CLI から組織ウォレットをチャージできません。
組織内のロールはシートプランとは別です。
- 所有者: 元の作成者。降格やキックはできません。組織ページから別のメンバーに所有権を移譲できます(まれ)。
- 管理者: 招待(単一または一括ペースト)、キック、ロール変更、シート変更、チャージ、自動チャージ設定、月間制限変更ができます。
- ユーザー: 組織ウォレット内でのみ支出できます(管理者が設定した場合、メンバーごとの月間制限の対象となります)。
有料の組織シート(WONDA / WONDA_PREMIUM)は、組織コンテキスト内でのみ、個人の有料プランと同じ有料機能アクセス(スキルなど)を付与します。wonda use --personal はユーザーの個人アカウントプランにフォールバックします。
アクセスティア
Wonda は有料専用です。すべてのプロダクトサーフェス(API 呼び出し、ローカルプラットフォーム読み取り、ブラウザ自動化、メディア合成、ファイル編集、診断、生成、公開、スクレイピング、分析、スキル、リレー運用、クラウドツインを含む)には有料プランが必要です。プロダクトコマンドが処理を開始する前に、CLI は Wonda に対してライブのエンタイトルメントチェックを実行します。アクセスが確認できない場合、チェックは失敗クローズドとなります。新しいアカウントはサブスクライブするまでプロダクトアクセスがなく、プラスのクレジット残高はプランの代わりにはなりません。
| ティア | アクセス |
|---|---|
| 匿名(ログインなし) | プロダクトアクセス不可。認証、設定、価格情報、組織の発見/選択、シェル補完、ローカルシャットダウンコマンドは、ユーザーがサブスクライブ、復旧、またはバックグラウンドサービスの停止を行えるように引き続き利用可能。wonda auth login を実行し、サブスクライブしてください。 |
| 無料(ログイン済み、有料プランなし) | プロダクトアクセス不可。https://wonda.sh/account でサブスクライブしてプロダクトを使用してください。 |
| WONDA(月額 $19.99、「Pro」) | クラウドツインを除くすべて: 生成(image/generate、video/generate、...)、メディアアップロード/ダウンロード、公開、スクレイピング、分析、動画分析、スキル(wonda skill install/list/get)、トランジション、クリッピング、メール、reddit/linkedin アカウント作成、スタイル、ブランド。 |
| WONDA_PREMIUM(月額 $49.99、「Premium」) | WONDA のすべてに加え、クラウドツイン(wonda twin: プロビジョニング、スケジュール実行、ストリームログイン)をアンチディテクト/シャドウバン保護、キャップなし、米国アカウント作成とともに提供。 |
| フラグ付き(アカウントごとの PostHog キルスイッチ) | 有料プランに含まれますが、アカウントごとのフラグでゲート可能: wonda reddit signup(redditAccountCreationEnabled)、wonda email(emailServerApiEnabled)、公開 LinkedIn プロファイルエンリッチメント(linkedinProfileEnrichmentEnabled)。 |
コマンドが 403(paid_plan_required)を返した場合は、https://wonda.sh/account でサブスクライブしてください。
これはローカル stdio MCP パスにも適用されます。MCP は同じ CLI を実行するためです。プラットフォームの Cookie とデータはデバイス上に残りますが、コマンドは最初に GET /api/v1/auth/access から成功した有料アクセス決定を受け取る必要があります。リレーのみのインストールでは、そのエンタイトルメントプローブにスコープ付きの wrelay_... 資格情報を使用できます。スコープ付き資格情報は通常のアカウント API を呼び出すことはできません。
ボイスクローン
10 秒以上の音声クリップから声をクローンし、TTS で使用します。ハードリミット: アカウントあたり 20 のクローン音声。コスト: クローンあたり $1.50。
# ローカルファイルからクローン(最初にメディアライブラリに自動アップロード)
wonda voice create "Andu" --file ./sample.mp3 --description "私の声"
# 既存の wonda メディアからクローン
wonda voice create "ブランド" --media-id <uuid>
# オプションのソース音声前処理
wonda voice create "クリーン" --file ./raw.wav --noise-reduction --normalize-volume
# クローン音声の一覧表示(各行に isExpired と expiresInDays が報告されます)
wonda voice list
# 1 つの音声
wonda voice get <voice-id>
# 名前 / 説明の変更(ローカルのみ、プロバイダ呼び出しなし)
wonda voice update <voice-id> --name "新しい名前" --description "..."
# 削除
wonda voice delete <voice-id>
クローン音声を TTS で使用するには、voice get の providerVoiceId を /audio/speech の voiceId として渡します。
wonda audio speech "Hello world" \
--model minimax-speech-2-8-hd \
--params '{"voiceId":"<providerVoiceId>"}'
7 日間の有効期限: 7 日間 TTS で使用されていないクローン音声は自動的に期限切れになります。クローン音声で TTS を実行すると、その有効期限が自動的に更新されます。アイドル状態で期限切れになった音声は、再度クローンする必要があります(再度 $1.50)。
認証情報ボールト
外部プラットフォーム(Instagram、TikTok、Twitter など)で作成したログイン情報を保持し、次回の実行時に再利用できるようにします。パスワードはサーバー側のキーで AES-256-GCM 暗号化され、get 時にのみ復号化されます。
# 作成
wonda credentials create --website instagram.com --username myhandle \
--email [email protected] --password-stdin <<< "hunter2" \
--metadata '{"signup_source":"wonda-email"}'
# 一覧表示(パスワードは省略)
wonda credentials list --website instagram.com
# 復号化されたパスワードを含む完全なレコードを取得
wonda credentials get <id>
# 任意のフィールドを更新(パスワードローテーションには --password-stdin を使用。クリアするには --username "")
wonda credentials update <id> --username newhandle
# 削除
wonda credentials delete <id>
# 1 回の呼び出しで取得 + 使用理由を記録 — GET ではなく POST です。なぜなら、
# 理由とともに 'used' イベントを書き込むからです。理由を明示できる場合は、
# `get` よりもこちらを優先してください。
wonda credentials use <id> --reason "instagram サインアップフロー"
# 監査のための最近のイベント(作成 / 使用 / ローテーション / 更新)を表示
wonda credentials events <id>
フィールド: website(必須 — insta のような入力は instagram.com に正規化されます)、username、email、password(必須)、metadata(任意の JSON)。username / email の少なくとも 1 つが存在する必要があります。(website, username) ごとに複数のレコードが許可されます — 必要に応じて自分で重複排除してください。
イベントログ: すべての credentials get/use、create、パスワードローテーション、およびその他の更新は、資格情報のイベントとして記録されます(アクター: cli | web | system)。credentials events <id> または Web UI の履歴アイコンを使用して監査します。イベントログは追加専用であり、資格情報の削除時にカスケード削除されます。
グローバル出力フラグ
すべてのコマンドで以下の出力制御フラグがサポートされています。
--json— JSON 出力を強制(stdout がパイプされている場合に自動的に有効)--quiet— 主要な識別子(ジョブ ID、メディア ID など)のみを出力 — スクリプトに最適-o <path>— 出力をファイルにダウンロード(--waitを暗黙的に指定)--fields status,outputs— 特定の JSON フィールドを選択--jq '.outputs[0].media.url'— jq 式で JSON 出力をフィルタリング
CLI アナウンスと非推奨警告
すべてのコマンドで、CLI はアクティブなアナウンス(非推奨通知、インシデント注意喚起、アップグレードプロンプト)を GET /api/v1/updates にポーリングします(匿名、~/.wonda/state.json に 1 時間キャッシュ)。メッセージは stderr にのみ出力されるため、stdout/JSON はパイプ処理のためにクリーンなままです。
リクエストごとの非推奨ヒントは、標準の Warning: 299 - "<message>" HTTP ヘッダーとして到着し、CLI の HTTP クライアントによって stderr に [deprecated METHOD /path] <message> として表示されます。
両方のチャネルを WONDA_QUIET=1(環境変数)または --quiet(フラグ)でサイレンスにします。ネットワークチェックのみを無効にするには WONDA_NO_UPDATE_CHECK=1 を使用します。
WAB / Wonda Automation Browser(wonda wab)
Wonda Automation Browser(WAB)は、プレミアムステルスアンチディテクトブラウザであり、プラットフォームが自動化としてフィンガープリントできないように強化されています。wonda wab は、アンチディテクト Chromium スタック(検出されない Playwright フォーク)のための 1 つのコマンドです。これには 2 つの側面があります。
- 認証済みセッション。 ペルソナごとに 1 つの永続的なヘッドフル Chromium で、LinkedIn、X、Reddit などのサインイン済みセッションを保持します。CLI はそれをオンデマンドで起動し、アイドル状態でタイムアウトさせ、コマンドが
--via wabで実行されるたびに、それを介してプラットフォームの読み取り/書き込みをルーティングします。Cookie は~/.wonda/config.jsonではなく、ペルソナの Chromium プロファイルに保存されます。 - 匿名キャプチャ。
wonda wab record <url>(およびwonda brand extract)は、新しいフィンガープリント、ペルソナなし、Cookie なしでエフェメラル Chromium を駆動します。以下のrecordブロックを参照してください。
メンタルモデル: アカウント(プラットフォームごとに 1 つの ID)があります。各プラットフォームコマンドは、フラットな JSON ストア(--via cookies、高速、Chromium 不要)またはアカウントのペルソナ(--via wab、ライブアンチディテクト Chromium)のいずれかを介して、そのアカウントの Cookie にルーティングされます。ペルソナは、1 つのフィンガープリントで複数のアカウントを保持できる Chromium エンベロープです。以下で…
…[翻訳のため一部省略]