
Perplexity выпустила официальный CLI-клиент для своего Search API — утилиту pplx. Это не чат-интерфейс, а инструмент для скриптов и агентов: он умеет выполнять поиск в вебе и извлекать текст со страниц, возвращая ровно один JSON-объект в stdout. Проект опубликован на GitHub под лицензией, допускающей коммерческое использование, и сразу получил Agent Skill для интеграции с Claude Code, Codex CLI и другими агентными средами.
Ключевые факты
| Параметр | Значение |
|---|---|
| Разработчик | Perplexity AI |
| Интерфейс | CLI, два режима: `pplx search web` и `pplx content fetch` |
| Вывод | JSON, один объект на stdout, ошибки — в stderr |
| Целевые платформы | macOS arm64, Linux x86_64, Linux arm64 |
| Установка | curl-скрипт с проверкой SHA256, без sudo, в ~/.local/bin |
Что умеет pplx
CLI предоставляет две команды. `pplx search web` выполняет живой поиск в интернете через API Perplexity и возвращает структурированный JSON с полями `hits` (массив результатов с URL, заголовком, доменом и сниппетом), `total` и опционально путём к сохранённому файлу. `pplx content fetch` загружает указанный URL и возвращает очищенный текст страницы.
Контракт прост: успешный вызов завершается с кодом 0 и одним JSON-объектом в stdout. Любая ошибка (неверный аргумент, проблемы аутентификации, превышение лимитов) — код 1, пустой stdout и один JSON-объект ошибки в stderr с полями `code`, `message`, `command` и опционально `hint`. Документированные коды: AUTHENTICATION, UNKNOWN_ARGUMENT, ARGUMENT_ERROR, BAD_REQUEST. В документации подчёркивается, что список неполный, поэтому вызывающие скрипты должны обрабатывать ошибки по коду, а не проверять наличие ожидаемых полей.
Установка для агентов
Инсталляция выполняется одной командой `curl -fsSL https://github.com/perplexityai/perplexity-cli/releases/latest/download/install.sh | sh`. Анализ скрипта показывает, что он скачивает манифест последнего релиза, фиксирует версию, загружает бинарник под целевую платформу и проверяет его SHA256-сумму. Все файлы привязываются к тегу, чтобы избежать гонок при публикации. Бинарник помещается в `~/.local/bin/pplx`, права root не требуются. После первого успешного запуска записывается рецепт в `~/.config/pplx/pplx-receipt.json`.
Ограничение: поддерживаются только три архитектуры — macOS на Apple Silicon, Linux x86_64 и Linux arm64. Для Windows или macOS на Intel установка завершится ошибкой.
Интеграция с агентными средами
Самый примечательный аспект pplx — это официальный Agent Skill, который описывает контракты для использования в Claude Code, Codex CLI и любых агентах, умеющих читать JSON и вызывать shell-команды. В инструкции явно указано: `–stdout-preview` — это не простой флаг для сокращения вывода. Он работает только вместе с `–output-dir` или переменной окружения `PPLX_OUTPUT_DIR`. Без каталога для сохранения флаг игнорируется, и весь результат (каждый hit может занимать несколько килобайт) выводится в stdout.
Для `content fetch` skill добавляет проверку корректности: перед использованием извлечённого текста нужно убедиться, что в JSON нет `error` и `is_paywall`.
Зачем это разработчикам
pplx решает конкретную боль: у агентов и скриптов не было стандартного, надёжного способа получать результаты поиска и контент страниц из Perplexity без написания HTTP-клиента с нуля. Однобинарный файл, проверка целостности, однозначный формат ошибок и полная бесшовная интеграция с Claude Code и Codex CLI делают его инструментом для автоматизации, а не для ручного копирования URL.
Источник: MarkTechPost — Perplexity Releases pplx, a Single-Binary CLI That Puts Its Search API in the Terminal for Coding Agents (https://www.marktechpost.com/2026/07/27/perplexity-releases-pplx/)
