Perplexity 已發布 pplx，這是其 Search API 的官方命令列用戶端，可將有依據的網路搜尋結果與擷取的網頁文字以 JSON 形式帶入終端機。根據專案文件，該工具同時為人類使用者與程式碼代理設計。

這個用戶端不是聊天介面。它不提供對話模式、模型選擇或綜合生成的答案。相反地，它透過受限的命令列工作流程，以可預測的輸出格式公開 Search API 功能。這項區別對自動化很重要：指令碼與代理可以將搜尋和擷取結果作為結構化資料使用，而不必依賴瀏覽器工作階段，或解析自然語言聊天回覆。

兩個命令與嚴格的 JSON 契約

pplx 正好提供兩個可用的命令介面。pplx search web 會執行即時網路搜尋，而 pplx content fetch 會擷取 URL 並回傳清理後的網頁文字。

官方 pplx-cli Agent Skill 定義了這些命令的輸出契約。成功的請求會以代碼 0 結束，並向 stdout 寫入正好一個 JSON 物件。對於搜尋，回應格式為 {hits: [{url, title, domain, snippet, ...}], total, saved_to?}。

失敗則另行處理。任何失敗都會以代碼 1 結束，讓 stdout 保持空白，並以 {"error":{"code","message","command","hint"?}} 的形式向 stderr 寫入一個 JSON 錯誤物件。已記錄的錯誤代碼包括 AUTHENTICATION、UNKNOWN_ARGUMENT、ARGUMENT_ERROR 與 BAD_REQUEST。Agent Skill 指出，這份清單並不完整，因此呼叫端應依據 error.code 分支處理，而不是假設只會出現這些代碼。stdout 與 stderr 的分流也符合常見 Unix 模式，讓呼叫流程更容易區分成功資料與操作錯誤。

安裝與支援平台

安裝透過單一 shell 命令提供，該命令會將安裝指令碼管線傳入 sh。install.sh 指令碼會從最新版本下載 manifest.json，並擷取標籤與版本。接著它會將其餘所有下載固定到該標籤，明確避免與同時進行的發布產生競態。

該指令碼會下載 SHA256SUMS 與相應的平台二進位檔，驗證校驗和，並將二進位檔安裝到 ~/.local/bin/pplx。它不需要 sudo。收據會寫入 ~/.config/pplx/pplx-receipt.json，但只有在已安裝的二進位檔成功執行後才會寫入。

平台支援僅限三個目標：Apple Silicon 上的 macOS、Linux x86_64 與 Linux arm64。不支援的平台會以錯誤結束。目前沒有 Windows 版本，也沒有 Intel macOS 版本。

面向代理工作流程的 token 預算管理

最面向代理的功能之一是 token 預算管理。--output-dir 選項會將完整結果集寫入 JSON 檔案，而 --stdout-preview[=<CHARS>] 會截斷 stdout 中較長的字串欄位，並加入 ...<truncated> 標記。

Agent Skill 強調一項重要限制：除非同時設定儲存目錄，否則 --stdout-preview 不會產生效果。只有在完整結果透過 --output-dir 或 $PPLX_OUTPUT_DIR 儲存時，它才會截斷 stdout。若單獨使用，它會回傳完整大小的輸出，而個別命中結果可能各自達數 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。Search API 計費列為每 1,000 次請求 $5.00，且每個使用層級皆有 50 QPS 上限。

原始報導引用的來源包括 perplexityai/perplexity-cli、pplx-cli SKILL.md、api-platform-developers、Perplexity API 定價、速率限制與使用層級，以及 Search API 快速入門。