wonda-cli
概要
ターミナルからWonda CLIを使用して画像、動画、音楽、音声を生成し、LinkedIn、Reddit、X/Twitterでのリサーチと自動化を行います。
ワークフロー
name: wonda-cli description: ターミナルからWonda CLIを使用して画像、動画、音楽、音声を生成し、LinkedIn、Reddit、X/Twitterでのリサーチと自動化を行います。
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または初回起動時のブラウザハンドオフでリレーをペアリングします。これにより、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>— その呼び出しのための一回限りのオーバーライドです。 wonda project list|create|delete— アクティブなスコープでレジストリを管理します。組織プロジェクトは組織管理者/オーナーのみが作成できます。個人プロジェクトはセルフサービスです。存在しない名前に対するタグ付けはunknown_projectで失敗します（サイレントな新しいバケットはないため、タイプミスで監視データが分割されることはありません）。
wonda topup は、コンテキストに関係なく常に個人ウォレットをチャージします。組織ウォレットのチャージ（および自動チャージの設定）は管理者のみが行い、Webの /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: プロビジョニング、スケジュール実行、ストリームログイン）とアンチディテクト/シャドウバン保護、キャップなし、およびUSアカウント作成。 |
| フラグ付き（アカウントごとの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ベースのものは、一度 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 "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
# 取得 + 使用理由を記録（1回の呼び出し）— GETではなくPOSTであり、理由を含む「使用済み」イベントを書き込みます。理由を明確に説明できる場合は、`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クライアントによって [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スタック（未検出のPlaywrightフォーク）のための単一コマンドです。2つの側面があります。
- 認証済みセッション。 ペルソナごとに1つの永続的なヘッドフルChromiumが、LinkedIn、X、Redditなどのサインイン済みセッションを保持します。CLIはオンデマンドでそれを起動し、アイドルアウトさせ、コマンドが
--via wabで実行されるたびにプラットフォームの読み取り/書き込みをルーティングします。CookieはペルソナのChromiumプロファイルに存在し、~/.wonda/config.jsonにはありません。 - 匿名キャプチャ。
wonda wab record <url>（およびwonda brand extract）は、新しいフィンガープリント、ペルソナなし、CookieなしのエフェメラルChromiumを駆動します。以下のrecordブロックを参照してください。