Wonda CLI は何をしますか？
Wonda CLIは、ターミナルベースのエージェント向けコンテンツ作成ツールキットです。画像、動画、音楽、音声の生成、メディアの編集・合成、ソーシャルプラットフォームへの公開、LinkedIn、Reddit、X/Twitterのリサーチと自動化に使用します。
インストール
wonda がPATHに見つからない場合は、最初にインストールしてください：
# 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トークンを受け取ります。サーバーはそれらのトークンをWonda内部でのみアカウントの内部APIキーに交換するため、エージェントやコネクタホストが 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）がローカルMCP設定なしでユーザー自身のMacと住宅用IP上でアクションを実行できるようにします：
- サインインした状態で
https://wonda.sh/downloadを開き、公証済みのMacパッケージをインストールします。 - リレーを
wonda relay pairまたは初回実行時のブラウザハンドオフでペアリングします。これにより、既存のcli-authフローを使用し、macOSキーチェーンに保存されたリレースコープのwrelay_...認証情報を利用します。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つのプロジェクトに制限します。組織コンテキストでは、メンバー別内訳を含む組織全体の使用状況を報告します（管理者/所有者ロールが必要）。管理者はウェブの組織ページから完全なExcelレポートをダウンロードすることもできます。
プロジェクト（支出タグ付け）
プロジェクトは、支出を監視用の名前付きワークストリームに属性付けします。エージェントはタスク開始時にアクティブなプロジェクトを確認し（wonda use で表示）、オペレーターがプロジェクト別に支出を監視している場合はタスクごとにプロジェクトを設定する必要があります：
wonda use --project <name>— 固定：以降のすべてのチャージにプロジェクトが含まれます（wonda usage、API、組織Excelレポートで）。wonda use --no-projectでタグ付けを停止します。組織/個人コンテキストの切り替えは自動的にプロジェクトをクリアします（プロジェクトはスコープごとです）。- 任意のコマンドに
--project <name>— その呼び出しの1回限りのオーバーライド。 wonda project list|create|delete— アクティブなスコープ内のレジストリを管理します。組織プロジェクトは組織の管理者/所有者のみが作成できます。個人プロジェクトはセルフサービスです。存在しない名前に対するタグ付けはunknown_projectで失敗します（新しいバケットを静かに作成しないため、タイプミスで監視データが分割されることはありません）。
wonda topup は、コンテキストに関係なく常に個人ウォレットにチャージします。組織ウォレットのチャージ（および自動チャージの設定）は管理者のみが行え、ウェブの /organizations/<slug> で行います。メンバーが組織クレジットを使い果たした場合、エラーは管理者に依頼するか個人に戻すように指示します — CLIから組織ウォレットにチャージすることはできません。
組織内の役割はシートプランとは別です：
- 所有者: 元の作成者。降格または追放できません。組織ページから別のメンバーに所有権を移譲できます（まれ）。
- 管理者: 招待（単一または一括ペースト）、追放、役割変更、シート変更、チャージ、自動チャージ設定、月間制限変更ができます。
- ユーザー: 組織ウォレット内でのみ支出できます（管理者が設定したメンバー別月間制限の対象となります）。
有料組織シート（WONDA / WONDA_PREMIUM）は、組織コンテキスト中は個人の有料プランと同じ有料機能アクセス（スキルなど）を付与します。wonda use --personal はユーザーの個人アカウントプランにフォールバックします。
アクセス階層
Wondaは有料のみ：すべてのプロダクトサーフェス（生成、メディア、公開、スクレイピング、分析、スキル、クラウドツイン）には有料プランが必要です。新規アカウントはクレジットがなく、サブスクライブするまでプロダクトにアクセスできません。
| 階層 | アクセス |
|---|---|
| 匿名（一時アカウント、ログインなし） | プロダクトアクセスなし。CLIは初回実行時に一時アカウントを作成しますが、以下のローカルコマンドと認証/課金エンドポイントのみにアクセスできます。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）。 |
| ローカル（API呼び出しなし、クレジット不要、プラン不要） | マシン上で完全に実行されるため、プラン不要で動作：wonda brand extract <url>（--save なし）、wonda compose motion/wonda compose text、wonda wab record <url>、ローカルファイルに対する wonda edit ... ffmpegプリミティブ変換、wonda doctor。Chromiumベースのものは1回限りの wonda wab install が必要です。 |
コマンドが 403（paid_plan_required）を返した場合、https://wonda.sh/account でサブスクライブしてください。
ボイスクローン
10秒以上の音声クリップから声をクローンし、TTSで使用します。ハードリミット：アカウントあたり20のクローン声。費用：クローンあたり$1.50。
# ローカルファイルからクローン（最初に自動的にメディアライブラリにアップロード）
wonda voice create "Andu" --file ./sample.mp3 --description "私の声"
# 既存のWondaメディアからクローン
wonda voice create "Brand" --media-id <uuid>
# オプションのソース音声前処理
wonda voice create "Clean" --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 "こんにちは世界" \
--model minimax-speech-2-8-hd \
--params '{"voiceId":"<providerVoiceId>"}'
7日間の有効期限：TTSで7日間使用されなかったクローン声は自動的に期限切れになります。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>
# 取得 + 使用理由を一度に記録 — 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> またはウェブ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クライアントによって [deprecated METHOD /path] <message> としてstderrに表示されます。
両方のチャンネルを WONDA_QUIET=1（環境変数）または --quiet（フラグ）でサイレンスにします。ネットワークチェックのみを無効にするには WONDA_NO_UPDATE_CHECK=1 を使用します。
WAB / Wonda Automation Browser（wonda wab）
Wonda Automation Browser（WAB）は、プレミアムステルスアンチディテクトブラウザで、プラットフォームが自動化としてフィンガープリントできないように強化されています。wonda wab はアンチディテクトChromiumスタック（Undetected Playwrightフォーク）の1つのコマンドです。2つの面があります：
- 認証済みセッション。 LinkedIn、X、Redditなどのサインイン済みセッションを保持する、ペルソナごとに1つの永続的なヘッドフルChromium。CLIはオンデマンドで起動し、アイドルアウトさせ、コマンドが
--via wabで実行されるたびにプラットフォームの読み取り/書き込みをルーティングします。CookieはペルソナのChromiumプロファイルに保存され、~/.wonda/config.jsonには保存されません。 - 匿名キャプチャ。
wonda wab record <url>（およびwonda brand extract）は、新しいフィンガープリント、ペルソナなし、CookieなしでエフェメラルChromiumを駆動します。以下のrecordブロックを参照。
概念モデル：あなたはアカウント（プラットフォームごとに1つのアイデンティティ）を持っています。各プラットフォームコマンドは、フラットなJSONストア（--via cookies、高速、Chromium不要）またはアカウントのペルソナ（--via wab、ライブアンチディテクトChromium）のいずれかを介して、そのアカウントのCookieにルーティングします。ペルソナは、1つのフィンガープリントで複数のアカウントを保持できるChromiumエンベロープです。ほとんどの場合、ペルソナは最初の --via wab 使用時に自動的に作成され、アカウントにちなんで名前が付けられるため、ペルソナ名を入力する必要はありません。
ローカルの wonda.mcpb Desktop Extensionは、Claude DesktopまたはClaude Codeからこの同じローカルWABパスを使用します：プラットフォームCookieはデバイス上に残り、読み取りはローカルCookieを使用し、書き込みはローカルWABを使用します。Claude WebおよびCoworkは代わりにリモートMCPコネクタが必要です。
ネイティブログイン...