IP 查询 API

← shxai.space

域名：ip.shxai.space

你的公网 IP 是

—

概述

查询请求方的公网 IP 地址。免费模式仅返回纯文本 IP；带 API Key 返回完整 JSON（含国家、城市、ASN 等信息）。

AI Agent 使用

不想写代码？下载 ip-query Skill，直接扔给 AI Agent 读取，Agent 自己就会调用这个 API。

把这个 Skill 加载进去：
https://shxai.space/skills/ip-query.md

然后对 Agent 说：
"帮我查一下当前 IP 在哪"

查看所有 Skills →

GET 免费版：纯文本

不需要任何鉴权，直接调用：

curl https://ip.shxai.space

响应：

1.2.3.4

GET 付费版：JSON 详情

添加 ?key= 参数获取完整信息：

curl "https://ip.shxai.space?key=YOUR_API_KEY"

响应：

{
  "ip": "1.2.3.4",
  "country": "US",
  "city": "San Francisco",
  "region": "California",
  "timezone": "America/Los_Angeles",
  "asn": 13335,
  "colo": "SFO",
  "http": "HTTP/2"
}

参数

参数	类型	必填	说明
`key`	string	否	API Key。不填只返回纯文本 IP；填写并验证通过后返回完整 JSON

状态码

状态码	含义
200	成功
401	缺少 API Key（请求了 JSON 但未传 key）
403	API Key 无效

实现原理

用户请求 → ip.shxai.space (CF DNS)
  → CF CDN 边缘节点
  → CF Worker 读取 CF-Connecting-IP 请求头
  → 附加通过 request.cf 获取的 geo 信息
  → 返回结果