IPinfo 地理位置

免费IP地理位置API。基础使用无需API密钥（每月5万次请求），可选令牌以获得更高限额。

配置

IPINFO_TOKEN 环境变量是可选的——该技能无需令牌即可使用免费套餐。通过OpenClaw仪表盘UI配置可获得更高速率限制，或手动设置：

• - 仪表盘UI：在OpenClaw仪表盘中配置 IPINFOTOKEN（可选）
• 环境变量：export IPINFOTOKEN=your-token
• 查询参数：?token=YOUR_TOKEN（用于单次请求）

快速查询

单个IP：

bash
curl -s https://ipinfo.io/8.8.8.8

当前IP：

bash
curl -s https://ipinfo.io/json

带令牌（可选，从环境变量获取）：

bash
curl -s https://ipinfo.io/8.8.8.8?token=${IPINFO_TOKEN}

或直接传递令牌：

bash
curl -s https://ipinfo.io/8.8.8.8?token=YOUR_TOKEN

响应格式

JSON响应包含：

• - ip：IP地址
• hostname：反向DNS主机名
• city：城市名称
• region：州/地区
• country：两位字母国家代码（ISO 3166-1 alpha-2）
• postal：邮政编码
• timezone：IANA时区
• loc：坐标，格式为纬度,经度
• org：组织/ASN信息

提取特定字段

使用 jq：

bash
curl -s https://ipinfo.io/8.8.8.8 | jq -r .city, .country, .loc

仅国家：

bash
curl -s https://ipinfo.io/8.8.8.8 | jq -r .country

解析坐标：

bash
curl -s https://ipinfo.io/8.8.8.8 | jq -r .loc | tr , \n

批量处理

处理多个IP：

bash
for ip in 8.8.8.8 1.1.1.1 208.67.222.222; do
if [ -n $IPINFO_TOKEN ]; then
echo $ip: $(curl -s https://ipinfo.io/$ip?token=$IPINFO_TOKEN | jq -r .city, .country | tr \n , )
else
echo $ip: $(curl -s https://ipinfo.io/$ip | jq -r .city, .country | tr \n , )
fi
done

Python使用

python
import os
import requests

无令牌（免费套餐）

从环境变量获取令牌：

python
import os
import requests

token = os.getenv(IPINFO_TOKEN)
if token:
response = requests.get(https://ipinfo.io/8.8.8.8, params={token: token})
else:
response = requests.get(https://ipinfo.io/8.8.8.8)
data = response.json()

或直接传递令牌：

python
response = requests.get(https://ipinfo.io/8.8.8.8, params={token: YOUR_TOKEN})

速率限制

• - 免费套餐：每月5万次请求，约1次/秒
• 带令牌：根据套餐提供更高限制
• 通过OpenClaw仪表盘UI或环境变量配置 IPINFO_TOKEN

常见用例

• - 定位IP地址的地理位置
• 用位置数据丰富IP列表
• 按国家筛选IP
• 使用坐标计算IP之间的距离
• 检测IP的时区