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.
Основные правила¶
- Всегда используйте
--json, когда вам нужен машиночитаемый вывод. - Предпочитайте явные аргументы и неинтерактивные сценарии.
- Для долгоиграющих задач используйте
--no-wait, а затемstatus/poll. - Цитируйте только URL-адреса, возвращённые в выводе CLI.
- Сохраняйте большие JSON-выводы во временный файл, если вероятны уточняющие вопросы.
- Используйте фоновые процессы только для действительно долгих задач; в остальных случаях запускайте в обычном режиме.
- Предпочитайте родные инструменты 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
parallel-cli enrich poll
[/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
parallel-cli findall poll
parallel-cli findall result
parallel-cli findall schema
[/code] Это лучше подходит, чем обычный поиск, когда пользователь хочет получить набор обнаруженных сущностей, которые можно просмотреть, отфильтровать или обогатить позже.
Мониторинг¶
Используйте для постоянного отслеживания изменений с течением времени.
[code]
parallel-cli monitor list --json
parallel-cli monitor get
parallel-cli monitor events
parallel-cli monitor delete
[/code] Создание обычно самая чувствительная часть, так как важны периодичность и доставка: [code] parallel-cli monitor create --help
[/code] Используйте это, когда пользователь хочет регулярно отслеживать страницу или источник, а не выполнять одноразовый запрос.
Рекомендуемые шаблоны использования в Hermes¶
Быстрый ответ с цитированием¶
- Выполните
parallel-cli search ... --json - Извлеките заголовки, URL-адреса, даты, фрагменты
- Обобщите с цитатами только из возвращённых URL-адресов
Исследование URL¶
- Выполните
parallel-cli extract URL --json - При необходимости повторите с
--objectiveили--full-content - Процитируйте или обобщите извлечённый markdown
Долгий исследовательский процесс¶
- Выполните
parallel-cli research run ... --no-wait --json - Сохраните возвращённый ID
- Продолжайте другую работу или периодически опрашивайте
- Обобщите итоговый отчёт с цитированием
Структурированный процесс обогащения¶
- Изучите входной файл и столбцы
- Используйте
enrich suggestили укажите явные столбцы для обогащения - Запустите
enrich run - При необходимости опросите статус завершения
- Проверьте выходной файл перед сообщением об успехе
Коды ошибок и их обработка¶
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]
Типичные ошибки¶
- Не опускайте
--json, если пользователь явно не хочет человекочитаемый вывод. - Не ссылайтесь на источники, отсутствующие в выводе CLI.
loginможет требовать PTY/взаимодействия с браузером.- Отдавайте предпочтение обычному выполнению для коротких задач; не злоупотребляйте фоновыми процессами.
- Для больших наборов результатов сохраняйте JSON в
/tmp/*.json, вместо того чтобы помещать всё в контекст. - Не выбирайте Parallel молча, если родных инструментов Hermes уже достаточно.
-
Помните, что это сторонний рабочий процесс, который обычно требует регистрации аккаунта и платного использования за пределами бесплатного тарифа.
- Справочник: полный SKILL.md
- Когда использовать
- Установка
- Аутентификация
- Основные правила
- Краткая справка
- Распространённые флаги и шаблоны
- Поиск
- Извлечение данных
- Глубокое исследование
- Обогащение
- FindAll
- Мониторинг
- Рекомендуемые шаблоны использования в Hermes
- Коды ошибок и их обработка
- Обслуживание
- Типичные ошибки