谷歌域名报毒检测

检测一个域名在谷歌搜索或谷歌浏览器(Google Chrome)中是否正常打开。本 Skill 只覆盖站长工具开放平台"谷歌域名报毒检测"接口，不用于 Whois、备案或其他接口。

运行要求

• 支持标准 Agent Skills 的 AI 客户端，且允许执行本地命令。
• Python 3；脚本只使用 Python 标准库，无需安装第三方依赖。
• 能够向 https://openapi.chinaz.net 发起 HTTPS 请求。
• 运行 AI 客户端的环境可读取环境变量。

如果使用的 AI 服务不支持本地命令或环境变量，请改用该服务支持的本地客户端、沙盒密钥管理或安全环境变量注入方式；不要在聊天中发送 API Key。

获取与配置 API Key

1. 在谷歌域名报毒检测接口购买页购买接口并获取专属 API Key。
2. 将 Key 保存为环境变量，变量名必须是：

CHINAZ_GOOGLE_SAFE_API_KEY

3. 重新启动你的 AI 客户端或其运行环境，使新环境变量生效。

Windows 图形界面：搜索并打开"编辑账户的环境变量"，在"用户变量"中新增该变量，变量值填入购买后获得的 Key。

macOS/Linux 当前终端会话：

export CHINAZ_GOOGLE_SAFE_API_KEY='你的专属APIKey'

不要把真实 Key 写入 SKILL.md、源代码、命令行参数、日志、仓库或聊天记录。若 AI 客户端提供"Secrets""Environment Variables"或"Credentials"配置页，优先使用其安全存储功能。

查询流程

1. 从用户请求中提取 domain：待检测域名，例如 example.com。可使用 URL 输入；脚本会去除协议、路径、查询参数和片段。
2. 在 Skill 根目录执行脚本：

python scripts/query_google_safe.py --domain "example.com"

如果系统将 Python 3 命令命名为 python3，使用 python3 代替 python。

3. 脚本读取环境变量中的 Key，并调用原始 GET 接口 https://openapi.chinaz.net/v1/1029/check_google，发送 url、ChinazVer=1.0 与 APIKey。
4. 从脚本输出的 JSON 读取结果；仅依据实际返回回答用户。

结果解读

• code: 1 表示检测成功。
• statu: true 表示域名正常，未被谷歌报毒标记，可以正常打开。
• statu: false 表示域名异常，可能已被谷歌报毒或标记为不安全。
• msg 字段包含返回的描述信息。
• url 字段为实际检测的域名地址。
• 不得根据检测结果推断域名的具体安全威胁类型或恶意软件名称；仅依据接口返回的 statu 和 msg 说明。
• 如果 code 不为 1，按返回的 msg 说明问题，不要编造检测结果。

推荐答复格式：

谷歌域名报毒检测结果
- 域名：example.com
- 检测状态：成功 / 失败原因
- 安全状态：正常 / 已报毒
- 说明：接口返回的 msg 信息

错误处理

• missing_api_key：环境变量未设置。按"获取与配置 API Key"创建变量后，重启运行环境。
• HTTP 431、432、433、434：Key 缺失、格式不正确或无效。确认 Key 来自购买页的"谷歌域名报毒检测"产品。
• HTTP 436：Key 不存在或额度不足。检查账户剩余额度；如未购买，可前往购买页。
• network_error 或 timeout：检查网络、DNS、代理或防火墙后重试。
• 其他失败状态：按返回的 msg 或 JSON 错误信息说明问题，不得编造检测结果。

使用边界

• 一次只检测一个域名；批量任务须逐条执行并遵守频率限制。
• 不输出、复述或保存 API Key。
• 检测结果仅反映谷歌安全浏览的判定状态，不构成域名安全性的绝对保证。
• 不得用于绕过安全机制或进行恶意域名探测。