Google 网页搜索 Skill
调用接口:
POST https://coze-js-api.devtool.uk/google/search/web
执行随附的 Python 脚本来完成请求,不要在回复中内联构造 curl 命令(除非用户明确要求)。
使用场景
以下情况触发本技能:
- 用户想搜索某个关键词并获取网页结果
- 用户需要实时搜索引擎数据
- 用户想批量获取搜索结果(标题、链接、摘要)
- 用户需要调用 Google 搜索 API
输入参数
| 参数 | 必填 | 默认值 | 说明 |
|---|---|---|---|
q | 必填 | — | 搜索关键词 |
azt_api_key | 可选 | — | 付费版鉴权 Key;不填则使用免费版(每天限一次) |
API Key 获取方式
azt_api_key 为可选参数,解析顺序如下:
- 读取环境变量
AZT_API_KEY。 - 用户在参数中直接传入
--azt_api_key。 - 两者均未提供时,使用免费版(每天限制一次)。
免费版次数已用完或需要更高频率,请前往 https://devtool.uk/plugin 购买付费版。
执行方式
# 免费版(每天一次)
python3 scripts/google_search.py --q "Python 教程"
# 付费版(设置环境变量)
export AZT_API_KEY="your_key_here"
python3 scripts/google_search.py --q "AI 最新进展"
# 付费版(直接传参)
python3 scripts/google_search.py --q "OpenAI news" --azt_api_key your_key_here
# 输出原始 JSON
python3 scripts/google_search.py --q "搜索词" --json
响应处理
- 显示请求结果状态(
code: 0为成功,code: -1为失败)。 - 列出返回的搜索结果(标题、链接、摘要)。
- 如果失败,给出可能原因及修正建议。
常见失败原因:
azt_api_key无效或已过期 → 前往 https://devtool.uk/plugin 重新购买azt_api_key积分已用完 → 联系作者续费- 免费版每日限额已用完 → 等待次日重置或购买付费版
- 网络问题或服务器错误 → 稍后重试
输出格式
# Google 网页搜索结果
- 接口:POST https://coze-js-api.devtool.uk/google/search/web
- 关键词:<q>
- azt_api_key 来源:<env: AZT_API_KEY | 用户传入 | 免费版>
## 搜索结果
1. **<标题>**
<链接>
<摘要>
2. ...
## 状态
<成功/失败信息及剩余积分>