跳到主要内容

并行命令行工具

适用于并行命令行的可选供应商技能——智能体原生网页搜索、数据提取、深度研究、信息增强、全局查找与监控。推荐使用 JSON 输出和非交互式流程。

技能元数据​

来源可选 — 使用 hermes skills install official/research/parallel-cli 安装
路径optional-skills/research/parallel-cli
版本1.1.0
作者Hermes 智能体
许可证MIT
平台linux, macos, windows
标签研究, 网页, 搜索, 深度研究, 信息增强, 命令行工具
相关技能duckduckgo-search, mcporter
信息

以下是 Hermes 加载此技能时看到的完整技能定义。当此技能处于活动状态时，这就是智能体看到的指令。

并行 CLI

当用户明确要求使用 Parallel，或者当终端原生工作流能从 Parallel 特定的供应商栈（用于网络搜索、提取、深度研究、丰富化、实体发现或监控）中受益时，请使用 parallel-cli。

这是一个可选的第三方工作流，而非 Hermes 的核心能力。

重要预期：

  • Parallel 是一项带有免费层级的付费服务，并非完全免费的本地工具。
  • 它与 Hermes 原生的 web_search / web_extract 功能重叠，因此对于普通查询，默认情况下不要优先使用它。
  • 当用户明确提到 Parallel 或需要 Parallel 的丰富化、FindAll 或监控工作流等功能时，请优先使用此技能。

parallel-cli 专为智能体设计：

  • 通过 --json 输出 JSON
  • 非交互式命令执行
  • 使用 --no-wait、status 和 poll 处理异步长时间运行的任务
  • 使用 --previous-interaction-id 进行上下文链接
  • 在一个 CLI 中集成搜索、提取、研究、丰富化、实体发现和监控功能

何时使用​

在以下情况下优先使用此技能：

  • 用户明确提到 Parallel 或 parallel-cli
  • 任务需要比单次搜索/提取更丰富的工作流
  • 您需要可以启动并在稍后轮询的异步深度研究任务
  • 您需要结构化的丰富化、FindAll 实体发现或监控

当未明确要求 Parallel 或不需要仅限于 Parallel 的工作流时，对于快速的一次性查询，请优先使用 Hermes 原生的 web_search / web_extract。

安装​

尝试为当前环境选择侵入性最小的安装路径。

Homebrew​

brew install parallel-web/tap/parallel-cli

npm​

npm install -g parallel-web-cli

Python 包​

pip install "parallel-web-tools[cli]"

独立安装程序​

curl -fsSL https://parallel.ai/install.sh | bash

如果您想要一个隔离的 Python 安装，pipx 也可以工作：

pipx install "parallel-web-tools[cli]"
pipx ensurepath

身份验证​

交互式登录：

parallel-cli login

无头 / SSH / CI 环境：

parallel-cli login --device

API 密钥环境变量：

export PARALLEL_API_KEY="***"

验证当前身份验证状态：

parallel-cli auth

如果身份验证需要浏览器交互，请使用 pty=true 运行。

核心规则集​

  1. 当需要机器可读的输出时，始终优先使用 --json。
  2. 优先使用显式参数和非交互式流程。
  3. 对于长时间运行的任务，使用 --no-wait，然后使用 status / poll。
  4. 仅引用 CLI 输出返回的 URL。
  5. 当可能存在后续问题时，将大型 JSON 输出保存到临时文件。
  6. 仅对确实需要长时间运行的工作流使用后台进程；否则在前台运行。
  7. 除非用户特别想要 Parallel 或需要仅限于 Parallel 的工作流，否则优先使用 Hermes 原生工具。

快速参考​

parallel-cli
├── auth
├── login
├── logout
├── search
├── extract / fetch
├── research run|status|poll|processors
├── enrich run|status|poll|plan|suggest|deploy
├── findall run|ingest|status|poll|result|enrich|extend|schema|cancel
└── monitor create|list|get|update|delete|events|event-group|simulate

常用标志和模式​

常用标志：

  • --json 用于结构化输出
  • --no-wait 用于异步任务
  • --previous-interaction-id <id> 用于复用早期上下文的后续任务
  • --max-results <n> 用于控制搜索结果数量
  • --mode one-shot|agentic 用于控制搜索行为
  • --include-domains domain1.com,domain2.com
  • --exclude-domains domain1.com,domain2.com
  • --after-date YYYY-MM-DD

方便时从标准输入读取：

echo "What is the latest funding for Anthropic?" | parallel-cli search - --json
echo "Research question" | parallel-cli research run - --json

搜索​

用于当前网页查询并获取结构化结果。

parallel-cli search "What is Anthropic's latest AI model?" --json
parallel-cli search "SEC filings for Apple" --include-domains sec.gov --json
parallel-cli search "bitcoin price" --after-date 2026-01-01 --max-results 10 --json
parallel-cli search "latest browser benchmarks" --mode one-shot --json
parallel-cli search "AI coding agent enterprise reviews" --mode agentic --json

有用的约束条件：

  • --include-domains 用于限定可信来源
  • --exclude-domains 用于排除嘈杂域名
  • --after-date 用于时间过滤
  • --max-results 当您需要更广泛覆盖时使用

如果预计有后续问题，请保存输出：

parallel-cli search "latest React 19 changes" --json -o /tmp/react-19-search.json

总结结果时：

  • 以答案开头
  • 包含日期、名称和具体事实
  • 仅引用返回的来源
  • 避免编造 URL 或来源标题

提取​

用于从 URL 拉取干净的内容或 Markdown。

