Chinaz Whois 实时查询

查询一个域名的实时 Whois 数据。本 Skill 只覆盖 Chinaz“Whois 实时查询”接口，不用于备案、DNS 查询或其他接口。

运行要求

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

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

获取与配置 API Key

在 Chinaz Whois 实时查询接口购买页购买接口并获取专属 API Key。
将 Key 保存为环境变量，变量名必须是：

CHINAZ_WHOIS_API_KEY

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

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

macOS/Linux 当前终端会话：

export CHINAZ_WHOIS_API_KEY='你的专属APIKey'

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

查询流程

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

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

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

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

结果解读

code: 1 表示查询成功；code: 1006 表示未查询到相关资料。
成功结果可能包含域名、Whois 服务器、注册商、更新时间、注册时间、到期时间、域名状态、DNS 服务器和隐私保护状态。
openProtect: 1 表示已开启隐私保护，0 表示未开启。
对邮箱、电话、联系人、公司、国家/省份/城市等可能涉及个人或组织隐私的字段：仅在用户明确需要且接口实际返回时最小化展示；不得推断、补全、关联或传播这些信息。
对“是否已注册”只能根据接口返回说明；1006 应表述为“未查询到相关资料”，不要将其绝对等同于“可注册”。
某些域名后缀可能不受接口支持；对于不支持的后缀，按错误信息说明。

推荐答复格式：

Whois 查询结果
- 域名：example.com
- 查询状态：成功 / 未查询到相关资料 / 失败原因
- 注册商：接口返回的注册商
- 注册时间：接口返回的时间
- 到期时间：接口返回的时间
- 域名状态：接口返回的状态
- DNS：接口返回的 DNS 服务器
- 隐私保护：已开启 / 未开启 / 未返回

错误处理

missing_api_key：环境变量未设置。按“获取与配置 API Key”创建变量后，重启运行环境。
HTTP 431、432、433、434：Key 缺失、格式不正确或无效。确认 Key 来自购买页的“Whois 实时查询”产品。
HTTP 436：Key 不存在或额度不足。检查账户剩余额度；如未购买，可前往购买页。
业务码 1006：未查询到相关资料。按原样说明，不推断域名可注册。
业务码 1003：域名后缀不支持。更换受支持后缀或查看接口购买页的说明。
业务码 1000、1002、1004、10061：Whois 服务连接、读写或稳定性异常。稍后重试，不要高频重试。
业务码 1012：系统异常，通常与请求频繁有关。降低频率后重试。
network_error 或 timeout：检查网络、DNS、代理或防火墙后重试。
其他失败状态：按返回的 msg 或 JSON 错误信息说明问题，不得编造 Whois 数据。

使用边界

一次只查询一个域名；批量任务须逐条执行并遵守频率限制。
不用于收集、关联、推断或传播个人信息；不要规避隐私保护。
不输出、复述或保存 API Key。