核心用法
bocha-search 是一款基于博查 AI 搜索 API 的网页搜索插件，专为大型语言模型和自动化工作流设计。用户可通过命令行工具或配置文件快速集成，执行全网搜索并获取结构化结果。
主要功能模块
- 全网搜索：覆盖中文互联网高质量内容源
- 智能摘要：可选返回网页详细摘要（
--summary标志），降低大模型处理成本 - 时间过滤：支持 6 种预设时间范围（一天至一年）及自定义日期区间，满足时效性需求
- 结果可控：可调节返回数量（1-50 条），默认 10 条
配置方式
插件提供双轨配置：推荐通过 config.json 文件管理 API Key，或采用环境变量 BOCHA_API_KEY 实现 CI/CD 场景的无密钥提交。
输出格式
返回 JSON 结构化数据，字段包含标题、URL、描述、摘要、站点名称及发布时间，与 Bing Search API 格式兼容，便于迁移和集成。
---
显著优点
1. AI 原生设计：响应格式专为 LLM 消费优化，减少后处理代码
2. 摘要能力：原生支持网页内容摘要生成，无需额外抓取和解析
3. 时间智能：搜索算法自动优化时间范围，兼顾全面性与时效性
4. 低接入成本：单文件配置、命令行即用，5 分钟完成集成
5. 中文优化：针对中文互联网内容源深度优化，搜索结果相关性较高
---
潜在缺点与局限性
1. 商业依赖：完全依赖博查开放平台服务，存在供应商锁定风险；API 稳定性与定价策略受第三方控制
2. 成本约束：按调用量计费，高频场景需关注余额管理（错误码 403 提示充值）
3. 范围限制：时间范围过滤（除 noLimit 外）可能导致结果为空，官方明确提示此风险
4. 网络依赖：需外部网络访问博查服务器，无法离线使用
5. 功能边界：仅为搜索聚合层，不替代原始网页内容的深度抓取与渲染
---
适合人群
- AI 应用开发者：构建 RAG（检索增强生成）系统的工程师
- 自动化工作流用户：n8n、Dify、Coze 等平台的进阶用户
- 财经/舆情分析师：需要定时搜索特定关键词并提取摘要的研究人员
- 内容聚合工具开发者：快速搭建新闻摘要、竞品监控等轻量级应用
---
常规风险
| 风险类别 | 描述 | 缓解建议 |
|---------|------|---------|
| API 密钥泄露 | 硬编码或日志打印导致密钥暴露 | 使用环境变量，配置 `.gitignore`，启用密钥轮换 |
| 速率限制触发 | 高频调用触发 429 错误 | 实施指数退避重试，监控调用频率 |
| 余额耗尽中断 | 未及时充值导致服务中断 | 设置余额阈值告警，预留备用搜索方案 |
| 结果质量波动 | 第三方索引更新延迟或源站变化 | 关键业务增加多源交叉验证 |
| 合规风险 | 搜索结果可能包含受版权保护内容 | 摘要使用需符合合理使用原则，商用需评估授权 |
---
综合评价
bocha-search 是中文 AI 搜索基础设施的实用封装，在快速原型验证和轻量级生产场景中表现优异。其核心价值在于降低 LLM 与搜索能力的集成门槛，而非替代企业级搜索架构。建议用户在关键业务中建立供应商多云策略，并针对高频场景评估自建索引的成本效益。