← Back to Skills Marketplace
97
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install ip-lookup-tool
Description
查询当前公网 IP、城市位置(含中文名)和运营商。当用户问“我的 IP 是多少”“我现在的 IP 地址”“我在哪个城市上网”这类问题时使用。优先返回公网出口 IP,而不是局域网 IP。
README (SKILL.md)
IP Lookup Tool
当用户问这些问题时,触发本 skill:
- 我的 IP 是多少
- 我现在的 IP 地址
- 看看我现在在哪个城市上网
- 查一下当前公网 IP 和位置
行为原则
- 返回 公网出口 IP(如
23.x.x.x),不要返回 192.168/10.x 这类内网地址 - 使用轻量免鉴权接口,例如
https://ipinfo.io/json等 - 只做一次 HTTP 请求,优先顺序:
https://ipinfo.io/jsonhttps://ifconfig.co/jsonhttps://api.ip.sb/geoip
- 若主源失败,自动降级到下一源
- 不要对精确位置做过度解读,只提供大致城市/国家信息
- 明确说明“这是公网出口 IP,不一定等于本机局域网 IP”
脚本说明
脚本路径:skills/ip-lookup/scripts/ip_lookup.js
用途:查询当前会话出口的公网 IP 和大致位置。
调用示例:
node skills/ip-lookup/scripts/ip_lookup.js
输出(人类可读):
公网 IP:23.249.16.36
城市:新宿区(Tokyo, JP)
运营商:AS400618 Prime Security Corp.
如需要 JSON(例如后续程序处理),可使用:
node skills/ip-lookup/scripts/ip_lookup.js --json
返回字段:
ip:公网 IP 地址city:英文城市(若有)cityZh:中文城市/区县(best-effort,若有)region:地区/省份(若有)country:国家代码org:运营商/自治系统信息(若有)loc:经纬度字符串(若有)source:实际使用的接口来源fetchedAt:ISO 格式查询时间
错误处理
- 接口访问失败时,明确说明“暂时无法获取公网 IP”,不要编造 IP 或位置
- 若部分字段缺失(如没有城市),只返回能确定的信息
- 若多次接口都失败,建议用户稍后重试或检查网络
Usage Guidance
This skill appears to do only what it claims: query public IP/geolocation services and optionally reverse-geocode coordinates to Chinese place names. Installing and running it will make outbound HTTPS requests to third-party services (ipinfo.io, ifconfig.co, api.ip.sb, and OpenStreetMap Nominatim), which will see your public IP and any request metadata (User-Agent). If you are concerned about privacy or leaking your IP to additional endpoints, do not install or modify the script to disable reverse geocoding. Note the minor inconsistency: SKILL.md says 'only one HTTP request' but the script may make a second request to Nominatim for cityZh. If you want stricter behavior, remove or gate the reverseGeocodeZh call and/or add a configurable flag. No credentials are requested and there are no install-time downloads, so the technical risk is low, but be aware of rate limits and third-party data sharing.
Capability Analysis
Type: OpenClaw Skill
Name: ip-lookup-tool
Version: 1.0.0
The skill is a standard IP and geolocation lookup tool that functions as described. It queries reputable third-party services (ipinfo.io, ifconfig.co, ip.sb) and uses OpenStreetMap for reverse geocoding. The implementation in `scripts/ip_lookup.js` uses built-in Node.js modules, lacks external dependencies, and contains no evidence of malicious intent, data exfiltration, or unauthorized execution.
Capability Assessment
Purpose & Capability
Name/description match the implementation: the script queries public IP geolocation endpoints, normalizes results, and formats human/JSON output. Required capabilities (none) are proportional to the stated purpose.
Instruction Scope
SKILL.md specifies using one unauthenticated IP API (falling back to alternatives). The script follows that priority for IP providers but may perform an additional HTTP request to OpenStreetMap Nominatim (reverse geocoding) when coordinates exist to produce a Chinese city name. That extra external request contradicts the SKILL.md line '只做一次 HTTP 请求' (only do one HTTP request) and means an additional third-party endpoint sees the caller's IP.
Install Mechanism
No install spec or external downloads; this is an instruction-only skill with an included Node.js script. No installers, archives, or third-party packages are pulled during install.
Credentials
The skill requests no environment variables, credentials, or config paths. There are no disproportionate credential requests.
Persistence & Privilege
The skill is not always-enabled and does not request persistent/privileged presence or modify other skills or system settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ip-lookup-tool - After installation, invoke the skill by name or use
/ip-lookup-tool - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: show public IP, city (with Chinese name best-effort), and ISP
Metadata
Frequently Asked Questions
What is IP Lookup Tool?
查询当前公网 IP、城市位置(含中文名)和运营商。当用户问“我的 IP 是多少”“我现在的 IP 地址”“我在哪个城市上网”这类问题时使用。优先返回公网出口 IP,而不是局域网 IP。 It is an AI Agent Skill for Claude Code / OpenClaw, with 97 downloads so far.
How do I install IP Lookup Tool?
Run "/install ip-lookup-tool" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is IP Lookup Tool free?
Yes, IP Lookup Tool is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does IP Lookup Tool support?
IP Lookup Tool is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created IP Lookup Tool?
It is built and maintained by daguniang (@daguniang); the current version is v1.0.0.
More Skills