博查搜索 (Bocha Search)

基于博查 AI 搜索 API 的网页搜索插件，返回结构化的搜索结果，适合大模型使用。

功能特点

• 🔍 全网搜索，结果准确
• 📝 可选返回网页摘要 (summary)
• ⏰ 支持时间范围过滤
• 🌐 Response 格式兼容 Bing Search API

配置

方式一：配置文件 (推荐)

编辑 config.json：

{
  "apiKey": "sk-your-api-key"
}

方式二：环境变量

export BOCHA_API_KEY="sk-your-api-key"

API Key 获取：https://open.bochaai.com → API KEY 管理

使用方法

node scripts/search.js <query> [options]

参数说明

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | <query> | string | ✅ | 搜索关键词 | | --count <n> | number | ❌ | 返回结果数量，范围 1-50，默认 10 | | --freshness <v> | string | ❌ | 时间范围过滤，默认 noLimit | | --summary | flag | ❌ | 是否返回网页摘要 |

freshness 取值说明

| 值 | 说明 | |------|------| | noLimit | 不限时间 (默认，推荐) | | oneDay | 一天内 | | oneWeek | 一周内 | | oneMonth | 一个月内 | | oneYear | 一年内 | | YYYY-MM-DD..YYYY-MM-DD | 自定义日期范围，如 2025-01-01..2025-04-06 | | YYYY-MM-DD | 指定日期，如 2025-04-06 |

⚠️ 推荐使用 noLimit，搜索算法会自动优化时间范围。指定时间范围可能导致无结果。

示例

基本搜索

node scripts/search.js "沪电股份"

限制数量

node scripts/search.js "人工智能" --count 5

带摘要

node scripts/search.js "DeepSeek" --summary

限定时间范围

node scripts/search.js "AI新闻" --freshness oneWeek --count 10

组合使用

node scripts/search.js "阿里巴巴ESG报告" --count 5 --freshness oneMonth --summary

输出格式

成功响应

{
  "type": "search",
  "query": "搜索词",
  "totalResults": 12345,
  "resultCount": 10,
  "results": [
    {
      "index": 1,
      "title": "网页标题",
      "url": "https://example.com/page",
      "description": "网页内容的简短描述",
      "summary": "网页内容的详细摘要 (需 --summary)",
      "siteName": "网站名称",
      "publishedDate": "2025-01-01T12:00:00+08:00"
    }
  ]
}

错误响应

{
  "type": "error",
  "code": "401",
  "message": "Invalid API KEY",
  "log_id": "xxxx"
}

常见错误码

| 错误码 | 说明 | 处理方式 | |--------|------|----------| | 400 | 参数缺失 | 检查 query 参数 | | 401 | API Key 无效 | 检查 config.json 或环境变量 | | 403 | 余额不足 | 前往 open.bochaai.com 充值 | | 429 | 请求频率限制 | 稍后重试 |

API 文档

• 博查开放平台：https://open.bochaai.com
• API 文档：https://bocha-ai.feishu.cn/wiki/RXEOw02rFiwzGSkd9mUcqoeAnNK