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 保持为空，并向 stderr 写入一个 JSON 错误对象，形式为 {"error":{"code","message","command","hint"?}}。已记录的错误代码包括 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 快速入门。