bg-szy/TOP-SKILLS

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トークンを受け取ります。サーバーはそれらのトークンをアカウントの内部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）が、ローカルMCP設定なしでユーザー自身のMacおよび住宅用IP上でアクションを実行できるようにします：

1. サインインした状態で https://wonda.sh/download を開き、公証されたMacパッケージをインストールします。
2. wonda relay pair または初回起動時のブラウザハンドオフでリレーをペアリングします。これにより、macOSキーチェーンに保存されたリレースコープのwrelay_...クレデンシャルを使用して、既存のcli-authフローが実行されます。ユーザーにAPIキーやデバイスコードを貼り付けさせないでください。
3. 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 で表示）、オペレーターがプロジェクト別に支出を監視する場合はタスクごとに設定する必要があります：

• 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から組織ウォレットにチャージすることはできません。

組織内のロールはシートプランとは別です：

• Owner（所有者）：元の作成者。降格やキックはできません。組織ページから別のメンバーに所有権を移譲できます（稀）。
• Admin（管理者）：招待（単一またはペーストによる一括）、キック、ロール変更、シート変更、チャージ、自動チャージ設定、月間制限変更ができます。
• User（ユーザー）：組織ウォレット内でのみ支出できます（管理者が設定した場合、メンバーごとの月間制限の対象となります）。

有料の組織シート（WONDA / WONDA_PREMIUM）は、組織コンテキスト内でのみ、個人の有料プランと同じ有料機能アクセス（スキルなど）を付与します。wonda use --personal はユーザーの個人アカウントプランにフォールバックします。

アクセス階層

Wondaは有料専用です。すべてのプロダクトサーフェス（生成、メディア、公開、スクレイピング、分析、スキル、クラウドツイン）には有料プランが必要です。新規アカウントはクレジットがなく、サブスクライブするまでプロダクトアクセスもありません。

階層	アクセス
Anonymous（一時アカウント、ログインなし）	プロダクトアクセスなし。CLIは初回実行時に一時アカウントを作成しますが、以下のローカルコマンドと認証/課金エンドポイントにのみ到達します。wonda auth login を実行し、サブスクライブしてください。
Free（ログイン済み、有料プランなし）	プロダクトアクセスなし。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：プロビジョニング、スケジュール実行、ストリームログイン）をアンチディテクト/シャドウバン保護、キャップなし、米国アカウント作成とともに提供。
Flagged（アカウントごとのPostHogキルスイッチ）	有料プランに含まれますが、アカウントごとのフラグでゲート可能：wonda reddit signup（redditAccountCreationEnabled）、wonda email（emailServerApiEnabled）、公開LinkedInプロファイルエンリッチメント（linkedinProfileEnrichmentEnabled）。
Local（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

# 単一のボイス
wonda voice get <voice-id>

# 名前の変更 / 説明の変更（ローカルのみ、プロバイダ呼び出しなし）
wonda voice update <voice-id> --name "新しい名前" --description "..."

# 削除
wonda voice delete <voice-id>

クローンボイスをTTSで使用するには、voice get からの providerVoiceId を voiceId として /audio/speech に渡します：

wonda audio speech "Hello world" \
  --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です。なぜなら「使用」イベントを理由とともに書き込むからです。理由を明示できる場合は `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スタック（undetected Playwrightフォーク）のための単一コマンドです。2つの側面があります：

• 認証済みセッション。 ペルソナごとに1つの永続的なヘッドフルChromiumで、LinkedIn、X、Redditなどのサインイン済みセッションを保持します。CLIはオンデマンドでそれを起動し、アイドル状態でタイムアウトさせ、コマンドが --via wab で実行されるたびにプラットフォームの読み書きを経由させます。クッキーはペルソナのChromiumプロファイルに保存され、~/.wonda/config.json には保存されません。
• 匿名キャプチャ。 wonda wab record <url>（および wonda brand extract）は、新しいフィンガープリント、ペルソナなし、クッキーなしのエフェメラルChromiumを駆動します。以下の record ブロックを参照してください。

メンタルモデル：アカウント（プラットフォームごとに1つのアイデンティティ）があります。各プラットフォームコマンドは、フラットなJSONストア（--via cookies、高速、Chromium不要）またはアカウントのペルソナ（--via wab、ライブアンチディテクトChromium）を介して、そのアカウントのクッキーにルーティングします。ペルソナは、1つのフィンガープリントの下で複数のアカウントを保持できるChromiumエンベロープです。ほとんどの場合、ペルソナは最初の --via wab 使用時に自動的に作成され、アカウントにちなんで名付けられるため、ペルソナ名を入力する必要はありません。

ローカルの wonda.mcpb デスクトップ拡張機能は、Claude DesktopまたはClaude Codeからこの同じローカルWABパスを使用します：プラットフォームクッキーはデバイス上に留まり、読み取りはローカルクッキーを使用し、書き込みはローカルWABを使用します。Claude WebおよびCoworkは、代わりにリモートMCPコネクタが必要です。

ネイティブログイン

...