Perplexity Search Skill

核心功能

Perplexity Search 是一个基于 Perplexity API 的实时网络搜索工具，旨在为用户提供结构化、可筛选的搜索结果。它支持按天、周、月、年进行时间范围过滤，返回包含标题、URL、摘要和更新日期的标准格式数据。

显著优点

• 实时性强：直接对接 Perplexity 搜索 API，获取最新网络信息
• 结构化输出：支持 JSON 或格式化文本两种输出模式，便于程序化处理
• 灵活筛选：内置 recency 参数，可按时间维度快速过滤结果
• 集成友好：提供命令行接口，易于嵌入自动化工作流
• 定价透明：$5/千次请求，成本可控

潜在局限性

• 依赖外部 API：服务可用性完全受 Perplexity 平台制约
• 成本累积：高频使用场景下（如持续监控）费用可能显著增加
• 结果质量波动：Perplexity 的排名算法可能不完全符合特定垂直领域需求
• 无本地缓存：每次请求均产生 API 调用，无法离线复用

适合人群

• 需要追踪实时新闻、政策变动的研究员
• 进行竞品分析、市场趋势扫描的产品经理
• 构建信息聚合、简报生成系统的开发者
• 依赖最新数据辅助决策的商业分析师

常规风险

• API 密钥泄露：若配置不当，密钥可能暴露在日志或共享环境中
• 超时处理：30 秒超时机制在复杂查询或网络波动时可能触发失败
• 内容合规：返回结果包含第三方网页内容，需自行审核信息准确性
• 供应商锁定：深度集成后迁移至其他搜索服务需改写接口层

核心用法

Perplexity Search 是一个轻量级网络搜索工具，通过调用 Perplexity 官方 Search API 获取实时、排序的网页结果。核心调用方式简洁：

python3 scripts/search.py "搜索关键词" [--count N] [--recency day/week/month/year] [--json]

• --count：控制返回结果数量（1-10，默认 5）
• --recency：按时间筛选结果，适合追踪最新动态
• --json：输出原始 JSON 便于程序化处理

配置仅需设置 PERPLEXITY_API_KEY 环境变量，支持 OpenClaw 配置文件或系统环境变量两种方式。

显著优点

1. 零依赖架构：仅使用 Python 标准库（urllib、json、argparse），无供应链攻击风险，部署极其轻量。
2. 安全设计完善：API 密钥强制从环境变量读取，禁止硬编码；输入参数经范围校验与白名单过滤；输出经过 ANSI 转义序列净化，防止终端注入攻击。
3. 实时数据质量：依托 Perplexity 的搜索基础设施，结果包含标题、URL、摘要及时间戳，相关性强于传统搜索引擎的原始网页抓取。
4. 行为可控：30 秒网络超时防止请求挂起，错误信息经过脱敏处理不泄露敏感数据。

潜在缺点与局限性

• 付费门槛：$5/千次请求的定价对高频场景成本较高，需自行监控用量。
• 单点依赖：核心功能完全依赖 Perplexity API 的稳定性与政策持续性，无降级方案。
• 结果数量上限：单次最多返回 10 条结果，不适合大规模数据采集需求。
• T3 来源可信度：由个人开发者维护，虽代码开源透明，但长期维护承诺与应急响应能力弱于企业级项目。

适合人群

• 需要实时市场情报的产品经理与商业分析师
• 追踪热点趋势的内容创作者与研究人员
• 构建自动化信息收集流程的开发者（配合 --json 输出）
• 重视供应链安全、拒绝臃肿依赖的技术团队

常规风险

• API 密钥泄露风险：若在不安全环境中明文配置密钥，可能导致账户被盗用产生费用。
• 网络中断单点故障：无重试机制，网络抖动时可能直接失败。
• 第三方服务政策变更：Perplexity 可能调整定价或接口规范，需关注官方公告及时升级。

---

认证结论：CLS-Certify v2.1.0 全扫描评定 S 级（95 分），符合 GDPR 数据最小化、API 密钥安全管理、输入验证与输出净化等合规要求，90 天认证有效期。