菜单
博查搜索 (Bocha Search) 的 Python 实现技能，提供增强的网页搜索能力。当用户需要通过博查 AI 搜索 API 进行网页搜索、获取联网信息、查找最新资讯或中文内容时使用此技能。与现有的 JavaScript 版本相比，本技能提供更稳定的连接、更灵活的输出格式（原始 JSON/Brave 兼容格式/Markdown）、更好的错误处理和重试机制。适用于 AI Agent 需要联网搜索、RAG 应用获取网页摘要、中文内容检索等场景。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/GeorgeDoors888/GB-Power-Market-JJ --skill bocha-search-python命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
超级简历 WonderCV 出品，3000 万用户信赖。简历分析、段落改写、JD 岗位匹配、自动匹配职位、PDF 导出、AI 求职导师（面试准备/薪资谈判/职业规划/多版本简历策略）。 触发条件：用户提供简历、要求简历点评/打分/反馈、希望改写某个简历部分、 希望将简历与岗位 JD 匹配、咨询求职建议或面试准备，或提到 CV/简历/求职。 不触发条件：用户讨论普通写作（非简历）、询问其他文档， 或讨论与求职和职业发展无关的话题。
Order food/drinks (点餐) on an Android device paired as an OpenClaw node. Uses in-app menu and cart; add goods, view cart, submit order (demo, no real payment).
调用久吾智能体API进行文本或文件分析处理。支持两种调用方式：(1) 文本内容分析 - 传入name(智能体名称)、docno(文档编号)、content(文本内容)；(2) 文件分析 - 传入name、docno和files(文件列表)进行智能评审。适用于合同评审、需求评审、文档审查等场景。当用户要求评审合同、分析条款、审查文档、需求评审、合同条款分析、或需要对文本和文件进行AI智能分析时触发。
基于 SOC 职业分类
正在显示 SKILL.md
| name | bocha-search-python |
| description | 博查搜索 (Bocha Search) 的 Python 实现技能，提供增强的网页搜索能力。当用户需要通过博查 AI 搜索 API 进行网页搜索、获取联网信息、查找最新资讯或中文内容时使用此技能。与现有的 JavaScript 版本相比，本技能提供更稳定的连接、更灵活的输出格式（原始 JSON/Brave 兼容格式/Markdown）、更好的错误处理和重试机制。适用于 AI Agent 需要联网搜索、RAG 应用获取网页摘要、中文内容检索等场景。 |
博查搜索 Python 版是一个增强的博查 AI 搜索 API 客户端，专为 AI Agent 和自动化工作流设计。相比现有的 JavaScript 版本，本技能提供：
提供 API 密钥的两种方式（按优先级排序）：
.env 文件：在 ~/.openclaw/.env 中添加（优先级最高）
BOCHA_API_KEY=sk-your-api-key
环境变量：设置 BOCHA_API_KEY
export BOCHA_API_KEY="sk-your-api-key"
API 密钥获取：访问 https://open.bochaai.com → API KEY 管理
# 使用位置参数
python3 scripts/search.py "沪电股份"
# 使用 --query 选项
python3 scripts/search.py --query "人工智能" --count 5
# 返回详细摘要
python3 scripts/search.py "DeepSeek" --summary
# 限制时间范围
python3 scripts/search.py "AI新闻" --freshness oneWeek --count 10
# 原始 JSON 格式（API 原始响应）
python3 scripts/search.py "阿里巴巴" --format raw
# Brave/Bing 兼容格式（默认，适合 AI 使用）
python3 scripts/search.py "阿里巴巴" --format brave
# Markdown 格式（人类可读）
python3 scripts/search.py "阿里巴巴" --format md
支持多种时间范围格式：
| 值 | 说明 | 示例 |
|---|---|---|
noLimit | 不限时间（默认） | --freshness noLimit |
oneDay | 一天内 | --freshness oneDay |
oneWeek | 一周内 | --freshness oneWeek |
oneMonth | 一个月内 | --freshness oneMonth |
oneYear | 一年内 | --freshness oneYear |
YYYY-MM-DD | 指定日期 | --freshness 2025-04-06 |
YYYY-MM-DD..YYYY-MM-DD | 日期范围 | --freshness 2025-01-01..2025-04-06 |
示例：
# 搜索 2025 年 4 月的内容
python3 scripts/search.py "苹果发布会" --freshness 2025-04
# 搜索 2025 年第一季度内容
python3 scripts/search.py "财报" --freshness 2025-01-01..2025-03-31
脚本内置错误处理和重试机制：
# 设置重试次数（默认 2 次）
python3 scripts/search.py "查询" --retries 3
# 设置超时时间（默认 30 秒）
python3 scripts/search.py "查询" --timeout 60
支持备用 API 端点：
# 使用备用端点
python3 scripts/search.py "查询" --endpoint "https://api.bocha.cn/v1/web-search"
{
"type": "search",
"query": "阿里巴巴",
"totalResults": 12345,
"resultCount": 10,
"results": [
{
"index": 1,
"title": "阿里巴巴发布2024年ESG报告",
"url": "https://www.alibabagroup.com/document...",
"description": "阿里巴巴集团发布《2024财年环境、社会和治理（ESG）报告》...",
"summary": "报告显示，阿里巴巴扎实推进减碳举措...",
"siteName": "阿里巴巴集团",
"publishedDate": "2024-07-22T00:00:00+08:00"
}
]
}
## 搜索结果: 阿里巴巴
*找到约 12345 条结果*
1. **阿里巴巴发布2024年ESG报告**
*阿里巴巴集团*
[https://www.alibabagroup.com/document...](https://www.alibabagroup.com/document...)
阿里巴巴集团发布《2024财年环境、社会和治理（ESG）报告》...
*摘要*: 报告显示，阿里巴巴扎实推进减碳举措...
*发布时间*: 2024-07-22T00:00:00+08:00
# 从 OpenClaw workspace 根目录调用
python3 skills/bocha-search-python/scripts/search.py "查询"
# 使用绝对路径
python3 /root/.openclaw/workspace/skills/bocha-search-python/scripts/search.py "查询"
在 Agent 的响应中调用搜索并处理结果：
# 示例：在 Python 代码中调用
import subprocess
import json
def bocha_search(query, count=5):
cmd = [
"python3",
"/root/.openclaw/workspace/skills/bocha-search-python/scripts/search.py",
"--query", query,
"--count", str(count),
"--format", "brave"
]
result = subprocess.run(cmd, capture_output=True, text=True)
if result.returncode == 0:
return json.loads(result.stdout)
else:
raise Exception(f"搜索失败: {result.stderr}")
| 错误代码 | 原因 | 解决方案 |
|---|---|---|
INVALID_ARGUMENT | 参数错误 | 检查查询关键词和参数格式 |
API_ERROR | API 请求失败 | 检查 API 密钥和网络连接 |
UNKNOWN_ERROR | 未知错误 | 查看详细错误信息并重试 |
要查看更多调试信息，可以修改脚本或添加调试输出：
# 在 search.py 中添加调试
import logging
logging.basicConfig(level=logging.DEBUG)
# 简单测试 API 密钥是否有效
curl -X POST "https://api.bochaai.com/v1/web-search" \
-H "Authorization: Bearer YOUR-API-KEY" \
-H "Content-Type: application/json" \
-d '{"query": "test", "count": 1}'
主搜索脚本，包含所有核心功能。
bocha-search: 原始的 JavaScript 版本tavily-search: Tavily 搜索 API 技能web_search: 内置网页搜索工具注意：本技能需要有效的博查 API 密钥。使用前请确保已注册并获取密钥。