Перейти к содержанию

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
info
Ниже приведено полное определение скилла, которое Hermes загружает при его активации. Это те инструкции, которые видит агент, когда скилл активен.
# Parallel CLI
Используйте parallel-cli, когда пользователь явно хочет Parallel, или когда рабочий процесс в терминале выиграет от проприетарного стека Parallel для поиска в интернете, извлечения данных, глубокого исследования, обогащения, обнаружения сущностей или мониторинга.
Это опциональный сторонний рабочий процесс, а не базовое ядро Hermes.
Важные ожидания:
* Parallel — это платный сервис с бесплатным тарифом, а не полностью бесплатный локальный инструмент.
* Он пересекается с родными инструментами Hermes web_search / web_extract, поэтому не используйте его по умолчанию для обычных запросов.
* Используйте этот скилл, когда пользователь упоминает Parallel конкретно или когда нужны возможности, такие как обогащение (enrichment), FindAll или мониторинг от Parallel.

parallel-cli спроектирован для агентов: * JSON-вывод через --json * Неинтерактивное выполнение команд * Асинхронные долгоиграющие задачи с --no-wait, status и poll * Цепочки контекста с --previous-interaction-id * Поиск, извлечение, исследование, обогащение, обнаружение сущностей и мониторинг в одном CLI

Когда использовать

Используйте этот скилл, когда: * Пользователь явно упоминает Parallel или parallel-cli * Задача требует более сложных рабочих процессов, чем простой одноразовый поиск/извлечение * Вам нужны асинхронные задачи глубокого исследования, которые можно запустить и опросить позже * Вам нужно структурированное обогащение, обнаружение сущностей FindAll или мониторинг

Используйте родные инструменты Hermes web_search / web_extract для быстрых одноразовых запросов, когда Parallel не был явно запрошен.

Установка

Попробуйте наименее инвазивный способ установки, доступный для вашего окружения.

Homebrew

[code] brew install parallel-web/tap/parallel-cli

[/code]

npm

[code] npm install -g parallel-web-cli

[/code]

Пакет Python

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

[/code]

Автономный установщик

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

[/code] Если вам нужна изолированная установка Python, также подойдёт pipx: [code] pipx install "parallel-web-tools[cli]"
pipx ensurepath

[/code]

Аутентификация

Интерактивный вход: [code] parallel-cli login

[/code] Безголовый режим / SSH / CI: [code] parallel-cli login --device

[/code] Переменная окружения для API-ключа: [code] export PARALLEL_API_KEY="***"

[/code] Проверка текущего статуса аутентификации: [code] parallel-cli auth

[/code] Если аутентификация требует взаимодействия с браузером, запускайте с pty=true.

Основные правила

  1. Всегда используйте --json, когда вам нужен машиночитаемый вывод.
  2. Предпочитайте явные аргументы и неинтерактивные сценарии.
  3. Для долгоиграющих задач используйте --no-wait, а затем status / poll.
  4. Цитируйте только URL-адреса, возвращённые в выводе CLI.
  5. Сохраняйте большие JSON-выводы во временный файл, если вероятны уточняющие вопросы.
  6. Используйте фоновые процессы только для действительно долгих задач; в остальных случаях запускайте в обычном режиме.
  7. Предпочитайте родные инструменты Hermes, если пользователь не хочет Parallel конкретно или если нужны только функции Parallel.

Краткая справка

[code] 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

[/code]

Распространённые флаги и шаблоны

Полезные флаги: * --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, когда удобно: [code] echo "What is the latest funding for Anthropic?" | parallel-cli search - --json
echo "Research question" | parallel-cli research run - --json

[/code]

Поиск

Используйте для текущих веб-запросов со структурированными результатами. [code] 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

[/code] Полезные ограничения: * --include-domains для сужения круга доверенных источников * --exclude-domains для исключения зашумлённых доменов * --after-date для фильтрации по дате * --max-results когда нужно больше результатов

Если ожидаются уточняющие вопросы, сохраните вывод: [code] parallel-cli search "latest React 19 changes" --json -o /tmp/react-19-search.json

[/code] При обобщении результатов: * начинайте с ответа * включайте даты, имена и конкретные факты * ссылайтесь только на возвращённые источники * не выдумывайте URL-адреса или названия источников

Извлечение данных

Используйте для получения чистого содержимого или markdown по URL-адресу. [code] 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

[/code] Используйте --objective, когда страница широкая, а вам нужен только один фрагмент информации.

Глубокое исследование

Используйте для более глубоких многошаговых исследовательских задач, которые могут занять время. Распространённые уровни процессора: * lite / base для более быстрых и дешёвых проходов * core / pro для более тщательного синтеза * ultra для самых тяжёлых исследовательских задач

Синхронный режим

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

[/code]

Асинхронный запуск + опрос

[code] 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

[/code]

Цепочки контекста / уточнение

[code] 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

[/code] Рекомендуемый рабочий процесс в Hermes: 1. Запустите с --no-wait --json 2. Захватите возвращённый ID задачи/запуска 3. Если пользователь хочет продолжить работу, двигайтесь дальше 4. Позже вызовите status или poll 5. Обобщите итоговый отчёт с цитированием из возвращённых источников

Обогащение

Используйте, когда у пользователя есть CSV/JSON/табличные данные и он хочет добавить дополнительные столбцы на основе веб-исследования.

Предложение столбцов

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

[/code]

Планирование конфигурации

[code] parallel-cli enrich plan -o config.yaml

[/code]

Встроенные данные

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

[/code]

Неинтерактивный запуск с файлом

[code] 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"

[/code]

Запуск через YAML-конфиг

[code] parallel-cli enrich run config.yaml

[/code]

Статус / опрос

[code] parallel-cli enrich status --json
parallel-cli enrich poll --json

[/code] Используйте явные JSON-массивы для определения столбцов при неинтерактивной работе. Проверьте выходной файл перед тем, как сообщить об успехе.

FindAll

Используйте для поиска сущностей в веб-масштабе, когда пользователь хочет получить найденный набор данных, а не краткий ответ. [code] 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 --json
parallel-cli findall poll --json
parallel-cli findall result --json
parallel-cli findall schema --json

[/code] Это лучше подходит, чем обычный поиск, когда пользователь хочет получить набор обнаруженных сущностей, которые можно просмотреть, отфильтровать или обогатить позже.

Мониторинг

Используйте для постоянного отслеживания изменений с течением времени. [code] parallel-cli monitor list --json
parallel-cli monitor get --json
parallel-cli monitor events --json
parallel-cli monitor delete --json

[/code] Создание обычно самая чувствительная часть, так как важны периодичность и доставка: [code] parallel-cli monitor create --help

[/code] Используйте это, когда пользователь хочет регулярно отслеживать страницу или источник, а не выполнять одноразовый запрос.

Рекомендуемые шаблоны использования в 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

Обслуживание

Проверка текущего состояния аутентификации/установки: [code] parallel-cli auth
parallel-cli --help

[/code] Команды обновления: [code] parallel-cli update
pip install --upgrade parallel-web-tools
parallel-cli config auto-update-check off

[/code]

Типичные ошибки