shield_lock
JinDaGe
← Back to skills
extension
Category: Marketing & GrowthNo API key required

ICP域名备案实时查询

查询域名的实时ICP备案信息，包括公司名称、公司类型、主体备案号、网站备案号、审核时间等

personAuthor: xmchinazhubOpenAPI
downloadDownload package

Chinaz ICP 域名备案实时查询

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

运行要求

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

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

获取与配置 API Key

  1. 在 Chinaz ICP 域名备案查询接口购买页 购买接口并获取专属 API Key。
  2. 将 Key 保存为环境变量，变量名必须是：
CHINAZ_ICP_API_KEY
  1. 重新启动你的 AI 客户端或其运行环境，使新环境变量生效。

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

macOS/Linux 当前终端会话：

export CHINAZ_ICP_API_KEY='你的专属APIKey'

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

查询流程

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

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

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

结果解读

  • StateCode: 1 表示查询成功。
  • 成功结果包含以下字段：
    • CompanyName：公司名称（备案主体）
    • CompanyType：公司类型（如企业、个人、事业单位等）
    • SiteLicense：主体备案号
    • ServiceLicence：网站备案/许可证号
    • VerifyTime：审核时间
    • Domain：域名
    • ContentTypeName：前置审批项（如涉及新闻、出版、教育等需前置审批的内容）
  • 若 StateCode 非 1，按 Reason 字段说明查询状态。
  • 对公司名称、备案号等涉及企业或个人信息：仅在用户明确需要且接口实际返回时展示；不得推断、补全、关联或传播这些信息。
  • 备案信息以接口实时返回为准，仅供参考；不保证 100% 与工信部官网完全一致。

推荐答复格式：

ICP 备案查询结果
- 域名：example.com
- 查询状态：成功 / 未查询到 / 失败原因
- 公司名称：接口返回的公司名称
- 公司类型：接口返回的公司类型
- 主体备案号：接口返回的主体备案号
- 网站备案号：接口返回的网站备案号
- 审核时间：接口返回的审核时间
- 前置审批项：接口返回的前置审批项（如有）

错误处理

  • missing_api_key：环境变量未设置。按"获取与配置 API Key"创建变量后，重启运行环境。
  • HTTP 431、432、433、434：Key 缺失、格式不正确或无效。确认 Key 来自购买页的"ICP 域名备案查询"产品。
  • HTTP 436：Key 不存在或额度不足。检查账户剩余额度；如未购买，可前往购买页。
  • 业务码表示未查询到备案信息时：按原样说明"未查询到相关备案信息"，不推断域名可注册或无备案。
  • network_error 或 timeout：检查网络、DNS、代理或防火墙后重试。
  • 该接口为实时请求，建议请求数据间隔不低于 60 秒，不保证 100% 成功率。
  • 其他失败状态：按返回的 Reason 或 JSON 错误信息说明问题，不得编造备案数据。

使用边界

  • 一次只查询一个域名；批量任务须逐条执行并遵守频率限制（建议间隔不低于 60 秒）。
  • 不用于收集、关联、推断或传播企业或个人信息；不要规避备案信息展示规范。
  • 不输出、复述或保存 API Key。

应用场景

场景一：查询域名是否已备案

适用问题："这个域名有没有备案？"

建议输入：--domain "example.com"

结果用途：根据 StateCode 和 CompanyName 判断域名是否已备案。若返回公司名称则已备案，若未查询到则说明暂无备案信息。

场景二：核实域名备案主体

适用问题："这个域名是哪家公司备案的？"

建议输入：--domain "example.com"

结果用途：从 CompanyName、CompanyType 获取备案主体信息，从 SiteLicense 获取主体备案号，用于核实域名归属企业。

场景三：检查域名备案审核状态

适用问题："这个域名的备案是什么时候审核通过的？"

建议输入：--domain "example.com"

结果用途：从 VerifyTime 获取审核时间，从 ServiceLicence 获取网站备案号，判断备案是否在有效期内。