parallel-cli extract https://example.com --json
parallel-cli extract https://company.com --objective "Find pricing info" --json
parallel-cli extract https://example.com --full-content --json
parallel-cli fetch https://example.com --json

当页面内容广泛而您只需要其中一部分信息时，请使用 --objective。

深度研究​

用于可能需要时间的更深入的多步骤研究任务。

常用处理器层级：

  • lite / base 用于更快、更便宜的处理
  • core / pro 用于更全面的综合
  • ultra 用于最繁重的研究任务

同步模式​

parallel-cli research run \
  "Compare the leading AI coding agents by pricing, model support, and enterprise controls" \
  --processor core \
  --json

异步启动 + 轮询​

parallel-cli research run \
  "Compare the leading AI coding agents by pricing, model support, and enterprise controls" \
  --processor ultra \
  --no-wait \
  --json

parallel-cli research status trun_xxx --json
parallel-cli research poll trun_xxx --json
parallel-cli research processors --json

上下文链接 / 后续任务​

parallel-cli research run "What are the top AI coding agents?" --json
parallel-cli research run \
  "What enterprise controls does the top-ranked one offer?" \
  --previous-interaction-id trun_xxx \
  --json

推荐的 Hermes 工作流：

  1. 使用 --no-wait --json 启动
  2. 捕获返回的运行/任务 ID
  3. 如果用户希望继续其他工作，则继续执行
  4. 稍后调用 status 或 poll
  5. 使用返回来源中的引用来总结最终报告

丰富化​

当用户拥有 CSV/JSON/表格输入，并希望通过网络研究推断出额外列时使用。

建议列​

parallel-cli enrich suggest "Find the CEO and annual revenue" --json

规划配置​

parallel-cli enrich plan -o config.yaml

内联数据​

parallel-cli enrich run \
  --data '[{"company": "Anthropic"}, {"company": "Mistral"}]' \
  --intent "Find headquarters and employee count" \
  --json

非交互式文件运行​

parallel-cli enrich run \
  --source-type csv \
  --source companies.csv \
  --target enriched.csv \
  --source-columns '[{"name": "company", "description": "Company name"}]' \
  --intent "Find the CEO and annual revenue"

YAML 配置运行​

parallel-cli enrich run config.yaml

状态 / 轮询​

parallel-cli enrich status <task_group_id> --json
parallel-cli enrich poll <task_group_id> --json

在非交互式操作时，对列定义使用显式 JSON 数组。 在报告成功之前验证输出文件。

FindAll​

当用户需要一个可被审查、过滤或丰富化的已发现实体数据集，而不是一个简短答案时，使用此功能进行网络规模实体发现。

parallel-cli findall run "Find AI coding agent startups with enterprise offerings" --json
parallel-cli findall run "AI startups in healthcare" -n 25 --json
parallel-cli findall status <run_id> --json
parallel-cli findall poll <run_id> --json
parallel-cli findall result <run_id> --json
parallel-cli findall schema <run_id> --json

当用户需要一组可审查、过滤或丰富化的已发现实体时，这比普通搜索更合适。

监控​

用于随时间进行的持续变更检测。

parallel-cli monitor list --json
parallel-cli monitor get <monitor_id> --json
parallel-cli monitor events <monitor_id> --json
parallel-cli monitor delete <monitor_id> --json

创建通常是敏感部分，因为频率和交付方式很重要：

parallel-cli monitor create --help

当用户希望对页面或来源进行定期跟踪，而不是一次性获取时，请使用此功能。

推荐的 Hermes 使用模式​

快速回答并附带引用​

  1. 运行 parallel-cli search ... --json
  2. 解析标题、URL、日期、摘要
  3. 使用仅来自返回 URL 的内联引用进行总结

URL 调查​

  1. 运行 parallel-cli extract URL --json
  2. 如果需要，使用 --objective 或 --full-content 重新运行
  3. 引用或总结提取的 Markdown

长时间研究工作流​

  1. 运行 parallel-cli research run ... --no-wait --json
  2. 存储返回的 ID
  3. 继续其他工作或定期轮询
  4. 使用返回来源中的引用来总结最终报告

结构化丰富化工作流​

  1. 检查输入文件和列
  2. 使用 enrich suggest 或提供显式的丰富化列
  3. 运行 enrich run
  4. 如果需要，轮询完成状态
  5. 在报告成功之前验证输出文件

错误处理与退出代码​

CLI 文档记录了以下退出代码：

  • 0 成功
  • 2 输入错误
  • 3 认证错误
  • 4 API 错误
  • 5 超时

如果遇到认证错误：

  1. 检查 parallel-cli auth
  2. 确认 PARALLEL_API_KEY 或运行 parallel-cli login / parallel-cli login --device
  3. 验证 parallel-cli 是否在 PATH 环境变量中

维护​

检查当前认证/安装状态：

parallel-cli auth
parallel-cli --help

更新命令：

parallel-cli update
pip install --upgrade parallel-web-tools
parallel-cli config auto-update-check off

注意事项​

  • 除非用户明确要求人类可读的输出格式，否则不要省略 --json。
  • 不要引用 CLI 输出中未呈现的来源。
  • login 可能需要 PTY/浏览器交互。
  • 对于短任务，首选前台执行；不要过度使用后台进程。
  • 对于大型结果集，将 JSON 保存到 /tmp/*.json，而不是全部塞进上下文中。
  • 当 Hermes 原生工具已足够时，不要无声无息地选择 Parallel。
  • 请记住这是一个供应商工作流程，通常需要账户认证，并且超出免费额度后需要付费使用。