IP地址定位查询

技能简介

ipinfo 是一个基于 ipinfo.io API 的 IP 地址地理位置查询工具，可将 IP 地址转换为城市、地区、国家、邮编、时区和坐标等地理数据。

业务背景

帮助企业快速识别访客或用户的地理位置分布，支撑区域化运营决策、风控策略制定及合规审计。无需自建数据库，即可将IP地址转化为可读的地理标签，降低数据获取门槛。

落地案例：某电商平台发现异常订单集中在特定区域，通过批量查询订单来源IP，快速定位高风险城市并触发人工复核；市场团队分析网站访问IP分布，识别海外新兴市场潜力，为本地化投放提供依据。免费额度满足日常分析需求，高阶场景可通过令牌扩展调用量。

能做什么

• 查询单个 IP 或当前 IP 的地理位置
• 批量处理多个 IP 地址
• 提取特定字段（如城市、国家、坐标）
• 通过 Python 脚本集成调用
• 支持免费额度与付费令牌两种模式

使用说明

安装依赖

# 确保已安装 curl
which curl || apt-get install curl -y

# 可选：安装 jq 用于解析 JSON
apt-get install jq -y

配置令牌（可选）

免费版每月 5 万次请求，无需令牌。如需更高额度，在 OpenClaw 控制台配置 IPINFO_TOKEN，或设置环境变量：

export IPINFO_TOKEN="your-token"

基础查询

# 查询指定 IP
curl -s "https://ipinfo.io/8.8.8.8"

# 查询当前 IP
curl -s "https://ipinfo.io/json"

# 使用令牌
curl -s "https://ipinfo.io/8.8.8.8?token=${IPINFO_TOKEN}"

提取特定字段

# 获取城市、国家、坐标
curl -s "https://ipinfo.io/8.8.8.8" | jq -r '.city, .country, .loc'

# 仅获取国家
curl -s "https://ipinfo.io/8.8.8.8" | jq -r '.country'

Python 调用

import requests
response = requests.get("https://ipinfo.io/8.8.8.8")
data = response.json()
print(f"{data['city']}, {data['country']}")

输入与输出

见下方输入与输出表格。

风险提示

• 免费版限速约 1 次/秒，超频可能触发封禁
• 返回的国家为两位字母代码，需额外映射为全称
• 坐标格式为 “纬度,经度”，使用时需拆分
• 部分 IP 可能因代理或 VPN 导致定位偏差

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/tiagom101/ipinfo/SKILL.md
来源类型：GitHub 仓库