Perplexity выпустила pplx: CLI для Search API прямо в терминале за $5 за 1000 запросов

A Perplexity lançou em 27 de julho de 2026 o pplx — o cliente CLI oficial para seu Search API, que retorna resultados de busca na web e texto limpo de páginas como JSON diretamente no terminal, ao preço de US$ 5 por 1.000 solicitações.

O que o pplx faz

O pplx oferece exatamente dois comandos funcionais e não é um cliente de chat. O comando `pplx search web` executa uma busca na web ao vivo, enquanto `pplx content fetch` busca a URL indicada e retorna o texto limpo da página. Segundo a documentação, a ferramenta foi pensada tanto para pessoas quanto para agentes de codificação (coding agents) — mas não possui modo conversacional, seleção de modelo nem resposta sintetizada. Para o `content fetch`, a documentação recomenda verificar os campos `error` e `is_paywall` na saída antes de usar o texto, e a flag `--html` adiciona HTML bruto ao vivo via um crawler.

• Dois comandos: `pplx search web` (busca) e `pplx content fetch` (extração de página)
• A saída é sempre em formato JSON, sem chat
• Preço do Search API — US$ 5,00 por 1.000 solicitações
• Limite — 50 QPS em todos os planos
• Plataformas: macOS em Apple Silicon, Linux x86_64 e Linux arm64

Como funciona o contrato de saída

O pplx constrói seu comportamento em torno de um contrato de saída previsível — seu principal diferencial para automação. Sucesso significa código de retorno 0 e exatamente um objeto JSON em stdout; a busca retorna uma estrutura com um array `hits`, um campo `total` e um `saved_to` opcional. Qualquer falha termina com código 1 e stdout vazio, enquanto um único objeto JSON de erro vai para o stderr com os campos `code`, `message`, `command` e um `hint` opcional.

"Sucesso é código de retorno 0 e exatamente um objeto JSON em stdout", afirma o

Agent Skill oficial pplx-cli.

Os códigos de erro documentados são AUTHENTICATION, UNKNOWN_ARGUMENT, ARGUMENT_ERROR e BAD_REQUEST. A lista não é exaustiva, portanto o código que faz a chamada deve ramificar pelo campo `error.code`, em vez de depender de um conjunto fixo. Esse contrato permite que um agente diferencie com segurança sucesso de falha pelo código de saída, sem precisar analisar o texto da resposta.

Instalação e economia de contexto

Instalar o pplx é um único comando de shell que baixa um script e o encaminha para o `sh`; o binário é instalado no diretório `~/.local/bin/pplx` sem sudo. O script busca o `manifest.json` do último release, fixa a versão em todos os downloads (para não cair em uma publicação concorrente), verifica o checksum SHA256 e só então instala o arquivo. Não há suporte para Windows nem para a versão Intel do macOS — apenas três plataformas estão disponíveis.

A Perplexity deu atenção especial à economia da janela de contexto, algo crítico para agentes. A flag `--output-dir` grava o resultado completo em um arquivo JSON, enquanto `--stdout-preview` trunca campos de string longos no stdout, adicionando marcadores `truncated`. Uma armadilha importante: `--stdout-preview` não funciona sem um diretório de salvamento — o truncamento só é ativado junto com `--output-dir` ou a variável `PPLX_OUTPUT_DIR`. Para CI e agentes, a autorização via `pplx auth login` não está disponível, pois só funciona em um TTY, então a chave é passada pela variável `PERPLEXITY_API_KEY`.

O que isso significa

A Perplexity está empacotando seu mecanismo de busca em uma ferramenta voltada para agentes de codificação: um contrato JSON rígido, códigos de saída previsíveis e controle do consumo de tokens fazem do Search API um bloco de construção conveniente para pipelines autônomos, não apenas para uma pessoa no teclado.

Perguntas frequentes

Quanto custa o pplx?

A própria CLI é gratuita, mas as chamadas ao Search API são cobradas: US$ 5,00 por 1.000 solicitações, com limite de 50 QPS em todos os planos.

O pplx funciona no Windows?

Não. Apenas macOS em Apple Silicon, Linux x86_64 e Linux arm64 são suportados. Não há builds para Windows nem para a versão Intel do macOS neste lançamento.

Isso substitui o chatbot da Perplexity?

Não. O pplx não é um cliente de chat: não possui modo conversacional, seleção de modelo nem resposta sintetizada — apenas busca na web e extração de texto de páginas em JSON.