核心用法
baidu-web-search 是一个基于百度智能云千帆平台的实时网页搜索 Skill，通过调用官方 https://qianfan.baidubce.com/v2/ai_search/web_search API 实现。使用时需配置 BAIDU_API_KEY 环境变量，通过 python3 skills/baidu/baidu.py search 命令执行搜索，支持丰富的参数配置：
- 基础搜索：
{"query":"搜索关键词"}即可获取默认 20 条网页结果 - 结果控制：
top_k调整返回条数（1-20），search_recency_filter按时间筛选（week/month/semiyear/year） - 站点限定：
sites数组指定只在特定域名内搜索 - 安全搜索：
safe_search布尔值控制内容过滤
返回结果包含标题、URL、摘要、发布时间、站点信息等结构化数据，便于后续处理和展示。
显著优点
1. 实时性强：直接对接百度搜索，获取最新网页信息，适合新闻、政策、动态类查询
2. 参数灵活：支持时间范围、站点限定、返回数量等多维度筛选
3. 结果结构化：返回 JSON 格式的标准化数据，易于解析和二次加工
4. 生态协同：官方推荐与「极速数据」API 搭配使用，实现「网页信息+结构化数据」的互补
5. 鉴权规范：采用标准的 Bearer Token 鉴权模式，符合企业级 API 安全实践
潜在局限
- 依赖外部服务：需百度千帆平台账号和有效 API Key，存在服务可用性依赖
- 结果质量波动：搜索结果受百度算法和 SEO 影响，权威性和时效性需人工甄别
- 返回上限固定：单次最多 20 条，大规模数据获取需分页或多次调用
- 中文内容为主：百度搜索对中文覆盖最佳，英文及其他语言检索效果可能下降
- 合规限制：需遵守百度平台使用条款，商业场景需注意数据使用授权
适合人群
- 需要实时网络信息辅助的 AI 对话开发者
- 构建新闻聚合、舆情监测、行业调研类应用的工程师
- 已在使用百度千帆生态，希望扩展搜索能力的团队
- 需要将网页信息与其他结构化数据源（天气、股票、VIN 等）整合的场景
常规风险
- API 密钥泄露：
BAIDU_API_KEY需妥善保管，避免硬编码或日志泄露 - 成本累积：高频调用可能产生费用，需监控用量并设置预算告警
- 内容合规：搜索结果可能包含未审核信息，面向终端用户时需增加内容过滤
- 服务稳定性：百度平台故障或限流时可能影响功能，建议设计降级策略
- 数据隐私：用户搜索 query 会上传至百度服务器，敏感场景需评估隐私协议合规性