Baidu Web Search - 百度网页搜索

核心用法

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 会上传至百度服务器，敏感场景需评估隐私协议合规性

核心用法

baidu-web-search 是一款基于百度智能云千帆平台的实时网页搜索技能，通过调用官方 https://qianfan.baidubce.com/v2/ai_search/web_search API 实现网页信息检索。用户可通过简单命令发起搜索请求，支持多种高级参数配置以满足不同场景需求。

基础调用方式为 python3 skills/baidu/baidu.py search 配合 JSON 参数，核心参数包括：

• query（必填）：搜索关键词
• top_k：返回结果数量，默认 20 条
• search_recency_filter：时间筛选，支持 week/month/semiyear/year
• sites：限定特定站点搜索，如 ["www.jisuapi.com"]
• edition：搜索版本，standard 或 lite

返回结果为结构化 JSON，包含 references 数组，每条记录提供标题、URL、摘要、发布时间、站点域名等完整信息，便于后续解析与展示。

显著优点

官方 API 背书：直接对接百度智能云千帆平台，数据来源权威可靠，无需担心爬虫合规风险。相较于传统网页爬虫方案，本技能完全基于百度官方搜索能力，搜索结果质量与稳定性有保障。

参数灵活可控：支持站点限定、时间过滤、安全搜索等多维度筛选，特别适合需要精准溯源的场景，如政策文件检索、行业资讯追踪、特定平台内容挖掘等。

即开即用设计：仅需配置 BAIDU_API_KEY 环境变量即可运行，无复杂依赖安装。脚本封装简洁，命令行调用友好，易于集成到各类 Agent 框架和工作流中。

结构化输出：返回结果为标准 JSON 格式，包含清晰的字段定义（title/url/snippet/date/website），便于程序化处理和自然语言生成，无需额外解析 HTML。

潜在缺点与局限性

需要付费 API Key：本技能依赖百度智能云千帆平台的 AppBuilder API Key，非完全免费服务，高频率调用需关注配额与成本。

中文内容导向：基于百度搜索生态，对中文网页覆盖较全，但英文及海外小众站点内容可能不如 Google/Bing 等国际搜索引擎全面。

返回格式固定：当前版本仅支持网页（web）类型搜索，不支持图片、视频等多媒体资源直接检索，需配合其他 Skill 实现富媒体搜索需求。

依赖外部服务稳定性：所有请求均转发至百度官方服务器，若百度 API 出现限流、变更或故障，将直接影响本技能可用性。建议在实际应用中实现降级策略。

适合的目标群体

• AI Agent 开发者：需要为对话机器人集成实时信息检索能力，弥补大模型知识时效性不足
• 内容运营与研究人员：追踪行业动态、政策变化、竞品资讯，需要可溯源的网页信息汇总
• 企业知识库建设者：结合站点限定功能，构建基于特定域名（如内部文档站、合作伙伴站点）的智能问答系统
• 数据分析师：需要批量获取网页标题、摘要等元数据，用于趋势分析或信息聚合

使用风险说明

API 配额与成本控制：百度千帆平台对 API 调用有速率限制和配额管理，高并发场景需提前评估用量并设置监控告警。

网络延迟波动：搜索请求需经互联网传输至百度服务器，平均响应时间受网络状况影响，不适合对延迟极度敏感的实时交互场景。

结果质量依赖百度算法：搜索排名由百度引擎决定，可能存在 SEO 干扰、时效性偏差等问题，重要决策建议结合多源交叉验证。

认证信息安全管理：BAIDU_API_KEY 需妥善保管，避免在代码仓库、日志中明文泄露。建议采用密钥管理服务或环境变量注入方案。

Schema 变更风险：百度 API 接口可能随版本迭代调整响应结构，建议在生产环境增加字段存在性校验，及时跟进官方文档更新。