google-search-web

调用 Google 网页搜索接口,获取实时网页搜索结果。使用此技能当用户需要:Google 搜索/网页搜索/搜索引擎查询、调用 /google/search/web 接口、用 Python 脚本执行 Google 搜索、获取搜索结果列表(标题/链接/摘要)。Use this skill for Google web search, search engine queries, fetching search results via API.

Audits

Pass

Install

openclaw skills install google-search-web

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 为可选参数,解析顺序如下:

  1. 读取环境变量 AZT_API_KEY
  2. 用户在参数中直接传入 --azt_api_key
  3. 两者均未提供时,使用免费版(每天限制一次)。

免费版次数已用完或需要更高频率,请前往 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

响应处理

  1. 显示请求结果状态(code: 0 为成功,code: -1 为失败)。
  2. 列出返回的搜索结果(标题、链接、摘要)。
  3. 如果失败,给出可能原因及修正建议。

常见失败原因:

  • 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. ...

## 状态
<成功/失败信息及剩余积分>