Parallel Cli

用于 Parallel CLI 的可选供应商技能 — 代理原生网络搜索、提取、深度研究、信息增强、FindAll 和监控。优先使用 JSON 输出和非交互式流程。

技能元数据


来源	可选 — 使用 `hermes skills install official/research/parallel-cli` 安装
路径	`optional-skills/research/parallel-cli`
版本	`1.1.0`
作者	Hermes Agent
许可证	MIT
标签	`Research`, `Web`, `Search`, `Deep-Research`, `Enrichment`, `CLI`
相关技能	`duckduckgo-search`, `mcporter`

参考：完整 SKILL.md

信息

以下是 Hermes 在触发此技能时加载的完整技能定义。这是技能激活时代理看到的指令。

Parallel 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 时，对于快速的一次性查询，优先使用 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 运行。

核心规则集

当需要机器可读的输出时，始终优先使用 --json。
优先使用显式参数和非交互式流程。
对于长时间运行的任务，使用 --no-wait，然后使用 status / poll。
仅引用 CLI 输出返回的 URL。
当可能有后续问题时，将大型 JSON 输出保存到临时文件。
仅对真正长时间运行的工作流使用后台进程；否则在前台运行。
除非用户特别想要 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

方便时从 stdin 读取：

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 工作流：

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

增强（Enrichment）

当用户拥有 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

当用户想要一组可被审查、过滤或随后增强的已发现实体时，这比普通搜索更合适。

Monitor

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

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

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

错误处理和退出码

CLI 记录了以下退出码：

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

如果遇到认证错误：

检查 parallel-cli auth
确认 PARALLEL_API_KEY 或运行 parallel-cli login / parallel-cli login --device
验证 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。
请记住，这是一个供应商工作流，通常除了免费层级外，还需要账户认证和付费使用。

Parallel Cli

技能元数据

参考：完整 SKILL.md

Parallel CLI

何时使用

安装

Homebrew

npm

Python 包

独立安装程序

身份验证

核心规则集

快速参考

常用标志和模式

搜索

提取

深度研究

同步

异步启动 + 轮询

上下文链式调用 / 后续操作

增强（Enrichment）

建议列

规划配置

内联数据

非交互式文件运行

YAML 配置运行

状态 / 轮询

FindAll

Monitor

推荐的 Hermes 使用模式

带引用的快速回答

URL 调查

长研究工作流

结构化增强工作流

错误处理和退出码

维护

常见陷阱

技能元数据​

参考：完整 SKILL.md​

Parallel CLI

何时使用​

安装​

Homebrew​

npm​

Python 包​

独立安装程序​

身份验证​

核心规则集​

快速参考​

常用标志和模式​

搜索​

提取​

深度研究​

同步​

异步启动 + 轮询​

上下文链式调用 / 后续操作​

增强（Enrichment）​

建议列​

规划配置​

内联数据​

非交互式文件运行​

YAML 配置运行​

状态 / 轮询​

FindAll​

Monitor​

推荐的 Hermes 使用模式​

带引用的快速回答​

URL 调查​

长研究工作流​

结构化增强工作流​

错误处理和退出码​

维护​

常见陷阱​

技能元数据

参考：完整 SKILL.md

何时使用

安装

Homebrew

npm

Python 包

独立安装程序

身份验证

核心规则集

快速参考

常用标志和模式

搜索

提取

深度研究

同步

异步启动 + 轮询

上下文链式调用 / 后续操作

增强（Enrichment）

建议列

规划配置

内联数据

非交互式文件运行

YAML 配置运行

状态 / 轮询

FindAll

Monitor

推荐的 Hermes 使用模式

带引用的快速回答

URL 调查

长研究工作流

结构化增强工作流

错误处理和退出码

维护

常见陷阱