Perplexity CLI выходит за $5 за 1 000 запросов: поиск для агентов без лишних токенов

До сих пор интеграция поиска Perplexity в скрипты и агентные цепочки требовала самописных обёрток вокруг API. Теперь компания выпустила готовый бинарный файл pplx, который ставится одной командой в терминале и работает одинаково для человека и для ИИ-агента. В документации прямо сказано: это не разговорный интерфейс, здесь нет выбора модели и нет синтезированного ответа.

Всего две команды и строгий контракт вывода

• pplx search web запускает поиск в интернете и возвращает список результатов с URL, заголовком, доменом и фрагментом текста.
• pplx content fetch загружает указанную страницу и отдаёт очищенный текст.
• Успешный запрос завершается кодом 0 и ровно одним JSON-объектом в стандартном выводе. Любая ошибка завершается кодом 1: в стандартный вывод ничего не попадает, а описание ошибки уходит в stderr (поток для сообщений об ошибках).
• Задокументированы коды ошибок AUTHENTICATION, UNKNOWN_ARGUMENT, ARGUMENT_ERROR и BAD_REQUEST, но список не исчерпывающий, поэтому вызывающий код должен обрабатывать поле error.code как произвольную строку.
• Режима диалога нет, выбора модели нет, синтезированного ответа нет.

Экономия токенов как часть архитектуры

Ключевая деталь для тех, кто строит агентные (agentic) цепочки: Perplexity CLI позволяет не раздувать контекстное окно модели лишним текстом.

Флаг --stdout-preview обрезает длинные строковые поля в выводе, добавляя маркер ...<truncated>. Полный результат при этом сохраняется в файл через --output-dir.

Документация предупреждает о ловушке: --stdout-preview без указания директории для сохранения ничего не обрезает и возвращает полный вывод. Каждый результат поиска может занимать несколько килобайт, и без правильной пары флагов экономии не будет.

Переменная окружения PPLX_OUTPUT_DIR задаёт директорию по умолчанию, чтобы не повторять флаг в каждом вызове. Результаты поиска попадают в {dir}/web/{rand}.json, загруженные страницы в {dir}/fetch/{rand}.json.

Три платформы, без Windows

Установка занимает одну команду в терминале:

curl -fsSL https://github.com/perplexityai/perplexity-cli/releases/latest/download/install.sh | sh

Скрипт скачивает манифест из последнего релиза, фиксирует версию (чтобы не столкнуться с гонкой при параллельной публикации), проверяет контрольную сумму SHA256 и кладёт бинарник в ~/.local/bin/pplx. Права суперпользователя не нужны.

Поддерживаются три платформы:

• macOS на Apple Silicon
• Linux x86_64
• Linux arm64

Сборки для Windows и для Intel-процессоров на macOS нет.

Аутентификация: терминал или переменная окружения

Команда pplx auth login работает только в интерактивном терминале. Для ИИ-агентов и систем непрерывной интеграции (CI) единственный путь: экспортировать переменную окружения PERPLEXITY_API_KEY.

Как попробовать?

1. Получите API-ключ на сайте Perplexity в разделе для разработчиков.
2. Установите CLI командой выше (macOS Apple Silicon или Linux).
3. Экспортируйте ключ: export PERPLEXITY_API_KEY=ваш_ключ.
4. Запустите первый поиск: pplx search web "ваш запрос" и проверьте JSON-вывод.

Есть ли аналоги в России?

Прямого аналога Perplexity CLI среди российских сервисов пока нет. YandexGPT предоставляет API для генерации текста, GigaChat от Сбера тоже доступен через API, но оба инструмента заточены под генерацию ответов, а не под возврат структурированных поисковых результатов с источниками в формате JSON.

Для задач поиска российские разработчики могут использовать Yandex XML (поисковый API Яндекса), но он не объединён с языковой моделью и не возвращает очищенный текст страниц одной командой.

Что это значит для вас?

Разработчику и автоматизатору. Perplexity CLI закрывает конкретную нишу: получить поисковые результаты со ссылками в машиночитаемом виде без написания обёртки. Цена $5 за тысячу запросов предсказуема, но при активной автоматизации набегает быстро. Считайте бюджет заранее.

Автору Дзена. Напрямую CLI вам не нужен, но если вы пользуетесь ИИ-агентами для исследования тем, этот инструмент даёт агенту доступ к свежему вебу с источниками, а не к замкнутым знаниям модели.

Предпринимателю в РФ. API Perplexity доступен из России, но стабильность доступа зависит от текущей ситуации с блокировками. Перед тем как строить на нём продукт, проверьте латентность и доступность из вашего региона.

Частые вопросы

Perplexity CLI это чат-бот?

Нет. В CLI нет режима диалога, нет выбора модели и нет синтезированного ответа. Инструмент возвращает структурированные поисковые результаты и текст страниц в формате JSON. Для обычного общения с Perplexity используйте веб-интерфейс или мобильное приложение.

Можно ли использовать CLI бесплатно?

Нет. Для работы нужен API-ключ Perplexity, а поисковые запросы через API тарифицируются по $5 за 1 000 запросов. Лимит составляет 50 запросов в секунду на любом тарифном плане.

Работает ли Perplexity CLI на Windows?

На момент релиза сборки для Windows нет. Поддерживаются только macOS на Apple Silicon, Linux x86_64 и Linux arm64. Пользователи Windows могут попробовать запуск через WSL (подсистему Windows для Linux), но официально это не заявлено.