bocha-search

⚠Review·Scanned 2/18/2026

This skill implements a Bocha web-search plugin that calls the Bocha API and returns structured search results. It reads config.json or BOCHA_API_KEY, instructs running node scripts/search.js, and makes requests to https://api.bocha.cn/v1/web-search.

from clawhub.ai·v1.0.0·7.8 KB·0 installs

Scanned from 1.0.0 at ed56b28 · Transparency log ↗

$ vett add clawhub.ai/sunjingji/bocha-searchReview findings below

博查搜索 (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