Bocha Search 是一个高质量的网络搜索技能,由博查 AI 提供支持,并针对 AI 消费进行了优化。它能够返回网页、图片以及详细的元数据,适合在需要搜索互联网以获取当前信息、新闻或研究主题时使用。
用途
该技能主要用于执行网络搜索,获取实时或特定时间范围内的信息。它适用于需要最新资讯、新闻或研究资料的场景,返回结果经过结构化处理,便于 AI 进一步分析和使用。
主要能力
- 返回网页结果,包含标题、URL、简短描述、全文摘要(可选)、站点名称、站点图标、发布日期(UTC+8)和页面语言。
- 返回图片结果,包含图片 URL、来源页面 URL、尺寸、缩略图 URL。
- 支持指定结果数量(1-50,默认10)。
- 支持时间范围过滤:noLimit(默认,算法自动优化)、oneDay、oneWeek、oneMonth、oneYear,或自定义日期区间(格式 YYYY-MM-DD..YYYY-MM-DD)。
- 支持是否包含文本摘要(true/false,默认 false)。
- 响应格式兼容 Bing Search API,便于集成。
使用方式
该技能需要配置博查 API 密钥。如果尚未配置,可以访问 https://open.bocha.cn 获取 API 密钥,然后通过 env_config(action="set", key="BOCHA_API_KEY", value="your-key") 设置,或手动添加到 ~/cow/.env 文件中:BOCHA_API_KEY=your-key。
使用时,脚本位于该技能的基础目录下。在 <available_skills> 中看到此技能时,注意 <base_dir> 路径。通用调用模式为:
bash "<base_dir>/scripts/search.sh" "<query>" [count] [freshness] [summary]
参数说明:
- query:搜索查询(必填)
- count:结果数量(1-50,默认10)
- freshness:时间范围过滤(默认 noLimit),可选 noLimit、oneDay、oneWeek、oneMonth、oneYear、YYYY-MM-DD..YYYY-MM-DD
- summary:是否包含文本摘要(true/false,默认 false)
示例:
- 基本搜索:bash "<base_dir>/scripts/search.sh" "latest AI news"
- 更多结果:bash "<base_dir>/scripts/search.sh" "Python tutorials" 20
- 近期内容带摘要:bash "<base_dir>/scripts/search.sh" "阿里巴巴ESG报告" 10 oneWeek true
- 指定日期范围:bash "<base_dir>/scripts/search.sh" "tech news" 15 "2025-01-01..2025-02-01"
适用场景
适用于需要获取互联网实时信息的各类任务,例如新闻检索、研究资料收集、事实核查等。由于结果针对 AI 优化,包含摘要和结构化元数据,特别适合作为 AI 工作流中的搜索组件。
限制
- 需要有效的博查 API 密钥,未配置时无法使用。
- 超时时间为30秒。
- 速率限制取决于在 https://open.bocha.cn 查看的 API 套餐。
- 时间范围建议使用 noLimit 以获得最佳结果,算法会自动优化时间范围。
- 返回结果的具体字段和格式可能受 API 版本影响,但当前兼容 Bing Search API。