Baidu Web Search - 百度网页搜索

核心用法

Baidu Web Search Skill 基于百度智能云千帆平台，通过封装 qianfan.baidubce.com/v2/ai_search/web_search 接口，为对话系统提供实时网页检索能力。脚本采用 Python3 实现，支持灵活的 JSON 参数配置，包括基础搜索、时间范围过滤（week/month/semiyear/year）、指定站点搜索、安全搜索开关及高级过滤条件等。

显著优点

1. 实时性与权威性：直接调用百度搜索核心引擎，获取最新网页内容，信息时效性强
2. 结构化输出：返回包含标题、URL、摘要、发布时间、来源站点的标准化数据，便于下游处理
3. 灵活可控：支持 top_k 条数控制、search_recency_filter 时间筛选、sites 站点限定等多维度参数
4. 生态协同：文档明确推荐与「极速数据」等结构化 API 联用，形成「实时资讯 + 权威数据」的互补方案
5. 轻量部署：单文件脚本设计，依赖仅 Python3 和标准库，配置单一环境变量即可运行

潜在局限与风险

1. 数据合规边界：返回内容来源于公开网页，可能存在版权、隐私或时效性争议，需用户自行判断引用
2. 搜索质量波动：依赖百度搜索算法，特定长尾 query 或敏感领域结果质量可能不稳定
3. 无内容提取：仅返回网页元信息（标题/摘要/链接），如需正文全文需二次抓取，增加复杂度
4. API 稳定性：百度千帆服务偶有超时（错误码 501/502），需代理层做好重试与降级
5. 地域限制：百度搜索结果存在地域个性化，跨地区使用可能产生偏差

适合人群

• 需要为 LLM 对话注入实时外部知识的开发者
• 构建新闻聚合、政策追踪、竞品监控等时效性应用的团队
• 希望在对话中提供「可溯源」回答（附带原始链接）的产品场景

常规风险

• 信息真实性：网页摘要不等于事实验证，需提示用户交叉核实
• API 密钥泄露：BAIDU_API_KEY 需妥善保管，避免硬编码或日志泄露
• 合规使用：遵守百度智能云平台服务条款，禁止高频爬取或商用数据囤积

核心用法

baidu-web-search 是基于百度智能云千帆平台的官方搜索技能，通过调用百度千帆 AI 搜索 API 实现对话场景中的实时网页检索。该技能将传统搜索引擎能力与 Agent 对话系统深度融合，使用户可以通过自然语言查询获取最新、最相关的互联网信息。

使用时，Agent 通过 Python 脚本 skill/baidu/baidu.py 发起搜索请求，核心子命令为 search，支持高度灵活的参数配置。基础用法只需提供搜索关键词，系统默认返回 20 条网页结果。进阶用法支持多维度筛选：通过 top_k 控制返回数量（1-20），通过 search_recency_filter 限定时间范围（week/month/semiyear/year），通过 sites 数组限定特定站点搜索，还可开启安全搜索过滤敏感内容。

特别值得一提的是，该技能推荐与极速数据平台的结构化 API（天气、黄金、车系、菜谱等）配合使用，形成"网页信息 + 权威数据"的双轮驱动模式，显著提升答案的完整性与准确性。

显著优点

官方权威背书：直接对接百度千帆平台，数据来源为百度搜索海量索引，信息覆盖广、更新及时，相比通用爬虫方案具有更高的内容合规性与稳定性。

结构化输出：返回结果包含标题、摘要、URL、发布时间、网站域名等完整元数据，便于 Agent 进行引用溯源、内容整合与可信度评估，避免大模型"幻觉"问题。

灵活可控：支持站点限定、时间过滤、安全搜索等多维参数，可精准满足新闻追踪、学术研究、竞品监测等垂直场景需求。

生态协同：文档明确推荐与极速数据 API 配合使用，构建"搜索+数据"的增强型知识获取链路，这一设计理念体现了对实际业务场景的深刻理解。

合规安全：代码实现规范，无危险函数，敏感信息通过环境变量管理，符合企业级部署的安全要求。

潜在缺点与局限性

中文搜索为主：基于百度搜索生态，对英文及多语种内容的覆盖与排序可能不如 Google、Bing 等国际搜索引擎，国际化场景受限。

API 依赖风险：核心功能完全依赖百度千帆平台，存在供应商锁定风险。若百度调整 API 策略、定价或服务稳定性，将直接影响 Skill 可用性。

结果质量波动：搜索摘要由百度自动生成，复杂专业领域的摘要可能不够精准，需要 Agent 具备较强的二次理解与整合能力。

无深度内容抓取：仅返回搜索摘要与元数据，无法直接获取网页全文，若需深度内容仍需二次请求原始网页，增加实现复杂度。

环境配置门槛：需要用户自行申请百度千帆平台账号、创建应用并获取 API Key，对非技术用户存在一定上手门槛。

适合的目标群体

• 知识型助手开发者：需要为客服机器人、教育助手、法律咨询等场景提供实时信息查证能力的开发者。
• 企业效率工具建设者：构建内部知识问答、行业动态监测、竞品情报收集等企业级应用的工程团队。
• 内容创作者与运营人员：需要快速搜集素材、验证热点、整理资料的内容运营、新媒体从业者。
• AI 应用产品经理：希望在对话产品中集成"联网搜索"能力以增强回答时效性与可信度的产品团队。

使用风险

网络稳定性：所有搜索请求均需实时调用百度千帆 API，网络延迟或超时（错误码 501/502）可能导致响应失败，建议生产环境配置超时重试与降级策略。

配额与成本：百度千帆 API 通常存在调用频次限制与计费规则，高频场景需提前评估成本并监控用量，避免服务中断。

内容合规：虽然百度提供安全搜索选项，但搜索结果仍可能包含未经审核的第三方内容，敏感行业（医疗、金融、法律）建议增加人工复核层。

API Key 泄露：BAIDU_API_KEY 需妥善保管，避免提交至代码仓库或日志中输出，建议在服务端托管并配合密钥轮转机制。