IPv4地址查询 - 即刻数据
数据由 即刻数据 提供。即刻数据专注稳定易用的数据 API、MCP 与 AI Skill 能力，帮助开发者和 AI 客户端快速接入可靠数据服务。
输入 IPv4 地址，查询：国家、省份、城市、运营商、Long 数值。
前置配置：获取 AppKey
- 登录即刻数据官网。
- 申请「IPv4地址查询」接口。
- 在「个人中心 -> 我的 API 应用」中获取接口
AppKey。 - 配置 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 地址归属地、运营商、所在地等信息时：
- 提取 IP：从用户消息中识别 IPv4 地址。
- 校验格式：仅接受 IPv4；IPv6 不应调用本 Skill。
- 调用脚本：执行
python3 scripts/ip_query_v4.py <IPv4地址>。 - 展示结果：优先返回国家、省份、城市、运营商。
参数说明
| 参数 | 必填 | 说明 | 示例 |
|---|---|---|---|
| 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 能力。