← 返回 Skills 市场

IPv4地址查询 - 即刻数据

Name: IPv4地址查询 - 即刻数据
Author: jikeapi-cn

作者 jikeapi · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install jike-ip-query-v4

功能描述

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

使用说明 (SKILL.md)

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 \x3CIPv4地址>。
展示结果：优先返回国家、省份、城市、运营商。

参数说明

参数	必填	说明	示例
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 能力。

安全使用建议

This skill appears to do exactly what it says: validate an IPv4 and call the jikeapi.cn IP-query API using an AppKey. Before installing, ensure you: (1) only provide an AppKey you trust to this skill (it will be sent to the API), (2) do not set JIKE_API_BASE_URL to an unknown host (the script will honor that env var and could send your AppKey elsewhere), and (3) avoid committing the AppKey to public repositories (the README already warns about this). If you want extra assurance, inspect scripts/ip_query_v4.py yourself — it is short and readable and performs the network call to the API shown in the metadata.

功能分析

Type: OpenClaw Skill Name: jike-ip-query-v4 Version: 1.0.0 The skill is a legitimate tool for querying IPv4 address information via the Jike API (jikeapi.cn). The script `scripts/ip_query_v4.py` performs standard input validation using the `ipaddress` library and handles API keys securely via environment variables or command-line arguments. No evidence of data exfiltration, malicious execution, or prompt injection was found.

能力评估

✓ Purpose & Capability

Name/description (IPv4 geolocation) match the required binary (python3), the required env var (JIKE_IP_QUERY_V4_KEY), and the included script which calls the jikeapi.cn IP query endpoint.

✓ Instruction Scope

SKILL.md instructs the agent to extract an IPv4, validate it, and run the provided script; the script only reads an AppKey, optionally a local .env, and then queries the declared API. It does not read unrelated system files or send data to unexpected endpoints (by default).

✓ Install Mechanism

No install spec or remote download; this is instruction-only with an included Python script. No archives or external installers are used.

ℹ Credentials

The declared primary env var JIKE_IP_QUERY_V4_KEY is appropriate. The script also accepts JIKE_APPKEY (documented in SKILL.md) and will honor JIKE_API_BASE_URL if present — JIKE_API_BASE_URL is not listed in the requires.env metadata, so the script reads one additional environment variable that could change the endpoint the AppKey is sent to. This is likely for testing but is worth noting.

✓ Persistence & Privilege

always is false and the skill does not request persistent/privileged agent presence or modify other skills. Autonomous invocation is enabled by default (normal).

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install jike-ip-query-v4
安装完成后，直接呼叫该 Skill 的名称或使用 /jike-ip-query-v4 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

初始版本：支持通过即刻数据接口查询 IPv4 地址归属地

元数据

Slug jike-ip-query-v4

版本 1.0.0

许可证 MIT-0

累计安装 1

当前安装数 1

历史版本数 1

常见问题