Parallel Cli

Агент-ориентированный поиск в вебе, глубокие исследования и обогащение данных.

Метаданные навыка

Справочник: полный SKILL.md

Parallel CLI

Используй parallel-cli, когда пользователь явно запрашивает Parallel, или когда задача выигрывает от специфического стека Parallel: поиск в вебе, извлечение контента, глубокие исследования, обогащение данных, поиск сущностей и мониторинг.

Это опциональный сторонний рабочий процесс, а не встроенная функция Hermes.

Важные оговорки:

• Parallel — платный сервис с бесплатным тиром, а не полностью бесплатный локальный инструмент.
• Он пересекается с нативными web_search / web_extract Hermes, поэтому для обычных поисковых запросов его не нужно предпочитать по умолчанию.
• Выбирай этот навык, когда пользователь упоминает Parallel явно или нуждается в возможностях вроде обогащения данных, FindAll или мониторинга.

parallel-cli спроектирован для агентных сценариев:

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

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

Предпочитай этот навык, когда:

• Пользователь явно упоминает Parallel или parallel-cli
• Задача требует более сложных рабочих процессов, чем простой одиночный поиск или извлечение
• Нужны асинхронные задачи глубокого исследования, которые можно запустить и опросить позже
• Требуется структурированное обогащение, поиск сущностей через FindAll или мониторинг

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

Установка

Выбери наименее инвазивный способ установки для текущей среды.

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

Headless / 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. Цитируй только URL-адреса из вывода CLI.
5. Большие JSON-результаты сохраняй во временный файл, если вероятны дальнейшие вопросы.
6. Фоновые процессы — только для действительно долгих задач; в остальных случаях запускай в foreground.
7. Предпочитай нативные инструменты Hermes, если пользователь не запрашивает Parallel специально или не нужны его уникальные рабочие процессы.

Краткий справочник

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 ~/.hermes/cache/scratch/react-19-search.json

При формулировке ответа:

• начни с самого ответа
• включай даты, имена и конкретные факты
• цитируй только возвращённые источники
• не придумывай URL или заголовки источников

Извлечение контента

Используй для получения чистого текста или markdown из URL.

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 или взаимодействия с браузером.
• Для коротких задач предпочитай foreground; не злоупотребляй фоновыми процессами.
• Большие результаты сохраняй в ~/.hermes/cache/scratch/*.json (scratch-каталог Hermes), не загромождая контекст.
• Не переключайся молча на Parallel, если нативных инструментов Hermes достаточно.
• Помни: это вендорный рабочий процесс, который обычно требует учётной записи и платного использования сверх бесплатного тира.