Perplexityは、検索APIの公式コマンドラインクライアント「pplx」をリリースしました。このツールは、人間とコーディングエージェントの両方を対象として設計されており、根拠に基づいた検索結果と抽出されたページテキストをJSON形式で返します。pplxはチャットクライアントではなく、会話モード、モデル選択、合成回答はサポートされていません。
pplxは2つの主要なインターフェースを提供します。pplx search webはライブウェブ検索を実行し、pplx content fetchはURLを取得してクリーンなページテキストを返します。その出力契約は明確で、成功時は終了コード0でstdoutに1つのJSONオブジェクトを出力します。検索結果にはhits配列（url、title、domain、snippetなどを含む）とtotal、saved_toが含まれます。失敗時は終了コード1でstdoutは空になり、stderrに{"error":{"code","message","command","hint"?}}形式のJSONエラーオブジェクトが出力されます。文書化されているエラーコードにはAUTHENTICATION、UNKNOWN_ARGUMENT、ARGUMENT_ERROR、BAD_REQUESTなどがありますが、網羅的ではないため、呼び出し側はerror.codeで分岐する必要があります。
インストールは1行のシェルコマンドで完了します。curl -fsSL https://github.com/perplexityai/perplexity-cli/releases/latest/download/install.sh | sh このスクリプトは、最新リリースからmanifest.jsonをダウンロードし、タグとバージョンを抽出します。その後、すべてのダウンロードをそのタグに固定し、同時公開の競合を回避します。SHA256SUMSとプラットフォームバイナリを取得し、チェックサムを検証した後、~/.local/bin/pplxにインストールします。sudoは不要です。インストールが成功すると、~/.config/pplx/pplx-receipt.jsonにレシートが書き込まれますが、これはインストールされたバイナリが正常に実行された後にのみ行われます。
対応プラットフォームはmacOS Apple Silicon、Linux x86_64、Linux arm64の3つに限定されています。その他のプラットフォームではエラーで終了します。Windows版やIntel Mac版はありません。
トークン予算はエージェント向けの重要な機能です。--output-dirは結果セット全体をJSONファイルに書き込みます。--stdout-preview[=]はstdoutの長い文字列フィールドを切り詰め、...マーカーを追加します。ただし、公式Skillは注意点を指摘しています。--stdout-previewは保存ディレクトリがない場合には機能しません。--output-dirまたは$PPLX_OUTPUT_DIRで結果を保存する場合にのみ切り詰めが行われます。単独で使用すると完全なサイズの出力が返され、各ヒットは数KBになる可能性があります。
保存された検索結果は{dir}/web/{rand}.jsonに、フェッチ結果は{dir}/fetch/{rand}.jsonに保存されます。ファイルはリクエストが成功した後にのみ書き込まれます。PPLX_OUTPUT_DIR環境変数でワークスペースのデフォルトを設定できるため、フラグを繰り返し指定する必要はありません。
コンテンツフェッチでは、コストではなく正確性のチェックが追加されています。出力を信頼する前に、errorとis_paywallを検証してください。--htmlを指定すると、クローラーを介してraw_htmlフィールドが追加され、--no-cacheはライブフェッチを強制します。
また、pplx auth loginはTTY専用であるため、エージェントやCI環境ではPERPLEXITY_API_KEY環境変数をエクスポートする必要があります。APIの料金は1,000リクエストあたり5ドルで、すべての使用ティアで50 QPSの上限があります。