技能介绍

做应用开发或服务器运维时，我们经常会遇到上线前验证域名合规性的需求，或者是排查第三方接入域名资质的问题。ICP域名备案实时查询这个工具就是专门用来解决“如何快速、结构化地验证某个特定域名当前备案状态”这一具体问题的。

工作原理与核心能力

这个 Skill 的核心能力非常专注：它仅封装了 Chinaz 的“ICP域名备案实时查询”接口，不涉及 Whois 查询、DNS 解析或其他接口。整个工作流基于 Python 3 标准库构建，无需安装第三方依赖。

当用户传入一个待查询的域名或 URL 时，Skill 会提取纯净的 domain 参数，并直接发起 GET 请求至 https://openapi.chinaz.net/v1/1001/newicp。在鉴权方面，脚本会安全地读取本地环境变量（ChinazVer=1.0）中的 API Key，而不是将其硬编码在代码中。

接口返回的 JSON 数据经过结构化处理后，包含以下关键字段：

CompanyName：备案主体名称
CompanyType：主体类型（如企业、个人）
SiteLicense：主体备案号
ServiceLicence：网站备案/许可证号
VerifyTime：备案审核时间

开发者可以根据 StateCode 是否为 1 来判断查询是否成功。若成功，脚本会输出上述备案详情；若业务码提示未查询到，则直接返回未查询到相关备案信息，绝不进行任何推断。

适用边界与安全注意点

在使用这个 Skill 时，需要注意以下几点技术约束与安全规范：

频率限制：该接口为实时请求，官方建议请求间隔不低于 60 秒。对于批量任务，必须逐条执行并严格遵守此限制。
密钥安全：API Key 必须配置在环境变量中。严禁将真实 Key 写入代码仓库、日志或聊天记录。建议优先使用客户端提供的 Secrets 管理功能。
隐私合规：该工具仅用于核实备案状态，不得用于收集、关联或传播企业及个人信息。如果接口返回了公司名称等隐私数据，仅在用户明确需要且接口实际返回时展示，不得自行推断或补全。
数据时效性：虽然为实时查询，但结果仅供参考，不保证 100% 与工信部官网完全一致。