← Back to Skills Marketplace
kyriswu

google-search-web

by kyris wu · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
35
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install google-search-web
Description
调用 Google 网页搜索接口,获取实时网页搜索结果。使用此技能当用户需要:Google 搜索/网页搜索/搜索引擎查询、调用 /google/search/web 接口、用 Python 脚本执行 Google 搜索、获取搜索结果列表(标题/链接/摘要)。Use this skill for Google we...
README (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成功/失败信息及剩余积分>
Usage Guidance
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.
Capability Analysis
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.
Capability Tags
requires-sensitive-credentials
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install google-search-web
  3. After installation, invoke the skill by name or use /google-search-web
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Slug google-search-web
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is google-search-web?

调用 Google 网页搜索接口,获取实时网页搜索结果。使用此技能当用户需要:Google 搜索/网页搜索/搜索引擎查询、调用 /google/search/web 接口、用 Python 脚本执行 Google 搜索、获取搜索结果列表(标题/链接/摘要)。Use this skill for Google we... It is an AI Agent Skill for Claude Code / OpenClaw, with 35 downloads so far.

How do I install google-search-web?

Run "/install google-search-web" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is google-search-web free?

Yes, google-search-web is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does google-search-web support?

google-search-web is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created google-search-web?

It is built and maintained by kyris wu (@kyriswu); the current version is v1.0.0.

💬 Comments