Официальные SDK OpenIPApi

Скачайте лёгкие официальные клиенты для JavaScript, Python и PHP.

Все SDK работают с одним и тем же REST API по адресу https://api.openipapi.com, аутентифицируются через заголовок X-API-Key и предоставляют одни и те же методы: lookup(ip), me(), batch(ips), asn(asn), validate(ip).

MCP-сервер — для ИИ-ассистентов

@openipapi/mcp

Дайте Claude или любому ИИ-ассистенту с поддержкой MCP прямой доступ к OpenIPApi: поиск IP, массовые проверки, оценки мошенничества и многое другое — в виде типизированных инструментов. Одна команда npx, без кода.

Включённые инструменты

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+. Без шага сборки, без сторонних зависимостей.

Совместимость с эндпоинтами

Все пять 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, если доступен, с fallback через stream-context. 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-fallback

Для использования 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 могут быть добавлены позже.