mcpField
P
parallel-cli-setup

parallel-cli-setup

github.com/parallel-web生産性916.0k 回インストール1 週間前に更新
リポジトリ

parallel-cli-setup について

`parallel-cli` のセットアップと保守を支援するスキルです。インストール、バージョン確認、認証、残高確認、Parallel スキルの導入を行い、検索や抽出、調査の実行準備に使えます。

主な機能

  1. 01CLI のインストールまたは更新
  2. 02認証の確認と設定
  3. 03アカウント残高の確認と追加
  4. 04Parallel スキルの導入
  5. 05初回の検索・調査の提案

活用シーン

  1. 01`parallel-cli` のインストールまたは更新
  2. 02CLI のデバイス認証
  3. 03アカウント残高の確認や追加
  4. 04検索前のスキル導入

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/parallel-web/parallel-agent-skills --skill parallel-cli-setup

インストール後、Claude Code で/parallel-cli-setupを入力して読み込まれたか確認します。

詳細

Parallel CLI のセットアップ

最小限の手間で parallel-cli をセットアップまたは管理します。このプロンプトを実行している場合、目標は以下の手順に従ってユーザー向けに parallel-cli をセットアップし、検索、抽出の実行、詳細な調査などを行えるようにすることです。

ステップ 1：CLI をインストールまたはアップグレードする

CLI が存在するか確認します。

command -v parallel-cli

存在しない場合は、次のいずれかの方法でインストールします。

  1. macOS のみ：brew install parallel-web/tap/parallel-cli
  2. Linux/macOS/Windows（uv）：uv tool install "parallel-web-tools[cli]"
  3. Linux/macOS/Windows（npm）：npm install -g parallel-web-cli
  4. Linux/macOS/Windows（pipx）：pipx install "parallel-web-tools[cli]" && pipx ensurepath

parallel-cli が存在する場合は、バージョンが >=0.9.2 であることを確認します。古い場合は、更新を案内する前にインストール方法を特定します。command -v parallel-cli を実行し、シンボリックリンクの場合は readlink "$(command -v parallel-cli)" を確認します。~/.local/share/uv/ tools/ 配下のパスは uv tool install を、~/.local/share/parallel-cli/ 配下のパスはスタンドアロンインストーラーを示します。

アップグレードコマンド（インストール方法に応じて選択します）：

  • スタンドアロン：parallel-cli update
  • uv：uv tool upgrade parallel-web-tools[cli]
  • pipx：pipx upgrade parallel-web-tools[cli]
  • npm：npm update -g parallel-web-cli
  • homebrew：brew update && brew upgrade parallel-web/tap/parallel-cli

ステップ 2：認証する

認証状態を確認します。

parallel-cli auth --json

次のような応答が返されます。

{
  "authenticated": true,
  "method": "oauth",
  "env_var_set": false,
  "has_stored_credentials": true,
  "stored_overridden_by_env": false,
  "token_file": "xxx",
  "version": 1,
  "selected_org_id": "legacy",
  "selected_org_name": null,
  "has_control_api_tokens": false
}

authenticated が false、または selected_org_id が legacy の場合は、ユーザーにログインを促します。

parallel-cli login --json

ヘッドレスセッションの場合は、--no-browser を追加します。

これによりデバイス OAuth が開始されます。ユーザーにはウェブブラウザーに移動して、CLI が出力したコードを入力するよう求められます。

エージェントハーネスから呼び出す場合は、完了までブロックするのではなく、Monitor 形式のツールを使って標準出力をストリーミングすることをおすすめします。

出力は次のようになります。

{"event": "auth_start"}
{"event": "device_code", "verification_uri": "http://localhost:3000/getServiceKeys/device", "verification_uri_complete": "http://localhost:3000/getServiceKeys/device?user_code=CHQX-NQKP&onboard_variant=agent", "user_code": "CHQX-NQKP", "expires_in": 600, "browser_open_attempted": true, "browser_opened": true}
{"event": "auth_waiting"}
{"event": "auth_success"}

{"event": "auth_success"} は、ユーザーによる CLI の認証が正常に完了した後にのみ出力されます。それ以外の場合は、{"event": "auth_waiting"} の状態で待機します。

ステップ 3：残高を確認する

認証後、現在の残高を確認します。

parallel-cli balance get

残高がゼロの場合は、ユーザーに残高の追加を促します。

parallel-cli balance add <AMOUNT_IN_CENTS>

組織に支払い方法が追加されている必要があることを明確に伝えてください。追加されていない場合、ユーザーは https://platform.parallel.ai/settings にアクセスして追加できます。

ステップ 4：Parallel のスキルをインストールする

ユーザー向けにスキルをインストールします。

parallel-cli skills install

ホットリロードに対応していない場合、ユーザーはエージェントを再起動する必要があります。

ステップ 5：最初の実行を提案する

新しくインストールしたスキルを使って、すぐに検索または抽出を実行するようユーザーに促します。次のいずれかを提案してください（Codex では / の代わりに $ を使用します）。

  • /parallel-web-search <query> — 高速なウェブ検索
  • /parallel-web-extract <url> — URL からコンテンツを抽出
  • /parallel-deep-research <topic> — 包括的な調査
  • /parallel-data-enrichment <list> — エンティティのリストを拡充

コメント

Markdown 対応