功能概述
百度网页搜索（Baidu Web Search） 是基于百度智能云千帆平台的网页检索技能，通过调用官方百度搜索 API，实现对话场景中的实时网页信息查询。该技能返回结构化的搜索结果，包括网页标题、URL、摘要、发布时间、站点信息等元数据，便于用户快速获取并人工甄别信息来源。
核心用法
技能采用命令行调用方式，支持灵活的参数配置：
- 基础搜索：输入查询词即可获取默认20条网页结果
- 精准控制：支持设置返回条数（
top_k）、时间范围（search_recency_filter: week/month/semiyear/year） - 站点限定：可将搜索范围限定在特定域名内（如
www.jisuapi.com） - 安全过滤：可选开启安全搜索模式
典型调用示例：
python3 skills/baidu/baidu.py search '{"query":"北京天气","top_k":5,"search_recency_filter":"week"}'显著优点
1. 实时性与覆盖面：依托百度搜索引擎，可获取最新公开的网页信息，适合追踪新闻动态、政策更新等时效性内容
2. 结构化输出：返回JSON格式的标准化数据，包含完整的来源信息（标题、URL、摘要、时间、站点），便于后续处理和溯源
3. 灵活的站点过滤：支持针对特定可信站点进行限定搜索，提升结果相关性
4. 与极速数据互补：文档明确建议与极速数据（JisuAPI）的结构化接口配合使用——百度搜索提供最新网页信息，极速数据提供权威结构化数值（天气、VIN、汇率等），形成完整的信息验证链条
潜在缺点与局限性
1. 非直接生成答案：与 baiduai（智能搜索生成）不同，本技能仅返回网页列表，需调用方自行整合摘要生成自然语言回答，增加了使用方的处理复杂度
2. 依赖外部API稳定性：受百度千帆平台服务可用性影响，存在调用超时或限流风险（错误码501/502）
3. 搜索结果质量不可控：返回内容取决于百度搜索引擎的排序算法，可能包含商业推广内容或时效性不足的页面，需人工二次甄别
4. 无内置去重或摘要优化：原始摘要可能存在截断、格式混乱等问题，需额外清洗处理
适合人群
- 信息调研员：需要快速获取某一主题的最新网页来源，进行多源交叉验证
- 内容运营人员：追踪热点话题、政策动向，收集参考素材
- 开发者/Agent构建者：需要在中台对话系统中集成实时搜索能力，与其他结构化数据源（如极速数据）组合使用
- 企业知识管理：针对特定站点（如行业官网、内部文档库）进行定向检索
常规风险
| 风险类型 | 说明 |
|---------|------|
| 信息安全 | 搜索内容可能经过网络传输，敏感查询存在泄露风险；建议避免搜索含个人隐私、商业机密的关键词 |
| 内容可信度 | 搜索结果来源于公开互联网，内容真实性、权威性需人工判断，不应直接作为决策依据 |
| API密钥管理 | 需妥善保管 `BAIDU_API_KEY`，避免硬编码或泄露到版本控制系统 |
| 合规风险 | 需遵守百度API使用条款及目标网站的robots协议，禁止用于大规模爬虫或违规数据采集 |
| 依赖风险 | 百度服务策略变更可能导致API调整或下线，需关注官方文档更新 |