核心用法
baidu-web-search 是基于百度智能云千帆平台的实时网页搜索 Skill，通过调用 https://qianfan.baidubce.com/v2/ai_search/web_search 接口，在对话中检索互联网信息并返回标题、URL、摘要、发布时间等结构化数据。使用时需配置 BAIDU_API_KEY 环境变量，支持标准版与轻量版两种搜索模式。
脚本提供灵活的搜索控制能力：
- 基础搜索：
python3 skills/baidu/baidu.py search '{"query":"关键词"}'，默认返回 20 条结果 - 时间过滤：支持
week/month/semiyear/year四级时间筛选，适合追踪最新资讯 - 站点限定：通过
sites数组指定域名白名单，实现精准站内搜索 - 安全搜索：可选开启
safe_search过滤不良内容
返回结果为标准 JSON 格式，包含 references 数组（每条含 id、title、url、snippet、date、website 等字段）及 request_id，便于代理程序解析与引用溯源。
显著优点
1. 实时性强：直接对接百度搜索引擎索引，获取最新网页内容，时效性优于预训练知识库
2. 结果结构化：返回字段规范统一（标题/链接/摘要/时间/域名），便于程序化处理与自然语言总结
3. 搜索控制精细：时间范围、站点白名单、返回条数、安全过滤等参数可灵活组合
4. 生态协同：文档明确推荐与极速数据（JisuAPI）搭配使用——百度搜索提供「最新网页信息」，极速数据提供「权威结构化数值」（天气、VIN、汇率等），形成互补
5. 中文优化：基于百度搜索，对中文网页内容理解与排序更具优势
潜在缺点与局限性
1. 依赖外部 API：需申请百度千帆平台账号并获取 AppBuilder API Key，存在服务可用性依赖
2. 成本与配额：百度千帆平台对搜索 API 有调用次数限制，高频场景需关注计费策略
3. 结果质量波动：搜索引擎返回内容受 SEO、广告、内容农场影响，摘要准确性需人工或程序二次校验
4. 无深度内容提取：仅返回网页摘要（snippet），如需全文内容需代理额外抓取，可能触发反爬机制
5. 地域与隐私：百度搜索结果存在地域个性化差异，且搜索行为会上传至百度服务端
适合人群
- 信息检索场景：需要回答「最新消息」「最近新闻」「有哪些网站」等时效性问题的对话代理
- 研究辅助：需要快速获取某主题网页列表供人工甄别筛选的研究人员
- 内容策展：需要批量收集特定站点（如 jisuapi.com、jisuepc.com）相关网页的内容运营者
- 企业知识增强：希望在私有知识库基础上补充实时公开信息的 RAG 系统开发者
常规风险
- API 密钥泄露：
BAIDU_API_KEY需妥善保管，避免硬编码或泄露至版本控制 - 隐私合规：用户搜索 query 会上传至百度服务端，涉及敏感信息时需评估合规性
- 内容安全：虽支持
safe_search，但搜索引擎返回内容仍可能包含不实信息、偏见观点或侵权内容，建议在关键场景增加人工审核或交叉验证机制