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 調查

長研究工作流

結構化增強工作流

錯誤處理和退出碼

維護

常見陷阱