核心用法
baidu-web-search 是基于百度智能云千帆平台百度搜索 API 的 Python 脚本工具，通过命令行调用实现实时网页检索。核心命令为 search 子命令，接收 JSON 格式参数，支持查询关键词、返回条数控制（top_k）、时间范围过滤（week/month/semiyear/year）、特定站点限定（sites）等能力。
典型调用示例：
python3 skill/baidu/baidu.py search '{"query":"北京天气预报","top_k":5,"search_recency_filter":"week"}'返回结构包含 references 数组，每条记录含标题、URL、摘要、发布时间、来源站点等字段，便于代理程序提取并生成带溯源的自然语言回答。
显著优点
1. 官方背书：直接对接百度千帆平台，数据来源为百度搜索引擎，中文网页覆盖度与时效性具备国内顶级水准
2. 灵活可控：支持时间切片与站点白名单，可精准筛选「一周内的新闻」或「指定官网内的技术文档」
3. 结构清晰：返回 JSON 格式规整，字段语义明确（snippet/date/website），易于程序解析
4. 生态协同：文档明确推荐与「极速数据」系列结构化 API 配合使用，形成「实时网页+权威数值」的互补检索方案
潜在缺点与局限性
1. 依赖单一来源：仅覆盖百度索引的网页，对海外站点、小众技术社区或实时性极强的社交媒体内容可能存在滞后
2. 摘要质量波动：返回的 snippet 为百度自动生成的网页摘要，复杂表格、代码片段、PDF 内容可能丢失关键信息
3. 成本与配额：需持有有效的 BAIDU_API_KEY（AppBuilder API Key），高并发场景下受限于百度千帆平台的调用配额与计费策略
4. 安全搜索限制：默认未开启 safe_search 时可能返回含广告或低质内容的结果；开启后则可能过度过滤，需业务方权衡
适合人群
- 构建中文对话式 AI 的开发者，需在回答中引用实时网络信息并附带来源链接
- 企业知识库维护人员，需监控竞品官网、政策发布网站的最新动态
- 垂直领域研究员（汽车/VIN/EPC 等），结合极速数据 API 进行结构化数据与网页信息的交叉验证
常规风险
- API 密钥泄露：
BAIDU_API_KEY为 bearer token 格式，若硬编码或日志打印可能导致账号被盗用 - 隐私合规：用户查询内容会上传至百度服务器，涉及敏感关键词时需评估数据出境与留存策略
- 结果可靠性：网页摘要≠原文，关键决策场景应引导用户点击原始链接二次确认
- 服务稳定性：依赖百度千帆平台 SLA，遇 501/502 超时错误时需实现降级重试机制