SDKs officiels OpenIPApi

Téléchargez les clients officiels légers pour JavaScript, Python et PHP.

Tous les SDKs ciblent la même API REST sur https://api.openipapi.com, s'authentifient avec l'en-tête X-API-Key, et exposent les mêmes méthodes : lookup(ip), me(), batch(ips), asn(asn), validate(ip).

Serveur MCP — pour les assistants IA

@openipapi/mcp

Donnez à Claude ou à tout assistant IA compatible MCP un accès direct à OpenIPApi : lookups IP, vérifications en masse, scores de fraude et plus encore, sous forme d'outils typés. Une seule commande npx, aucun code.

Outils inclus

lookup_ip · batch_lookup · my_ip · validate_ip · asn_lookup · fraud_score

Configuration

// 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

Télécharger: openipapi.js

Installer / utiliser

Déposez le fichier dans votre projet (ou importez-le directement depuis /sdk/javascript/openipapi.js dans un navigateur). Fonctionne dans les navigateurs modernes et Node.js 18+. Aucune étape de build, aucune dépendance tierce.

Compatibilité des endpoints

Les cinq endpoints REST : lookup, me, batch, asn, validate. Les endpoints liés à un plan nécessitent toujours le plan correspondant sur votre clé API.

Exemple

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

Télécharger: openipapi.py

Installer / utiliser

Déposez le fichier dans votre projet et importez-le. Python 3.8+. Utilise uniquement la bibliothèque standard (urllib).

Compatibilité des endpoints

Les cinq endpoints REST : lookup, me, batch, asn, validate. Les endpoints liés à un plan nécessitent toujours le plan correspondant sur votre clé API.

Exemple

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

Télécharger: OpenIPApiClient.php

Installer / utiliser

Déposez le fichier dans votre projet et faites un require. PHP 8.0+. Utilise curl quand disponible, avec un repli stream-context. Aucun Composer requis.

Compatibilité des endpoints

Les cinq endpoints REST : lookup, me, batch, asn, validate. Les endpoints liés à un plan nécessitent toujours le plan correspondant sur votre clé API.

Exemple

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']);

Alternative HTTP directe

Aucun SDK n'est requis pour utiliser OpenIPApi. L'API est une fine couche REST + JSON — n'importe quel client HTTP fonctionne :

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

Des versions de registre de paquets pour npm, PyPI et Packagist pourront être ajoutées plus tard.