IP 地址查询 IP Lookup

查询任意 IP 地址的归属地、运营商、网络信息。无需 API key，仅需 curl。

触发时机

• "这个IP是哪里的" / "查一下 8.8.8.8"
• "我的服务器IP归属地是哪里"
• "这个访问来自哪个运营商"
• "帮我查一下这个IP是不是中国的"
• "这个域名解析到哪里"
• 排查异常访问来源、验证代理节点位置

查询接口（无需 API key，按优先级使用）

接口 A：ip-api.com（主力，中文友好）

# 查询指定IP（支持IPv4/IPv6）
curl -s "http://ip-api.com/json/{IP}?lang=zh-CN&fields=status,message,country,regionName,city,isp,org,as,query,mobile,proxy,hosting"

# 查询本机公网IP
curl -s "http://ip-api.com/json/?lang=zh-CN"

# 批量查询（最多100个，POST方式）
curl -s -X POST "http://ip-api.com/batch?lang=zh-CN" \
  -H "Content-Type: application/json" \
  -d '[{"query":"8.8.8.8"},{"query":"114.114.114.114"}]'

响应示例：

{
  "status": "success",
  "country": "中国",
  "regionName": "广东省",
  "city": "深圳市",
  "isp": "中国联通",
  "org": "China Unicom Guangdong",
  "as": "AS17816 China Unicom IP network China169 Guangdong Province",
  "query": "113.108.x.x",
  "mobile": false,
  "proxy": false,
  "hosting": false
}

字段说明：

• country / regionName / city：国家、省份、城市
• isp：互联网服务提供商（运营商）
• org：组织名称
• as：ASN 自治系统号
• mobile：是否移动网络
• proxy：是否代理/VPN
• hosting：是否托管/数据中心IP

限制：免费版每分钟45次请求，HTTP（非HTTPS）

接口 B：ipinfo.io（备用，支持HTTPS）

curl -s "https://ipinfo.io/{IP}/json"

# 查询本机IP
curl -s "https://ipinfo.io/json"

响应示例：

{
  "ip": "8.8.8.8",
  "city": "Mountain View",
  "region": "California",
  "country": "US",
  "loc": "37.3861,-122.0839",
  "org": "AS15169 Google LLC",
  "timezone": "America/Los_Angeles"
}

限制：免费版每天50,000次请求，支持HTTPS

接口 C：纯离线判断（无网络时降级）

无法访问外部接口时，根据IP段提供基础判断：

中国常见IP段（仅供参考，不完整）：
- 1.0.0.0/8      中国电信
- 14.0.0.0/8     中国移动
- 36.0.0.0/8     中国移动
- 58.0.0.0/8     中国电信/联通
- 101.0.0.0/8    中国移动/联通
- 112.0.0.0/8    中国移动
- 114.0.0.0/8    中国电信
- 117.0.0.0/8    中国移动
- 120.0.0.0/8    中国电信
- 121.0.0.0/8    中国联通
- 182.0.0.0/8    中国移动
- 183.0.0.0/8    中国移动
- 202.0.0.0/8    亚太地区
- 221.0.0.0/8    中国电信

特殊保留地址：
- 10.x.x.x       私有网络
- 172.16-31.x.x  私有网络
- 192.168.x.x    私有网络
- 127.0.0.1      本机回环

格式化输出

单IP查询

🌐 IP 查询结果
━━━━━━━━━━━━━━━━━━━━
IP 地址：113.108.x.x
归属地：🇨🇳 中国 广东省 深圳市
运营商：中国联通
组织：China Unicom Guangdong
ASN：AS17816
网络类型：宽带（非移动、非代理、非数据中心）

代理/VPN 检测结果

🌐 IP 查询结果
━━━━━━━━━━━━━━━━━━━━
IP 地址：x.x.x.x
归属地：🇺🇸 美国 加利福尼亚州 洛杉矶
运营商：Cloudflare Inc
⚠️  检测到：疑似代理/VPN 或 托管服务器IP

批量查询汇总

🌐 批量 IP 查询（3个）
━━━━━━━━━━━━━━━━━━━━
1. 8.8.8.8        🇺🇸 美国 · Google LLC
2. 114.114.114.114 🇨🇳 中国 江苏 · 中国移动
3. 1.1.1.1        🇦🇺 澳大利亚 · Cloudflare
━━━━━━━━━━━━━━━━━━━━
中国IP：1个 / 海外IP：2个

本机公网IP查询

🌐 本机公网 IP
━━━━━━━━━━━━━━━━━━━━
IP 地址：x.x.x.x
归属地：🇨🇳 中国 北京市
运营商：中国电信
提示：此为 OpenClaw 所在机器的出口IP

执行流程

用户输入IP地址/域名/本机
  ↓
[验证] 判断输入类型（IPv4/IPv6/域名/本机）
  ↓
[查询] curl ip-api.com（主力接口）
  ↓ 失败（限速/网络问题）
[查询] curl ipinfo.io（备用接口）
  ↓ 全部失败
[降级] 离线IP段基础判断 + 提示用户
  ↓
[输出] 格式化结果 + 异常标注

注意事项

• ip-api.com 免费版使用 HTTP（非 HTTPS），不要在请求中携带敏感信息
• 查询结果为地理数据库匹配，精确到城市级别，不代表用户实际物理位置
• proxy: true 仅为启发式判断，不能100%确定是否使用了代理
• 私有IP（10.x/192.168.x/172.16-31.x）无法查询，直接告知用户
• IPv6查询两个接口均支持