Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

title: “Parallel Cli — Agent-native web search, deep research, and enrichment” sidebar_label: “Parallel Cli” description: “Agent-native web search, deep research, and enrichment”

{/* 本页面由 website/scripts/generate-skill-docs.py 根据技能对应的 SKILL.md 文件自动生成。请直接编辑源文件 SKILL.md，而非此页面。 */}

Parallel Cli

集成在 Agent 内部的网络搜索、深度研究及信息增强功能。

技能元数据
来源可选 — 通过 hermes skills install official/research/parallel-cli 安装
路径optional-skills/research\parallel-cli
版本1.1.0
开发者Hermes Agent
许可协议MIT
支持平台linux、macos、windows
标签Research、Web、Search、Deep-Research、Enrichment、CLI
相关技能duckduckgo-search、mcporter

参考：完整 SKILL.md 内容

:::info 以下是当触发该技能时 Hermes 加载的完整技能定义。当技能处于激活状态时，Agent 会将此内容视为操作指令。
::

Parallel CLI

当用户明确要求使用并行处理功能，或终端原生工作流可从该功能针对网络搜索、信息提取、深度研究、信息增强、实体识别及监控等任务所优化的特定供应商技术栈中受益时，可使用 parallel-cli。

这属于可选的第三方工作流，并非 Hermes 的核心功能。

重要说明：

  • Parallel是一项提供免费试用版的付费服务，而非完全免费的本地工具。
  • 它与Hermes内置的web_search/web_extract功能存在重叠，因此对于常规查询，不建议默认优先使用它。
  • 当用户明确提及Parallel，或需要其特有的信息增强、FindAll功能以及工作流监控能力时，才应优先使用此技能。

parallel-cli专为智能体设计：

  • 支持通过--json参数输出JSON格式结果；
  • 支持非交互式命令执行；
  • 可借助--no-wait、status和poll参数实现异步长任务处理；
  • 通过--previous-interaction-id实现上下文串联；
  • 所有搜索、提取、研究、信息增强、实体发现及监控功能均可在同一命令行界面中完成。

适用场景

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

  • 用户明确提到Parallel或parallel-cli；
  • 任务需要比简单的一次性搜索/提取更复杂的工作流；
  • 需要可先启动后定时查询的异步深度研究任务；
  • 需要结构化信息增强、FindAll实体发现功能或工作流监控。

若用户未特别要求使用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 / 持续集成：

parallel-cli login --device

API密钥环境变量：

export PARALLEL_API_KEY="***"

验证当前认证状态：

parallel-cli auth

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

核心规则集

  1. 当需要机器可读的输出时，优先使用 --json 参数。
  2. 建议使用显式参数及非交互式流程。
  3. 对于长时间运行的任务，请先使用 --no-wait，再通过 status 或 poll 命令查看进度。
  4. 仅引用 CLI 输出中提供的网址。
  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

在总结结果时：

  • 首先给出答案；
  • 包含日期、姓名及具体事实；
  • 仅引用已提供的来源；
  • 避免编造网址或来源标题。

提取功能

用于从网址中获取纯净的内容或 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. 记录返回的运行/任务编号
  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 操作时可能需要终端或浏览器的交互支持。
  • 对于短时间内的任务，建议在前台运行，避免过度使用后台进程。
  • 当处理大量结果集时，应将 JSON 文件保存到 /tmp/*.json 目录中，而非将其全部存储在上下文中。
  • 若 Hermes 的内置工具已能满足需求，切勿擅自选择并行处理模式。
  • 请记住，这属于供应商提供的工作流，通常需要账号认证，并且超出免费套餐后还需付费使用。