公式 OpenIPApi SDK

JavaScript、Python、PHP 向けの軽量な公式クライアントをダウンロードできます。

すべての SDK は同じ REST API（https://api.openipapi.com）を対象とし、X-API-Key ヘッダーで認証を行い、同じメソッドを公開します：lookup(ip)、me()、batch(ips)、asn(asn)、validate(ip)。

MCP サーバー — AI アシスタント向け

@openipapi/mcp

Claude をはじめとする MCP 対応の AI アシスタントに、OpenIPApi への直接アクセスを提供します：IP ルックアップ、一括チェック、不正スコアなどを型付きツールとして利用できます。npx コマンド 1 つで、コードは不要です。

含まれるツール

lookup_ip · batch_lookup · my_ip · validate_ip · asn_lookup · fraud_score

セットアップ

// claude_desktop_config.json
{ "mcpServers": { "openipapi": {
  "command": "npx",
  "args": ["-y", "@openipapi/mcp"],
  "env": { "OPENIPAPI_API_KEY": "oip_..." }
} } }

# Claude Code
claude mcp add openipapi \
  -e OPENIPAPI_API_KEY=oip_... \
  -- npx -y @openipapi/mcp

JavaScript / TypeScript

ダウンロード: openipapi.js

インストール / 使用

ファイルをプロジェクトにドロップ（またはブラウザで /sdk/javascript/openipapi.js から直接インポート）してください。最新のブラウザと Node.js 18+ で動作します。ビルド手順やサードパーティ依存関係は不要です。

エンドポイント互換性

5 つの REST エンドポイントすべて：lookup、me、batch、asn、validate。プラン制限のあるエンドポイントは、引き続き API キーに該当するプランが必要です。

例

import { OpenIPApi } from '/sdk/javascript/openipapi.js';

const client = new OpenIPApi('YOUR_KEY');
const data = await client.lookup('8.8.8.8');
console.log(data.threat?.is_vpn);

// Batch lookup
const batch = await client.batch(['8.8.8.8', '1.1.1.1']);

Python

ダウンロード: openipapi.py

インストール / 使用

ファイルをプロジェクトにドロップしてインポートしてください。Python 3.8+。標準ライブラリ（urllib）のみを使用します。

エンドポイント互換性

例

from openipapi import OpenIPApi

client = OpenIPApi("YOUR_KEY")
data = client.lookup("8.8.8.8")
print(data.get("threat", {}).get("is_vpn"))

# Batch lookup
batch = client.batch(["8.8.8.8", "1.1.1.1"])

PHP

ダウンロード: OpenIPApiClient.php

インストール / 使用

ファイルをプロジェクトにドロップして require してください。PHP 8.0+。利用可能な場合は curl を使用し、ストリームコンテキストへのフォールバックも備えています。Composer は不要です。

エンドポイント互換性

例

require __DIR__ . '/OpenIPApiClient.php';

$client = new OpenIPApiClient('YOUR_KEY');
$data = $client->lookup('8.8.8.8');
echo !empty($data['threat']['is_vpn']) ? 'yes' : 'no';

// Batch lookup
$batch = $client->batch(['8.8.8.8', '1.1.1.1']);

直接 HTTP フォールバック

OpenIPApi の使用に SDK は必要ありません。API はシンプルな REST + JSON レイヤーであり、任意の HTTP クライアントで動作します：

$ curl https://api.openipapi.com/v1/lookup/8.8.8.8 \
     -H "X-API-Key: YOUR_KEY"

npm、PyPI、Packagist のパッケージレジストリ版は後日追加される可能性があります。