Запись архива

Perplexity выпустила pplx — CLI для поискового API, ориентированный на кодинг-агентов

Perplexity представила официальный CLI-клиент pplx для своего Search API. Утилита возвращает результаты поиска и содержимое страниц в виде JSON, нацелена на использование в агентных пайплайнах и скриптах.

Скриншот работы CLI-утилиты pplx от Perplexity: команда поиска в вебе с выводом JSON-результатов в терминале
Скриншот работы CLI-утилиты pplx от Perplexity: команда поиска в вебе с выводом JSON-результатов в терминале
Firefox–devtools–dark-theme–new-tab-page.png | by Vitaly Zdanevich | wikimedia_commons | CC BY-SA 4.0

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/)