← Back to Skills Marketplace

ip-query

Name: ip-query
Author: shogunwin

by shogunwin · GitHub ↗ · v0.0.1 · MIT-0

cross-platform ✓ Security Clean

259

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install ip-query

Description

查询当前设备的公共IP地址及其地理位置和ISP等相关信息。

README (SKILL.md)

IP Query Skill

查询当前公共IP地址及相关信息。

描述

这个技能用于查询当前设备的公共IP地址，以及可选的附加信息（如地理位置、ISP等）。

何时使用

当用户提到以下关键词时激活此技能：

IP地址
我的IP
公网IP
当前IP
查询IP
ip address
my ip
public ip

使用方法

基本查询

"我的IP地址是什么？"
"查询当前IP"
"公网IP是多少？"

详细查询

"显示我的IP和位置信息"
"查询IP的详细信息"

功能

查询公共IP地址 - 使用公共API获取当前设备的公网IP
获取位置信息 (可选) - 根据IP查询地理位置
获取ISP信息 (可选) - 查询网络服务提供商

依赖

curl 或 wget - 用于HTTP请求
jq (可选) - 用于解析JSON响应

实现

技能使用以下公共API：

主要API: https://api.ipify.org?format=json (返回纯IP)
备用API: https://ipinfo.io/json (返回详细信息)

示例输出

🌐 您的公共IP地址: 123.45.67.89

📍 位置信息:
- 城市: 北京
- 地区: 北京市
- 国家: 中国
- 经纬度: 39.9042, 116.4074

🏢 网络信息:
- ISP: 中国电信
- 组织: China Telecom

🔒 隐私提示: 这是您的公网IP地址，请勿随意分享。

安全提示

此技能仅查询公共IP地址，不涉及私人网络信息
使用公共API，数据可能被API提供商记录
建议仅在需要时查询

脚本

主要脚本位于 scripts/ip_query.sh，包含完整的IP查询功能。

Usage Guidance

This skill is coherent and low-risk: it simply queries public IP-related APIs and prints results. Two practical considerations before installing: 1) network privacy — your public IP and request metadata are visible to the third-party APIs (ipinfo.io, ipify, etc.), so avoid using it if you don't want that logged; 2) verify you have curl installed and that the test script is run from the correct directory (scripts/test_ip.sh expects ./ip_query.sh). If you prefer not to use third-party services, review and replace the API endpoints with a self-hosted or privacy-preserving alternative before use.

Capability Analysis

Type: OpenClaw Skill Name: ip-query Version: 0.0.1 The IP Query skill is a legitimate utility designed to retrieve the user's public IP address and associated geolocation/ISP information using well-known public APIs (e.g., ipify.org, ipinfo.io). The shell scripts (scripts/ip_query.sh and scripts/test_ip.sh) are transparent, well-documented, and contain no evidence of data exfiltration, unauthorized execution, or malicious intent.

Capability Assessment

✓ Purpose & Capability

Name/description match the implementation: scripts call public IP services (api.ipify.org, ipinfo.io, etc.) to obtain IP, geolocation, and ISP info. Declared dependencies (curl, optional jq) align with the code. No unrelated credentials or binaries are requested.

✓ Instruction Scope

SKILL.md instructs the agent to use curl/wget and optionally jq to call the listed public APIs; the runtime scripts implement exactly that. The scripts do not read local credentials or unrelated files. Note: the helper test script calls ./ip_query.sh — it must be run from the scripts directory or adjusted to reference the correct path.

✓ Install Mechanism

There is no install spec (instruction-only skill) and included scripts are plain shell. Nothing is downloaded during install and no archives/unknown URLs are used.

✓ Credentials

The skill requires no environment variables, credentials, or config paths. It only needs network access to public APIs, which is appropriate for its purpose.

✓ Persistence & Privilege

always is false and the skill does not request persistent/system-wide changes or alter other skills. It only contains runnable scripts and does not persist credentials or modify agent configuration.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install ip-query
After installation, invoke the skill by name or use /ip-query
Provide required inputs per the skill's parameter spec and get structured output

Version History

v0.0.1

Initial release of the IP Query Skill: - 查询并显示当前设备的公共IP地址 - 可选获取IP所属地理位置信息和ISP信息 - 支持通过多种中文及英文关键词自动激活 - 依赖curl或wget发起请求，支持jq解析JSON - 示例输出包括IP、位置信息和网络信息

Metadata

Slug ip-query

Version 0.0.1

License MIT-0

All-time Installs 1

Active Installs 1

Total Versions 1

Frequently Asked Questions

What is ip-query?

查询当前设备的公共IP地址及其地理位置和ISP等相关信息。 It is an AI Agent Skill for Claude Code / OpenClaw, with 259 downloads so far.

How do I install ip-query?

Run "/install ip-query" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is ip-query free?

Yes, ip-query is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does ip-query support?

ip-query is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created ip-query?

It is built and maintained by shogunwin (@shogunwin); the current version is v0.0.1.

More Skills