Perplexity 发布 pplx 命令行工具:单二进制文件,为编程 Agent 提供终端搜索 API
Perplexity 推出 pplx,一个官方命令行客户端,以单二进制文件形式提供搜索 API。支持搜索和内容抓取,输出 JSON,专为编程 Agent 和开发者设计。定价 $5/千次请求,支持 macOS 和 Linux。
一句话看懂
Perplexity 发布 pplx,一个单二进制命令行工具,让编程 Agent 直接在终端调用搜索 API,输出结构化 JSON。
详细发生了什么
Perplexity 正式发布了 pplx,一个官方命令行客户端,用于其 Search API。该工具不是聊天客户端,没有对话模式或模型选择,而是专注于两个核心命令:pplx search web(实时网络搜索)和 pplx content fetch(抓取 URL 并返回清洗后的页面文本)。
输出格式严格:成功时退出码为 0,stdout 输出一个 JSON 对象;失败时退出码为 1,stdout 为空,stderr 输出一个 JSON 错误对象,包含 code、message、command 和可选的 hint。错误码包括 AUTHENTICATION、UNKNOWN_ARGUMENT、ARGUMENT_ERROR 和 BAD_REQUEST。
安装只需一条 shell 命令:curl -fsSL https://github.com/perplexityai/perplexity-cli/releases/latest/download/install.sh | sh。脚本会下载 manifest.json,锁定版本,校验 SHA256 后安装到 ~/.local/bin/pplx,无需 sudo。目前仅支持 macOS arm64、Linux x86_64 和 Linux arm64,无 Windows 或 Intel Mac 版本。
针对 Agent 场景,pplx 设计了 token 预算功能:--output-dir 将完整结果保存为 JSON 文件,--stdout-preview 可截断长字符串字段(需配合 --output-dir 或 PPLX_OUTPUT_DIR 环境变量使用)。搜索 API 定价为 $5.00/千次请求,所有套餐上限 50 QPS。
中文圈视角
对于中文开发者,pplx 的实用价值取决于是否方便获取。Perplexity 搜索 API 在国内访问可能受限,需要稳定的网络环境。不过,该工具的设计思路值得借鉴:将搜索能力以 CLI 形式暴露给 Agent,比直接调用 API 更便捷。
国内类似产品如 秘塔AI 搜索、天工AI 搜索等,目前尚未提供官方 CLI 工具。开发者若想实现类似功能,可能需要自行封装 API。pplx 的 JSON 输出格式和错误处理规范,可以作为参考模板。
另外,pplx 的 token 预算功能对中文内容同样适用,但中文文本的 token 计数与英文不同,Perplexity 的计费方式是否对中文友好需实际测试。对于需要大量搜索的 Agent 场景,$5/千次的价格相对较高,国内 API 通常更便宜。
几条值得记住的细节
- pplx 仅支持 macOS arm64、Linux x86_64 和 Linux arm64,无 Windows 或 Intel Mac 版本。
- 安装无需 sudo,二进制文件安装到
~/.local/bin/pplx,并写入 receipt 到~/.config/pplx/。 - 认证方式:
pplx auth login仅支持 TTY,Agent 和 CI 环境需设置PERPLEXITY_API_KEY环境变量。 --stdout-preview必须与--output-dir或PPLX_OUTPUT_DIR配合使用,否则无效。- 搜索 API 定价 $5.00/千次请求,所有套餐 QPS 上限 50。
一句话总结
pplx 让编程 Agent 能像调用本地命令一样使用 Perplexity 搜索,但国内用户需注意网络和成本。