核心用法
baidu-search 是一个封装百度千帆AI搜索API的OpenClaw Skill，通过Python脚本发起HTTPS请求获取网页搜索结果。使用时需配置环境变量 BAIDU_API_KEY，调用格式为 JSON 参数传递搜索词、结果数量（1-50）及时间过滤条件。支持两种时间格式：固定日期区间（YYYY-MM-DDtoYYYY-MM-DD）或相对时段（pd近24小时/pw近7天/pm近31天/py近365天）。
显著优点
- 官方API背书：直接调用百度云服务（qianfan.baidubce.com），非爬虫实现，稳定性与合规性优于非官方方案
- 安全编码规范：无eval/exec/system等危险函数，输入验证完善（count范围限制、日期正则校验），无硬编码密钥
- 隐私合规良好：API密钥通过环境变量读取，不收集用户敏感信息，通过GDPR/CCPA合规检查
- 时间过滤灵活：双格式时间参数满足从实时新闻到历史归档的多种场景需求
潜在缺点与局限性
- 中文生态依赖：百度搜索引擎在中文内容覆盖上优势明显，但英文及国际内容质量可能不及Google/Bing
- API成本门槛：需自行申请百度千帆API Key，存在调用配额与计费成本
- 网络环境要求：依赖中国大陆网络环境，海外部署可能存在延迟或连通性问题
- 功能边界固定：仅提供基础网页搜索，不支持图片/视频/学术等垂直搜索细分
适合人群
主要面向需要中文实时信息检索的开发者与AI Agent构建者，包括：需要接入最新新闻/文档的企业知识库系统、处理中文语境的客服机器人、研究中国市场信息的分析师工具等。不适合需要全球多语言搜索、完全离线环境或零API预算的场景。
常规风险
- API密钥泄露风险：若环境变量配置不当或日志打印未脱敏，可能导致密钥泄露
- 结果质量波动：搜索引擎返回内容受百度算法调整影响，相关性与时效性不恒定
- 服务商依赖：单点依赖百度云服务，存在政策合规、服务定价变更等外部风险
- 超时与容错：当前实现未配置请求超时，极端网络情况下可能阻塞调用线程