Perplexity lanzó pplx, un cliente oficial de línea de comandos para su Search API que lleva resultados de búsqueda web fundamentados y texto extraído de páginas a la terminal en formato JSON. Según la documentación del proyecto, la herramienta está diseñada tanto para usuarios humanos como para agentes de programación.

El cliente no es una interfaz de chat. No ofrece modo conversacional, selección de modelo ni respuestas sintetizadas. En cambio, expone la funcionalidad de la Search API mediante un flujo de trabajo de línea de comandos restringido y con un formato de salida predecible. Esa diferencia es importante para la automatización: los scripts y agentes pueden consumir resultados de búsqueda y extracción como datos estructurados sin depender de una sesión de navegador ni de analizar una respuesta de chat en lenguaje natural.

Dos comandos y un contrato JSON estricto

pplx ofrece exactamente dos superficies de comando operativas. pplx search web ejecuta una búsqueda web en vivo, mientras que pplx content fetch recupera una URL y devuelve texto de página limpiado.

El Agent Skill oficial de pplx-cli define el contrato de salida para esos comandos. Una solicitud exitosa termina con código 0 y escribe exactamente un objeto JSON en stdout. Para búsqueda, la respuesta tiene la forma {hits: [{url, title, domain, snippet, ...}], total, saved_to?}.

Los fallos se gestionan por separado. Cualquier fallo termina con código 1, deja stdout vacío y escribe un objeto de error JSON en stderr con la forma {"error":{"code","message","command","hint"?}}. Los códigos de error documentados incluyen AUTHENTICATION, UNKNOWN_ARGUMENT, ARGUMENT_ERROR y BAD_REQUEST. El Agent Skill señala que la lista no es exhaustiva, por lo que quienes llamen a la herramienta deben ramificar según error.code en lugar de asumir que solo aparecerán esos códigos. La separación entre stdout y stderr también sigue un patrón común de Unix, lo que facilita que los procesos llamadores distingan datos exitosos de errores operativos.

Instalación y plataformas compatibles

La instalación se realiza mediante un único comando de shell que envía un script de instalación a sh. El script install.sh descarga manifest.json desde la versión más reciente y extrae la etiqueta y la versión. Luego fija todas las descargas restantes a esa etiqueta, explícitamente para evitar una carrera con una publicación concurrente.

El script descarga SHA256SUMS y el binario correspondiente a la plataforma, verifica el checksum e instala el binario en ~/.local/bin/pplx. No requiere sudo. Se escribe un recibo en ~/.config/pplx/pplx-receipt.json, pero solo después de que el binario instalado se ejecute correctamente.

El soporte de plataformas se limita a tres objetivos: macOS en Apple Silicon, Linux x86_64 y Linux arm64. Las plataformas no compatibles terminan con un error. No hay compilación para Windows ni para macOS Intel.

Presupuesto de tokens para flujos de trabajo con agentes

Una de las funciones más orientadas a agentes es el presupuesto de tokens. La opción --output-dir escribe el conjunto completo de resultados en un archivo JSON, mientras que --stdout-preview[=<CHARS>] trunca campos de cadena largos en stdout y agrega marcadores ...<truncated>.

El Agent Skill destaca una limitación importante: --stdout-preview no hace nada a menos que también se configure un directorio de guardado. Solo trunca stdout cuando el resultado completo se guarda mediante --output-dir o $PPLX_OUTPUT_DIR. Si se usa sola, devuelve una salida de tamaño completo, y cada resultado individual puede ocupar varios kilobytes.

Los resultados de búsqueda guardados se escriben en {dir}/web/{rand}.json, y los resultados de extracción se escriben en {dir}/fetch/{rand}.json. Los archivos se escriben únicamente después de una solicitud exitosa. La variable de entorno PPLX_OUTPUT_DIR puede establecer un valor predeterminado de espacio de trabajo para que no sea necesario repetir la bandera de directorio. Este diseño permite que los flujos de trabajo automatizados conserven artefactos completos en disco mientras pasan una vista previa más pequeña por la ventana de contexto o el flujo de logs.

Para la extracción de contenido, la documentación agrega una verificación de corrección en lugar de un control de costos: los usuarios deben verificar error e is_paywall en la salida antes de confiar en el contenido recuperado. La opción --html agrega un campo raw_html obtenido en vivo mediante el crawler, y --no-cache fuerza una extracción en vivo.

La autenticación también es relevante para el uso automatizado. pplx auth login solo funciona con TTY, por lo que los agentes y entornos de CI deben exportar PERPLEXITY_API_KEY. La facturación de la Search API figura en $5.00 por cada 1,000 solicitudes, con un límite de 50 QPS en todos los niveles de uso.

Las fuentes citadas por el informe original incluyen perplexityai/perplexity-cli, pplx-cli SKILL.md, api-platform-developers, precios de Perplexity API, límites de tasa y niveles de uso y la guía de inicio rápido de Search API.