Ip Geolocation X402

IP 地理定位 API

查询任意 IP 地址的地理位置——国家、城市、ISP、ASN，以及 VPN／代理／Tor 检测。支持 IPv4 和 IPv6。通过 x402 按次付费（Base L2 上的 USDC）——无需 API 密钥，无需注册，也不会遇到速率限制。

属于 klymax402 市场的一部分——为 AI Agent 提供 100 个 x402 微支付 API，一个钱包即可使用 Base 上的 USDC。

快速开始——MCP

添加到 MCP 客户端配置中（Claude Desktop、Cursor、ElizaOS 等）：

{
  "mcpServers": {
    "ip-geolocation": {
      "url": "https://ip-geolocation.api.klymax402.com/mcp"
    }
  }
}

快速开始——HTTP（x402）

curl "https://ip-geolocation.api.klymax402.com/api/lookup?ip=..."
# -> 402 Payment Required, with an x402 payment challenge in the response body

任何支持 x402 的客户端（@x402/fetch、x402-agent-tools、ATXP）都会自动处理 402 → 签名 → 重试流程。

工具

工具	方法	路径	价格	描述
ip_lookup_geolocation	GET	/api/lookup	$0.008	查询单个 IP 地址的地理位置
ip_lookup_geolocation_batch	POST	/api/lookup/batch	$0.02	单次调用查询最多 20 个 IP 地址的地理位置

ip_lookup_geolocation

需要查询 IP 地址的地理位置时使用。以 JSON 格式返回完整的位置和网络数据。

参数

名称	类型	必填	描述
ip	string	是	要查询的 IP 地址（例如 8.8.8.8）

响应示例：

{"ip":"8.8.8.8","country":"United States","countryCode":"US","region":"California","city":"Mountain View","latitude":37.386,"longitude":-122.084,"timezone":"America/Los_Angeles","isp":"Google LLC","asn":"AS15169","isVPN":false,"isProxy":false,"isTor":false}

适用场景：欺诈检测、内容本地化、按地区控制访问、分析数据丰富化和机器人检测。

不适用于：域名数据（请使用 domain_lookup_intelligence）、DNS 记录（请使用 network_lookup_dns）。

ip_lookup_geolocation_batch

需要一次查询多个 IP 地址（最多 20 个）的地理位置时使用。以 JSON 格式返回地理位置结果数组。

参数

名称	类型	必填	描述
ips	array	是	要查询的 IP 地址数组（最多 20 个）

响应示例：

{"results":[{"ip":"8.8.8.8","country":"United States","city":"Mountain View","isp":"Google LLC","isVPN":false},{"ip":"1.1.1.1","country":"Australia","city":"Sydney","isp":"Cloudflare","isVPN":false}],"total":2}

适用场景：批量日志分析、批量欺诈筛查，以及为分析数据补充位置信息。比逐个查询更经济。

不适用于：单个 IP（请使用 ip_lookup_geolocation）、域名数据（请使用 domain_lookup_intelligence）。

Agent 提示词示例

• “查询一个 IP 地址的地理位置”
• “一次查询多个 IP 地址的地理位置（最多 20 个）”

付款

• 协议：x402——基于 HTTP 的按次付费，无需注册，无需 API 密钥
• 网络：Base L2（eip155:8453）
• 资产：USDC
• Facilitator：Coinbase CDP（主要），PayAI（备用）
• 也可通过 ATXP 使用（由 OAuth 封装的 x402，受 RFC 9728 受保护资源元数据保护）

klymax402 的一部分

为 AI Agent 提供 100 个 x402 微支付 API——一个钱包即可使用 Base 上的 USDC，无需注册。

• 目录：https://klymax402.com/llms.txt
• 完整 API 参考：https://klymax402.com/llms-full.txt
• 实时统计：https://klymax402.com/stats

许可证

MIT