域名反查IP查询

功能简介

通过域名反向查询其解析IP信息，返回IP地址、解析类型（IPv4/IPv6）、首次和最后解析成功的时间戳，帮助了解域名的DNS解析历史。

核心能力：

• 查询域名的解析IP地址
• 返回解析类型（IPv4/IPv6）
• 提供首次和最后解析成功时间

适用范围：本 Skill 只覆盖"域名反查IP"接口，不用于IP归属地查询、Whois查询、域名注册信息。

使用方式

1. 前往 域名反查IP购买页 注册登录，获取专属 API Key（0元/5次免费体验 ）
2. 将 Key 直接发送给 AI
3. 告诉 AI 要查询的域名

缺少 Key 时的引导回复

当查询返回 missing_api_key 错误时，按以下方式回复用户（根据实际查询内容调整）：

未检测到 API Key，需要你提供一下在 域名反查IP购买页 获取的专属 API Key，我才能帮你查询域名。

请直接把 Key 发给我，我会仅用于本次查询，不会保存或回显完整密钥。

查询失败（Key 无效或额度不足）时，引导用户前往 购买页 检查 Key 或额度。

---

以下为内部执行参考，回复用户时不要展示接口地址、参数格式、JSON字段名等技术细节。

参数说明

| domain | string | 必填 | 查询的域名 | chinaz.com | | page | string | 必填 | 页码，默认第1页 | 1 |

查询流程

1. 从用户请求中提取查询参数。
2. 在 Skill 根目录执行脚本：

python scripts/query_domain_reverse_ip.py --domain "chinaz.com" --page "1" --api-key "用户提供的Key"

如用户已自行配置环境变量 CHINAZ_DOMAIN_REVERSE_IP_API_KEY，可省略 --api-key 参数。如果系统将 Python 3 命令命名为 python3，使用 python3 代替 python。

3. 脚本使用 Key 调用接口发送请求参数与 ChinazVer=1.0 及 APIKey。
4. 从脚本输出的 JSON 读取结果；仅依据实际返回回答用户，不编造数据。

返回字段

成功查询后，返回 JSON 包含以下字段：

| StateCode | int | 状态码 | | Reason | string | 状态码说明 | | Result.TotalCount | string | 总数量 | | Result.TotalPage | string | 总页数 | | Result.PageNo | string | 当前页 | | Result.PageSize | string | 当前页数量（最多10条） | | Result.List.Domain | string | 查询的域名 | | Result.List.firstFind | string | 首次解析成功时间戳 | | Result.List.lastFind | string | 最后解析成功时间戳 | | Result.List.type | string | 类型（IPv4、IPv6） | | Result.List.ip | string | 当前域名解析IP |

返回示例：

{"StateCode":1,"Reason":"成功","Result":{"TotalCount":"5","TotalPage":"1","PageNo":"1","PageSize":"5","List":[{"Domain":"chinaz.com","firstFind":"1577808000","lastFind":"1684617600","type":"IPv4","ip":"117.25.139.77"}]}}

结果解读

• StateCode: 1 表示查询成功。
• 根据返回字段获取具体数据，仅依据实际返回回答用户。
• 数据仅供参考，排名类数据存在异地排名现象。

推荐答复格式：

域名反查IP查询查询结果
- 查询状态：成功 / 失败原因
- 返回数据：按字段展示

错误处理

| 错误类型 | 原因 | 解决方法 | |---------|------|---------| | missing_api_key | 缺少 API Key | 按上方"缺少 Key 时的引导回复"引导用户获取并发送 Key | | invalid_input | 域名格式不正确 | 确认输入参数格式正确后重试 | | network_error / timeout | 网络连接问题 | 检查网络、DNS、代理或防火墙后重试 |

其他失败状态：按返回的 Reason 或 JSON 错误信息说明问题，不得编造数据。

使用边界

• 一次只查询一个域名；批量任务须逐条执行。
• 数据仅供参考，排名类数据存在异地差异。
• 不输出、复述或保存 API Key。

应用场景

场景1：查询域名解析IP

你会问："这个域名解析到哪个IP？"

操作步骤：

1. 提取查询参数
2. 执行查询脚本

建议输入：--domain chinaz.com --page 1

如何解读结果：从Result.List获取IP地址和解析类型，firstFind/lastFind看解析时间范围

后续建议：根据查询结果调整SEO优化策略，持续监控数据变化。

场景2：域名IP历史分析

你会问："这个域名以前用过哪些IP？"

操作步骤：

1. 提取查询参数
2. 执行查询脚本

建议输入：--domain example.com --page 1

如何解读结果：查看历史解析IP记录，了解域名是否更换过服务器

后续建议：根据查询结果调整SEO优化策略，持续监控数据变化。

场景3：服务器迁移追踪

你会问："域名最近有没有换IP？"

操作步骤：

1. 提取查询参数
2. 执行查询脚本

建议输入：--domain example.com --page 1

如何解读结果：对比lastFind时间戳，判断域名最近是否有IP变更

后续建议：根据查询结果调整SEO优化策略，持续监控数据变化。

常见问题

Q：firstFind和lastFind是时间戳吗？

A：是的，firstFind和lastFind是Unix时间戳格式。可以通过时间戳转换工具换算成日期。

Q：每页返回多少条数据？

A：每页最多返回10条IP解析记录。如果TotalCount大于10，需要通过page参数翻页。

Q：免费额度是多少？

A：该接口免费体验额度为0元/5次，比其他接口少。用完后可前往购买页购买付费套餐，最低100元/5000次。