← 返回 Skills 市场
1782
总下载
0
收藏
19
当前安装
1
版本数
在 OpenClaw 中安装
/install bocha-search
功能描述
博查搜索 API 插件，从全网搜索网页信息，结果准确、摘要完整，适合 AI 使用。
使用说明 (SKILL.md)
博查搜索 (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 \x3Cquery> [options]
参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
\x3Cquery> |
string | ✅ | 搜索关键词 |
--count \x3Cn> |
number | ❌ | 返回结果数量，范围 1-50，默认 10 |
--freshness \x3Cv> |
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
安全使用建议
This skill appears to be a straightforward wrapper for the Bocha web-search API, but the package metadata omitted that it needs an API key and a config.json. Before installing or providing credentials: 1) Confirm you trust the publisher and the API host — the SKILL.md links to open.bochaai.com but the script posts to https://api.bocha.cn; verify those endpoints are legitimate and intended. 2) Treat BOCHA_API_KEY like any secret: use a dedicated limited-permission key if possible, and do not reuse broader credentials (AWS, GitHub, etc.). 3) Note the script expects config.json at the package root (it reads ../config.json from scripts/); ensure you understand where to put the file and its filesystem visibility. 4) If you need higher assurance, ask the publisher to update registry metadata to declare the required BOCHA_API_KEY and the config path, and to confirm the official API URL. 5) Run the script in an isolated environment or review network traffic if you want to observe exactly what is sent/received before giving it any sensitive keys.
功能分析
Type: OpenClaw Skill
Name: bocha-search
Version: 1.0.0
The skill bundle provides a client for the Bocha Search API. The `SKILL.md` file contains clear instructions for configuration and usage without any prompt injection attempts. The `scripts/search.js` script correctly implements the search functionality, securely loading the API key from environment variables or a local `config.json` file, and making HTTPS requests to the specified `https://api.bocha.cn/v1/web-search` endpoint. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, or other high-risk behaviors beyond its stated purpose.
能力评估
Purpose & Capability
The name/description say this is a Bocha web-search plugin and the code implements a simple search POST to an external API. That purpose legitimately requires an API key. However, the skill registry metadata lists no required environment variables or config paths, which is inconsistent with the SKILL.md and scripts/search.js that expect BOCHA_API_KEY or a config.json containing apiKey.
Instruction Scope
SKILL.md and scripts/search.js keep scope limited to performing web searches against Bocha's API and formatting results. They do instruct the agent/user to set BOCHA_API_KEY via an env var or a config.json. The README doesn't show any instructions to read unrelated files or exfiltrate data. Minor issue: SKILL.md refers generically to editing config.json but the script reads ../config.json relative to scripts/, which could be confusing when installed/run from other working directories.
Install Mechanism
No install spec; this is instruction + included Node script. Nothing is downloaded or written to disk by an installer. Risk from installation is low.
Credentials
The code requires an API credential (BOCHA_API_KEY or config.json apiKey) which is proportionate to a search API plugin. However, the skill metadata incorrectly declares no required env vars or primary credential. That omission reduces transparency and could mislead users about secret requirements.
Persistence & Privilege
The skill does not request always:true, does not modify other skills, and contains no autonomous persistence behaviors. Default autonomous invocation is allowed but not combined with other privilege escalations.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install bocha-search - 安装完成后，直接呼叫该 Skill 的名称或使用
/bocha-search触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Bocha Search 1.0.0 — Initial Release
- Provides a web search API plugin with full-web coverage and accurate, structured results.
- Supports optional webpage summaries, time range filtering, and Bing Search API-compatible response format.
- Allows configuration via config file or environment variable for API keys.
- Command-line usage includes result count, time filtering, and summary options.
- Includes sample outputs and detailed parameter explanations for flexible integration.
元数据
常见问题
博查搜索 是什么？
博查搜索 API 插件，从全网搜索网页信息，结果准确、摘要完整，适合 AI 使用。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 1782 次。
如何安装 博查搜索？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install bocha-search」即可一键安装，无需额外配置。
博查搜索 是免费的吗？
是的，博查搜索 完全免费（开源免费），可自由下载、安装和使用。
博查搜索 支持哪些平台？
博查搜索 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 博查搜索？
由 sunjingji（@sunjingji）开发并维护，当前版本 v1.0.0。
推荐 Skills