← 返回 Skills 市场
kyriswu

google-search-web

作者 kyris wu · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ 安全检测通过
35
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install google-search-web
功能描述
调用 Google 网页搜索接口,获取实时网页搜索结果。使用此技能当用户需要:Google 搜索/网页搜索/搜索引擎查询、调用 /google/search/web 接口、用 Python 脚本执行 Google 搜索、获取搜索结果列表(标题/链接/摘要)。Use this skill for Google we...
使用说明 (SKILL.md)

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
- 关键词:\x3Cq>
- azt_api_key 来源:\x3Cenv: AZT_API_KEY | 用户传入 | 免费版>

## 搜索结果

1. **\x3C标题>**
   \x3C链接>
   \x3C摘要>

2. ...

## 状态
\x3C成功/失败信息及剩余积分>
安全使用建议
This appears safe for its stated purpose, but remember that your search query and optional API key go to a third-party devtool.uk endpoint. Avoid searching for secrets or private data, use an environment variable for the API key if needed, and install the requests dependency from a trusted source.
功能分析
Type: OpenClaw Skill Name: google-search-web Version: 1.0.0 The skill is a standard wrapper for a third-party Google Search API hosted at coze-js-api.devtool.uk. The Python script (scripts/google_search.py) uses the requests library to send search queries and handles API keys through environment variables or command-line arguments in a conventional manner. There is no evidence of data exfiltration, malicious code execution, or harmful prompt injection instructions.
能力标签
requires-sensitive-credentials
能力评估
Purpose & Capability
The stated purpose and code align: the skill performs web searches and prints result titles, links, and snippets. Users should notice that it uses a devtool.uk endpoint rather than a Google-owned endpoint.
Instruction Scope
The instructions are limited to running the included Python script with a user-supplied query and formatting the results. They do not request persistence, goal override, destructive actions, or unrelated tool use.
Install Mechanism
There is no install spec, but the script requires the Python requests package and tells the user to install it if missing. This is common for an API wrapper, but the dependency is not formally declared or pinned.
Credentials
The skill can read an optional AZT_API_KEY environment variable or accept an API key as a command-line argument. This is purpose-aligned, but users should treat the key as sensitive and prefer environment variables over command-line arguments.
Persistence & Privilege
The artifacts show no background workers, persistence, broad local file access, local credential-store access, privilege escalation, or account/data mutation.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install google-search-web
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /google-search-web 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
- Initial release of Google 网页搜索 Skill. - Supports real-time Google web search via dedicated API endpoint. - Allows querying with required keyword (`q`) and optional paid API key (`azt_api_key`), with logic to use environment variable, user input, or fallback to free tier. - Includes Python script usage instructions for both free and paid API versions. - Outputs structured search results with title, link, and snippet, plus clear status and troubleshooting information.
元数据
Slug google-search-web
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

google-search-web 是什么?

调用 Google 网页搜索接口,获取实时网页搜索结果。使用此技能当用户需要:Google 搜索/网页搜索/搜索引擎查询、调用 /google/search/web 接口、用 Python 脚本执行 Google 搜索、获取搜索结果列表(标题/链接/摘要)。Use this skill for Google we... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 35 次。

如何安装 google-search-web?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install google-search-web」即可一键安装,无需额外配置。

google-search-web 是免费的吗?

是的,google-search-web 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

google-search-web 支持哪些平台?

google-search-web 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 google-search-web?

由 kyris wu(@kyriswu)开发并维护,当前版本 v1.0.0。

💬 留言讨论