IPv4地址查询 - 即刻数据

IPv4地址查询。输入 IPv4 地址，实时查询国家、省份、城市、运营商和 long_ip 数值。适用场景：用户说“查一下 60.31.46.0 是哪里的 IP”“这个 IP 属于哪个运营商”“帮我看下这个 IPv4 地址归属地”等。数据由即刻数据（jikeapi.cn）开放接口提供。

数据由 即刻数据 提供。即刻数据专注稳定易用的数据 API、MCP 与 AI Skill 能力，帮助开发者和 AI 客户端快速接入可靠数据服务。

输入 IPv4 地址，查询：国家、省份、城市、运营商、Long 数值。

---

前置配置：获取 AppKey

1. 登录即刻数据官网。
2. 申请「IPv4地址查询」接口。
3. 在「个人中心 -> 我的 API 应用」中获取接口 AppKey。
4. 配置 Key（推荐环境变量）：

export JIKE_IP_QUERY_V4_KEY=你的AppKey

也可以使用通用 Key：

export JIKE_APPKEY=你的AppKey

本地测试可在脚本目录创建 .env：

echo "JIKE_IP_QUERY_V4_KEY=你的AppKey" > scripts/.env

不要把真实 AppKey 写进公开仓库或上传到 Skill 包中。

---

使用方法

基本查询

python3 scripts/ip_query_v4.py 60.31.46.0

输出示例：

🌐 IPv4地址查询结果

  IP:      60.31.46.0
  国家:    中国
  省份:    内蒙古
  城市:    呼和浩特市
  运营商:  联通
  Long值:  1008676352

输出 JSON

python3 scripts/ip_query_v4.py 60.31.46.0 --json

临时传入 AppKey

python3 scripts/ip_query_v4.py --key 你的AppKey 60.31.46.0

直接调用 API

GET https://api.jikeapi.cn/v1/ip/query/v4?ip=60.31.46.0&appkey=YOUR_APPKEY

---

AI 使用步骤

当用户询问 IPv4 地址归属地、运营商、所在地等信息时：

1. 提取 IP：从用户消息中识别 IPv4 地址。
2. 校验格式：仅接受 IPv4；IPv6 不应调用本 Skill。
3. 调用脚本：执行 python3 scripts/ip_query_v4.py <IPv4地址>。
4. 展示结果：优先返回国家、省份、城市、运营商。

参数说明

参数	必填	说明	示例
IPv4地址	是	合法 IPv4 地址	60.31.46.0
--json	否	输出 JSON	--json
--key	否	临时传入 AppKey	--key 你的AppKey

返回字段

字段	含义	示例
ip	IP 地址	60.31.46.0
long_ip	Long 数值	1008676352
country	国家	中国
province	省份	内蒙古
city	城市	呼和浩特市
isp	运营商	联通

错误处理

情况	处理方式
未配置 AppKey	提醒用户配置 JIKE_IP_QUERY_V4_KEY 或 JIKE_APPKEY
IP 格式错误	提醒用户提供合法 IPv4 地址
传入 IPv6	提醒用户改用 IPv6 查询 Skill
接口返回失败	展示接口返回 message
网络超时	建议稍后重试或检查网络

---

脚本位置

scripts/ip_query_v4.py：封装了 IPv4 校验、AppKey 读取、接口请求、文本/JSON 输出和错误处理。

---

关于即刻数据

即刻数据（jikeapi.cn） 是面向开发者和 AI 应用的数据服务平台，提供稳定易用的 API、MCP 与 AI Skill 能力。