bocha-search

博查搜索（Bocha Search）是一款专为 AI 应用设计的网页搜索技能，通过调用博查 AI 搜索 API，将全网信息以结构化 JSON 格式返回，完美适配大模型的数据消费需求。

核心用法

该技能以 Node.js 脚本形式运行，通过命令行接口接收搜索指令。用户只需执行 node scripts/search.js 并传入查询关键词，即可触发全网检索。支持 --count 参数控制返回结果数量（1-50条），--freshness 参数实现时间范围过滤（支持一天至一年或自定义日期范围），以及 --summary 标志获取网页详细摘要。配置方式灵活，既可通过 config.json 文件设置 API Key，也支持环境变量注入，方便不同部署环境的使用。

显著优点

首先，数据格式规范统一，响应结构兼容 Bing Search API，便于已有项目的平滑迁移。其次，内容质量高，博查搜索专为 AI 场景优化，返回结果包含标题、URL、描述、站点名称、发布时间等完整元数据，可选的摘要功能更能提供网页核心内容提炼。第三，技术实现轻量安全，仅依赖 Node.js 内置的 https 模块，零外部 npm 包引入，彻底杜绝依赖污染和供应链攻击风险。第四，查询能力强大，支持精准的时间范围限定，满足金融、科研等对信息时效性要求严格的场景。

潜在缺点与局限性

作为第三方 API 封装工具，其服务可用性完全依赖博查平台的稳定性，一旦 API 服务中断或策略调整，技能将立即失效。网络硬需求也是重要限制，离线环境完全无法使用。此外，该技能为社区个人维护（T3 来源），缺乏企业级 SLA 保障，代码更新频率和长期维护存在不确定性。功能层面，目前仅支持基础的网页搜索，缺乏图片、新闻垂直领域等高级搜索能力。

适合的目标群体

本技能特别适合构建 AI 助手的开发者，可为 RAG（检索增强生成）系统提供实时外部知识注入；适合金融分析师、研究员等需要追踪最新市场动态和学术进展的专业人士；也适合构建自动化内容聚合工具的产品团队。对于需要在国内网络环境下获取结构化搜索数据的 Node.js 应用，这是轻量且高效的选择。

使用风险

主要风险集中在 API 密钥管理，若用户误将包含密钥的 config.json 提交至公共仓库，可能导致密钥泄露和额度盗用。网络延迟方面，受限于博查服务器响应速度和用户本地网络环境，高峰时段可能出现请求超时。此外，博查 API 实施频率限制（429 错误），高并发场景下需要自行实现限流和重试机制。最后，搜索结果的准确性和时效性由博查搜索引擎决定，对于需要法律或医疗级精准度的场景，建议人工复核。