perplexity-search

核心用法

Perplexity Search 技能通过调用 Perplexity AI 的 Search API，为用户提供实时、排序的网络搜索结果。该技能以 Python 脚本形式实现，用户可通过命令行直接调用，支持多种参数配置以满足不同场景需求。基础用法只需提供搜索关键词，脚本即返回包含标题、URL、摘要和日期的结构化结果。高级功能包括结果数量控制（1-10条）、时间过滤（日/周/月/年）以及原始 JSON 输出格式，便于后续数据处理。使用时需配置 PERPLEXITY_API_KEY 环境变量，支持 OpenClaw 配置文件或系统环境变量两种方式。

显著优点

该技能最突出的优势在于其极简的依赖架构——仅使用 Python 标准库（urllib、argparse、json 等），零外部依赖有效规避了供应链攻击风险。安全设计方面，脚本实现了严格的输入验证（count 参数钳制、recency 白名单验证）、输出净化（移除 ANSI 转义序列防止终端注入）以及完善的错误处理（30 秒超时机制），确保执行环境安全。数据层面，Perplexity API 提供实时网络数据，相比传统搜索引擎能获取最新信息，且支持时间过滤功能，特别适合追踪近期趋势和新闻动态。

潜在缺点与局限性

首先，该技能依赖 Perplexity 商业 API，按 $5/1000 次请求计费，高频使用会产生一定成本。其次，来源可信度为 T3 级（个人开发者 GitHub 账号），虽代码经过安全审计，但缺乏知名组织背书。此外，所有搜索查询需发送至 Perplexity 服务器，对隐私敏感场景可能不适用。网络依赖性较强，无法在离线环境使用，且受 Perplexity API 服务稳定性影响。

适合的目标群体

该技能特别适合需要进行市场研究、竞品分析、趋势追踪的专业人士，如产品经理、市场分析师、投资研究员和内容创作者。对于学术研究人员，可用于快速获取最新文献和新闻资料。技术团队也可将其集成到自动化工作流中，用于监控特定领域动态。由于支持结构化 JSON 输出，数据分析师可方便地将搜索结果导入后续处理流程。

使用风险

主要风险包括 API 费用累积（需监控使用量）、网络延迟或 API 服务中断导致的查询失败，以及搜索关键词隐私泄露给第三方（Perplexity）。建议用户在配置 API 密钥时遵循安全最佳实践，避免在共享环境中明文存储密钥。此外，虽然脚本本身无文件操作，但用户需注意搜索结果中的外部链接安全性。

核心用法

Perplexity Search 是一个基于 Python 的 Web 搜索工具，通过调用 Perplexity Search API 获取实时、排序后的网页结果。用户可通过命令行直接执行搜索，支持结果数量控制（1-10条）、时效性筛选（日/周/月/年）及 JSON 原始输出格式。

典型使用场景包括：市场调研（如行业趋势分析）、竞品追踪、新闻速览、学术研究中的最新文献检索等。命令行设计简洁，对技术用户友好，可快速集成至自动化工作流。

显著优点

实时性与权威性：依托 Perplexity 的搜索基础设施，返回结果包含网页标题、URL、摘要及更新日期，信息时效性强，优于传统静态索引。

零依赖轻量设计：仅使用 Python 标准库（urllib、json、argparse 等），无第三方包引入，彻底规避供应链攻击风险，部署极简。

安全防护完善：API 密钥强制从环境变量读取，禁止硬编码；输入参数经严格校验（count 范围限制、recency 白名单过滤）；输出经 ANSI 转义序列净化，防止终端注入攻击；30秒超时机制避免请求挂起。

隐私合规友好：不持久化存储任何数据，搜索请求仅临时发送至 Perplexity 服务器，本地无日志残留，符合数据最小化原则。

潜在缺点与局限性

成本门槛：Perplexity API 按量计费（$5/1000 请求），高频使用需持续投入，无免费额度缓冲，对个人用户或小型团队构成经济约束。

来源可信度约束：维护者为 GitHub 个人账号（T3 级别），非知名组织或基金会背书。虽经代码审计未发现恶意行为，但无法享受 T1/T2 级别的信任放宽，需用户自行承担供应链风险。

功能边界：依赖 Perplexity 服务可用性，若 API 故障或调整定价策略，功能将直接受影响；不支持离线缓存或结果归档，重复查询产生重复成本。

适合人群

• 需快速获取实时资讯的知识工作者、分析师、研究员
• 已有 Perplexity API 预算或低频搜索需求的用户
• 重视代码安全、希望规避复杂依赖的技术使用者
• 不适合：零预算用户、极高频搜索需求场景、对来源背书有硬性要求的合规环境

常规风险

1. API 密钥泄露风险：密钥若配置于系统环境变量，可能被其他进程读取；建议优先使用 OpenClaw 配置的隔离环境。

2. 搜索内容隐私外泄：所有查询明文发送至 Perplexity 服务器，敏感关键词或专有信息可能被服务方记录，不宜用于机密检索。

3. 成本失控风险：无内置用量监控，频繁调用易导致账单超支，建议配合 Perplexity 控制台定期审计。

4. 供应商锁定：深度依赖单一服务商，迁移成本虽低（标准 HTTP 接口），但数据格式与定价策略受控于 Perplexity。