Perplexity lança o pplx: CLI para a Search API direto no terminal, a US$ 5 por 1000 requisições

A Perplexity lançou em 27 de julho de 2026 o pplx, CLI oficial da sua Search API. A ferramenta devolve resultados de busca na web e o texto limpo das páginas como JSON, direto no terminal, ao preço de 5 dólares por 1000 requisições.

O que o pplx faz

O pplx oferece exatamente dois comandos de trabalho e não é um cliente de chat. O comando pplx search web executa uma busca ao vivo na web, e o pplx content fetch baixa a URL indicada e devolve o texto limpo da página. Segundo a documentação, a ferramenta serve tanto a pessoas quanto a agentes de código, mas não tem modo conversacional, escolha de modelo nem resposta sintetizada. No caso do 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 acrescenta o HTML bruto obtido ao vivo por um crawler.

• Dois comandos: pplx search web (busca) e pplx content fetch (extração de página)
• Saída sempre em JSON, sem chat
• Preço da Search API: 5,00 dólares por 1000 requisiçõ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 se organiza em torno de um contrato de saída previsível, que é seu principal atrativo para automação. Sucesso significa código de retorno 0 e exatamente um objeto JSON no stdout; a busca devolve uma estrutura com um array hits, o campo total e o campo opcional saved_to. Qualquer falha termina com código 1 e stdout vazio, e um único objeto JSON de erro vai para o stderr, com os campos code, message, command e o opcional hint.

«Sucesso é código de retorno 0 e exatamente um objeto JSON no stdout», diz o

Agent Skill oficial do pplx-cli.

Os códigos de erro documentados são AUTHENTICATION, UNKNOWN_ARGUMENT, ARGUMENT_ERROR e BAD_REQUEST. A lista não é exaustiva, então o código chamador deve ramificar pelo campo error.code, sem presumir um conjunto fixo. Com esse contrato, o agente distingue sucesso de falha de forma confiável pelo código de saída, sem precisar interpretar o texto da resposta.

Instalação e economia de contexto

A instalação do pplx é um único comando de shell, que baixa um script e o repassa ao sh; o binário vai para o 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 paralela), confere a soma de verificação SHA256 e só então instala o arquivo. Não há suporte a Windows nem à versão Intel do macOS: apenas as três plataformas citadas 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, e a --stdout-preview trunca os campos de texto longos no stdout, acrescentando marcadores truncated. Há uma armadilha importante: a --stdout-preview não funciona sem um diretório de gravação, e o truncamento só é ativado junto com --output-dir ou com a variável PPLX_OUTPUT_DIR. Em CI e em agentes, a autenticação via pplx auth login não está disponível, pois só funciona em TTY; por isso a chave deve ser passada pela variável PERPLEXITY_API_KEY.

O que isso significa

A Perplexity empacota seu mecanismo de busca em uma ferramenta feita para agentes de código. O contrato JSON rigoroso, os códigos de saída previsíveis e o controle do consumo de tokens tornam a Search API um bloco de construção prático para pipelines autônomos, e não apenas para uma pessoa diante do teclado.

Perguntas frequentes

Quanto custa o pplx?

A CLI em si é gratuita, mas as chamadas à Search API são cobradas: 5,00 dólares por 1000 requisições, com limite de 50 QPS em todos os planos.

O pplx funciona no Windows?

Não. Há suporte apenas a macOS em Apple Silicon, Linux x86_64 e Linux arm64. O release não traz builds para Windows nem para a versão Intel do macOS.

Ele substitui o chatbot da Perplexity?

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