Ip Geolocation X402 について
IP Geolocation X402は、AIエージェント向けの従量課金型ジオロケーションAPIで、IPv4・IPv6アドレスの位置情報とネットワーク情報を返します。単一・一括検索に対応し、Base上のUSDCをx402で支払うため、APIキーや登録は不要です。
主な機能
- 01IPv4・IPv6の位置情報検索
- 02国・都市・ISP・ASN情報
- 03VPN・プロキシ・Torの検出
- 04単一IPと一括検索
- 05Base上のUSDCによるx402決済
活用シーン
- 01IPの不正利用の兆候を確認
- 02IP地域に応じたコンテンツのローカライズ
- 03IP位置情報で分析データを拡充
- 04一括検索によるログ分析
MCP 対応
MCPサーバーは、単一IPおよび一括のジオロケーションツールをMCPクライアントに提供します。呼び出しには、Base上のUSDCによるx402従量課金が適用されます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://ip-geolocation.api.klymax402.com/mcpclaude mcp add --transport sse ip-geolocation-x402 https://ip-geolocation.api.klymax402.com/mcp{"mcpServers":{"ip-geolocation-x402":{"type":"sse","url":"https://ip-geolocation.api.klymax402.com/mcp"}}}Cursor で開く{"servers":{"ip-geolocation-x402":{"type":"sse","url":"https://ip-geolocation.api.klymax402.com/mcp"}}}VS Code で開く{"mcpServers":{"ip-geolocation-x402":{"type":"sse","url":"https://ip-geolocation.api.klymax402.com/mcp"}}}{"mcpServers":{"ip-geolocation-x402":{"serverUrl":"https://ip-geolocation.api.klymax402.com/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
IP ジオロケーション API
あらゆる IP アドレスの位置情報を特定できます。国、都市、ISP、ASN、VPN/プロキシ/Tor の検出に対応しています。IPv4 と IPv6 をサポートしています。x402(Base L2 上の USDC)による従量課金で、API キーも登録も不要です。レート制限の壁もありません。
klymax402 マーケットプレイスの一部です。AI エージェント向けの x402 マイクロペイメント API を 100 種類提供しています。ウォレットは 1 つで、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 | 1 回の呼び出しで最大 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 を使用)。
エージェント向けプロンプトの例
- 「IP アドレスの位置情報を特定して」
- 「複数の IP アドレスの位置情報を一度に特定して(最大 20 個)」
支払い
- プロトコル:x402 -- HTTP ネイティブの従量課金。登録も API キーも不要
- ネットワーク:Base L2(
eip155:8453) - アセット:USDC
- 決済仲介:Coinbase CDP(プライマリ)、PayAI(フォールバック)
- ATXP 経由でも利用できます(OAuth でラップされた x402、RFC 9728 保護リソースメタデータ)
klymax402 の一部
AI エージェント向けの x402 マイクロペイメント API を 100 種類提供します。ウォレットは 1 つで、Base 上の USDC を利用でき、登録は不要です。
- カタログ:https://klymax402.com/llms.txt
- API リファレンス全文:https://klymax402.com/llms-full.txt
- ライブ統計:https://klymax402.com/stats
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。