360 Secure SkillHub
360 安全技能中心

IPv4地址查询 - 即刻数据

该 Skill 通过 Python 脚本调用即刻数据 IPv4 查询接口,输入单个 IPv4 地址即可返回国家、省份、城市、运营商和 long_ip 数值,支持文本与 JSON 两种输出,需要配置 AppKey(环境变量或 --key 参数)。

jikeapi-cn
jikeapi-cn
热度 42.11
最近更新 2026-05-11 17:46:21
分类:搜索依赖:代码执行 / 第三方 API / 读写文件应用场景:研究

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add jike-ip-query-v4
Metadata
name
jike-ip-query-v4
description
IPv4地址查询。输入 IPv4 地址,实时查询国家、省份、城市、运营商和 long_ip 数值。适用场景:用户说“查一下 60.31.46.0 是哪里的 IP”“这个 IP 属于哪个运营商”“帮我看下这个 IPv4 地址归属地”等。数据由即刻数据(jikeapi.cn)开放接口提供。
homepage
https://www.jikeapi.cn/
metadata
{"openclaw":{"emoji":"🌐","requires":{"bins":["python3"],"env":["JIKE_IP_QUERY_V4_KEY"]},"primaryEnv":"JIKE_IP_QUERY_V4_KEY"}}

IPv4地址查询 - 即刻数据

数据由 即刻数据 提供。即刻数据专注稳定易用的数据 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 能力。