Только данные, никакого чата
Perplexity выпустила pplx — одностраничный бинарный файл для командной строки, разработанный специально для интеграции с AI-агентами. В отличие от привычных чат-интерфейсов, этот инструмент не генерирует ответы, не выбирает модели и не поддерживает диалоговый режим. Его единственная задача — предоставить агентам «заземленные» результаты поиска и очищенный текст страниц в формате JSON.
Интерфейс состоит из двух команд:
- pplx search web — выполняет живой поиск по веб-страницам.
- pplx content fetch — извлекает и очищает текст по указанному URL.
Жесткий контракт успеха и ошибок
Архитектура pplx построена на принципе минимализма для упрощения парсинга агентами. Успешное выполнение всегда означает код выхода 0 и ровно один JSON-объект в stdout. Ошибки обрабатываются через stderr с кодом выхода 1 и структурированным объектом ошибки, содержащим поля code, message и hint.
| Параметр | Успешный ответ (stdout) | Ошибка (stderr) |
|---|---|---|
| Код выхода | 0 | 1 |
| Структура данных | {hits: [{url, title, domain, snippet}], total, saved_to?} |
{error: {code, message, command, hint?}} |
| Примеры кодов ошибок | AUTHENTICATION, UNKNOWN_ARGUMENT, ARGUMENT_ERROR, BAD_REQUEST | |
Экономика контекста и управление токенами
Особое внимание уделено контролю за объемом выводимых данных, что критично для агентов с ограниченным контекстным окном. Флаг --stdout-preview позволяет обрезать длинные строки маркером ...<truncated>, но документация предупреждает: этот флаг работает только в паре с --output-dir или переменной окружения $PPLX_OUTPUT_DIR. Без сохранения в файл обрезка не происходит, и вывод может занимать килобайты.
Результаты сохраняются в файлы {dir}/web/{rand}.json (для поиска) и {dir}/fetch/{rand}.json (для контента). Для извлечения HTML-контента доступен флаг --html, добавляющий поле raw_html, и --no-cache для принудительного живого запроса.
Установка и поддержка платформ
Установка осуществляется одной командой, которая скачивает скрипт, проверяет SHA256-суммы и устанавливает бинарник в ~/.local/bin/pplx без прав sudo. Поддерживаются только три платформы: macOS на Apple Silicon, Linux x86_64 и Linux arm64. Версий для Windows или Intel Mac нет.
Стоимость и лимиты
Использование Search API через pplx тарифицируется по цене $5.00 за 1000 запросов. Лимит скорости (rate limit) составляет 50 запросов в секунду (QPS) для всех уровней использования. Для автоматизации и CI/CD требуется экспорт ключа API через переменную окружения PERPLEXITY_API_KEY, так как команда pplx auth login работает только в интерактивном режиме (TTY).
Источник: MarkTechPost ↗