博查搜索API插件，提供结构化网页搜索能力，支持摘要提取与时间过滤，专为AI场景优化设计。
说明：
## 核心用法
**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 与搜索能力的集成门槛，而非替代企业级搜索架构。建议用户在关键业务中建立供应商多云策略，并针对高频场景评估自建索引的成本效益。
会员专属
