mcpField
P
parallel-cli-setup

parallel-cli-setup

github.com/parallel-web生产力916.0k 次安装1 周前更新
代码仓库

关于 parallel-cli-setup

用于设置和维护 `parallel-cli` 的技能，涵盖安装、版本检查、认证、余额检查及 Parallel 技能安装，适合准备使用 CLI 执行搜索、提取或研究的用户。

主要功能

  1. 01安装或升级 CLI
  2. 02检查并配置认证
  3. 03检查并充值账户余额
  4. 04安装 Parallel 技能
  5. 05建议首次搜索或研究任务

适用场景

  1. 01安装或升级 `parallel-cli`
  2. 02完成 CLI 设备认证
  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 输出的代码。

从 Agent 调用时，优先使用 Monitor 风格的工具流式传输 stdout，而不是等待命令执行完成。

输出将类似于：

{"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"}

只有在用户成功授权 CLI 后，才会发出 {"event": "auth_success"}。否则会停留在 {"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

如果用户的 Agent 不支持热重载，可能需要重启。

第 5 步：建议首次运行

提示用户使用新安装的技能，立即运行搜索或提取。建议选择以下一项（对 Codex 使用 $ 代替 /）：

  • /parallel-web-search <query> — 快速网页搜索
  • /parallel-web-extract <url> — 提取 URL 中的内容
  • /parallel-deep-research <topic> — 全面研究
  • /parallel-data-enrichment <list> — 丰富实体列表

评论

支持 Markdown