← 返回 Skills 市场

IP Address Query - IP查询

Name: IP Address Query - IP查询
Author: jisuapi

作者极速数据 · GitHub ↗ · v1.0.2 · MIT-0

cross-platform ✓ 安全检测通过

446

总下载

当前安装

版本数

在 OpenClaw 中安装

/install ip

功能描述

根据 IP 查归属地与运营商类型。当用户说：这个 IP 是哪里的？是不是机房 IP？或类似 IP 归属问题时，使用本技能。

使用说明 (SKILL.md)

\r \r

极速数据 IP 查询（Jisu IP）\r

数据由 极速数据（JisuAPI） 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。\r 根据 IP 地址查询其归属地与运营商类型。\r \r

前置配置：获取 API Key\r

前往极速数据官网注册账号\r
进入 IP 查询 API 页面，点击「申请数据」\r
在会员中心获取 AppKey\r
配置 Key：\r \r \r

# Linux / macOS\r
export JISU_API_KEY="your_appkey_here"\r
\r
# Windows PowerShell\r
$env:JISU_API_KEY="your_appkey_here"\r
```\r
\r
## 脚本路径\r
\r
脚本文件：`skills/ip/ip.py`\r
\r
## 使用方式\r
\r
### 查询 IP 归属地与运营商\r
\r
```bash\r
python3 skills/ip/ip.py '{"ip":"122.224.186.100"}'\r
```\r
\r
请求 JSON 示例：\r
\r
```json\r
{\r
  "ip": "122.224.186.100"\r
}\r
```\r
\r
## 请求参数\r
\r
| 字段名 | 类型   | 必填 | 说明   |\r
|--------|--------|------|--------|\r
| ip     | string | 是   | IP 地址 |\r
\r
## 返回结果示例\r
\r
脚本直接输出接口的 `result` 字段，结构与官网示例一致（参考 [`https://www.jisuapi.com/api/ip/`](https://www.jisuapi.com/api/ip/)）：\r
\r
```json\r
{\r
  "area": "浙江省杭州市",\r
  "type": "电信"\r
}\r
```\r
\r
当出现错误（如没有该 IP 信息）时，脚本会输出：\r
\r
```json\r
{\r
  "error": "api_error",\r
  "code": 201,\r
  "message": "没有信息"\r
}\r
```\r
\r
## 常见错误码\r
\r
来源于 [极速数据 IP 文档](https://www.jisuapi.com/api/ip/)：\r
\r
| 代号 | 说明     |\r
|------|----------|\r
| 201  | 没有信息 |\r
\r
系统错误码：\r
\r
| 代号 | 说明                 |\r
|------|----------------------|\r
| 101  | APPKEY 为空或不存在  |\r
| 102  | APPKEY 已过期        |\r
| 103  | APPKEY 无请求权限    |\r
| 104  | 请求超过次数限制     |\r
| 105  | IP 被禁止            |\r
\r
## 推荐用法\r
\r
1. 用户提供 IP：「查一下 IP `122.224.186.100` 是哪里的」。  \r
2. 代理构造 JSON：`{"ip":"122.224.186.100"}` 并调用：  \r
   `python3 skills/ip/ip.py '{"ip":"122.224.186.100"}'`  \r
3. 从返回结果中读取 `area` 和 `type` 字段，为用户总结 IP 所在的省市及运营商类型。\r
\r
## 关于极速数据\r
\r
**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供以下API：\r
\r
- **生活常用**：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息  \r
- **工具万能**：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测  \r
- **交通出行**：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询  \r
- **图像识别**：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别  \r
- **娱乐购物**：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令  \r
- **位置服务**：基站查询，经纬度地址转换，坐标系转换  \r
\r
在官网注册后，按**具体 API 页面**申请数据，在会员中心获取 **AppKey** 进行接入；**免费额度和套餐**在API详情页查看，适合个人开发者与企业进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。\r
\r

安全使用建议

This skill appears to do only IP -> location lookups via JisuAPI and asks only for the JISU_API_KEY. Before installing: 1) Confirm you trust jisuapi.com and its privacy/usage policies; the API provider will see queried IPs. 2) Ensure the runtime has Python 3 and the 'requests' package installed (the metadata didn't declare the Python dependency). 3) Provide a dedicated/limited AppKey if possible (avoid reusing sensitive credentials). 4) Be aware of API rate limits and billing on the provider side. If you want extra assurance, inspect the included ip.py (it is small and readable) and run it in a restricted environment first.

功能分析

Type: OpenClaw Skill Name: ip Version: 1.0.2 The skill is a straightforward implementation for querying IP address geolocation and ISP information via the JisuAPI service. The Python script (ip.py) safely handles input, uses environment variables for API keys, and communicates only with the legitimate API endpoint (api.jisuapi.com) without any signs of malicious intent, data exfiltration, or obfuscation.

能力评估

✓ Purpose & Capability

Name/description (IP归属地查询) matches requirements and code: the skill calls JisuAPI's IP endpoint and needs an AppKey (JISU_API_KEY). Binaries and declared primary credential are appropriate for the stated purpose.

✓ Instruction Scope

SKILL.md instructs the agent to call the provided Python script with a JSON argument and to set JISU_API_KEY. The script only reads the provided JSON and the JISU_API_KEY env var, and performs an HTTP GET to api.jisuapi.com; it does not read unrelated files or additional environment variables.

ℹ Install Mechanism

There is no install spec (instruction-only), but a code file (ip.py) is included. The script imports the third‑party 'requests' library which is not declared in the metadata; consumers should ensure the runtime has requests installed (pip install requests) or the skill will fail. No suspicious download or archive extraction is present.

✓ Credentials

Only JISU_API_KEY is required and is appropriate for an API-backed IP lookup service. No other secrets, system config paths, or unrelated credentials are requested.

✓ Persistence & Privilege

always is false and the skill does not modify system or other skills' configs. It does not request persistent elevated privileges.

如何使用

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

版本历史

v1.0.2

- Updated skill description to clarify intent and trigger usage when users ask about IP attribution or data center IPs. - Expanded configuration instructions and API Key application guide for improved onboarding. - Added "About 极速数据" section with a comprehensive API catalog to increase context and visibility of data sources. - Made formatting clearer and improved documentation style, with greater detail for recommended use and result interpretation. - No code or functional changes in this release.

v1.0.1

- No code or documentation changes in this version. - All functionality and instructions remain the same.

v1.0.0

- Initial release of the jisu-ip skill. - Provides IP location and ISP query using the Jisu Data IP API. - Requires JISU_API_KEY environment variable for authentication. - Returns geographic area and operator type for given IP addresses. - Includes error handling for common API/system codes.

元数据

Slug ip

版本 1.0.2

许可证 MIT-0

累计安装 2

当前安装数 2

历史版本数 3

常见问题