Parallel Cli

Опциональный сторонний навык для Parallel CLI — агент-нативный веб-поиск, извлечение, глубокое исследование, обогащение, FindAll и мониторинг. Предпочитайте JSON-вывод и неинтерактивные сценарии.

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

Источник	Опционально — установка через vibeos skills install official/research/parallel-cli
Путь	optional-skills/research/parallel-cli
Версия	1.1.0
Автор	VibeOS
Лицензия	MIT
Платформы	linux, macos, windows
Теги	Research, Web, Search, Deep-Research, Enrichment, CLI
Связанные навыки	duckduckgo-search, mcporter

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

к сведению

Ниже приведено полное определение навыка, которое VibeOS загружает при активации этого навыка. Агент видит эти инструкции, когда навык активен.

Parallel CLI

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

Это опциональный сторонний рабочий процесс, а не базовая возможность VibeOS.

Важные ожидания:

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

parallel-cli разработан для агентов:

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

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

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

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

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

Установка

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

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.

Основной набор правил

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

При обобщении результатов:

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

Извлечение

Используйте для получения чистого контента или разметки из 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

Рекомендуемый рабочий процесс VibeOS:

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

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

Рекомендуемые шаблоны использования VibeOS

Быстрый ответ с цитатами

1. Запустите parallel-cli search ... --json
2. Разберите заголовки, URL-адреса, даты, выдержки
3. Обобщите со встроенными цитатами только из возвращенных URL-адресов

Исследование URL

1. Запустите parallel-cli extract URL --json
2. При необходимости перезапустите с --objective или --full-content
3. Процитируйте или обобщите извлеченную разметку

Длинный исследовательский рабочий процесс

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/браузером.
• Предпочитайте выполнение на переднем плане для коротких задач; не злоупотребляйте фоновыми процессами.
• Для больших наборов результатов сохраняйте JSON в /tmp/*.json вместо того, чтобы помещать все в контекст.
• Не выбирайте молча Parallel, когда нативных инструментов VibeOS уже достаточно.
• Помните, что это вендорский рабочий процесс, который обычно требует аутентификации учетной записи и платного использования за пределами бесплатного тарифа.