Инструменты для разработчиков и AI-агентов

API/MCP CloudExplorer

Получайте проверяемые данные CloudExplorer напрямую из приложений или предоставьте к ним доступ вашей AI-модели.

REST API

REST API предоставляет доступ только для чтения к доменам и сетевым данным CloudExplorer: спискам активных доменов, ежедневной статистике зон, WHOIS, наблюдаемой истории NS и сведениям об исходной BGP AS для публичного IP-адреса.

Подключение к REST API

Отправляйте HTTPS-запросы к базовому адресу. Интерактивная документация показывает актуальные параметры, схемы ответов и позволяет проверить методы в браузере.

Базовый адрес https://api.cloudexplorer.ru

Открыть документацию REST API

Основные методы

GET

/api/v1/status

Состояние данных

Показывает состояние API и доступность подключенных наборов данных.

GET

/api/v1/zones/{zone}/domains

Домены зоны

Возвращает активные домены выбранной зоны с курсорной пагинацией; до 5000 доменов за запрос.

GET

/api/v1/zones/{zone}/statistics

Статистика зоны

Возвращает сохраненные ежедневные показатели зоны за выбранную дату и метрику.

GET

/api/v1/domains/{domain}/ns-history

История NS

Возвращает наблюдавшиеся изменения NS-серверов активного домена; до 1000 записей за запрос.

GET

/api/v1/domains/{domain}/whois

WHOIS домена

Возвращает актуальный текстовый ответ системной утилиты WHOIS для домена.

GET

/api/v1/as/lookup?ip={ip}

IP и исходная AS

Определяет наблюдаемую исходную BGP AS публичного IP-адреса и возвращает ее текущее описание.

Примеры запросов

Получить список доменов зоны

Запрос возвращает первые 100 активных доменов зоны RU. Для следующей страницы передайте возвращенный сервером cursor без изменений.

curl 'https://api.cloudexplorer.ru/api/v1/zones/ru/domains?limit=100'

Получить историю NS домена

Запрос возвращает наблюдаемую историю изменений NS-серверов. Это история NS, а не полный журнал всех типов DNS-записей.

curl 'https://api.cloudexplorer.ru/api/v1/domains/beget.ru/ns-history?limit=100'

MCP Server

MCP Server предоставляет моделям и AI-агентам инструменты CloudExplorer. Модель может получать домены, статистику зон, WHOIS, историю NS и сведения об AS без самостоятельного формирования REST-запросов.

Сервер работает только на чтение и не изменяет данные.

Доступные инструменты

TOOL

getAS

Поиск AS по IP

Определяет наблюдаемую исходную BGP AS публичного IP-адреса и возвращает ее описание.

TOOL

getZoneDomains

Домены зоны

Возвращает активные домены выбранной зоны с курсорной пагинацией; до 500 доменов за один вызов инструмента.

TOOL

getWHOIS

WHOIS домена

Получает актуальный текстовый ответ WHOIS для домена.

TOOL

getNSHistory

История NS

Возвращает наблюдавшиеся изменения NS-серверов активного домена; до 200 записей за один вызов.

TOOL

getZoneStatistics

Статистика зоны

Возвращает сохраненные ежедневные показатели зоны за выбранную дату и метрику.

Подключение к модели

Добавьте CloudExplorer как удаленный MCP-сервер в клиент, поддерживающий транспорт Streamable HTTP, а затем попросите модель показать доступные инструменты.

MCP endpoint https://mcp.cloudexplorer.ru/mcp

Транспорт Streamable HTTP

Команды подключения

Codex

Добавьте удаленный MCP-сервер в конфигурацию Codex.

codex mcp add cloudexplorer --url https://mcp.cloudexplorer.ru/mcp

Claude Code

Добавьте сервер по HTTP в конфигурацию Claude Code.

claude mcp add --transport http cloudexplorer https://mcp.cloudexplorer.ru/mcp

Универсальный пример конфигурации

Для клиента, принимающего JSON-конфигурацию MCP, используйте этот пример. Названия полей могут отличаться — сверяйтесь с документацией вашего клиента.

{
  "mcpServers": {
    "cloudexplorer": {
      "type": "http",
      "url": "https://mcp.cloudexplorer.ru/mcp"
    }
  }
}

Сценарии для модели

Список доменов зоны

Покажи первые 100 активных доменов зоны ru. Если есть следующая страница, верни также курсор.

История NS домена

Покажи до 100 записей истории изменений NS-серверов домена beget.ru и кратко опиши, что изменилось.

Статистика зоны

Покажи статистику зоны ru за последнюю доступную дату и укажи использованную метрику.

Поиск AS по IP

Определи наблюдаемую исходную BGP AS для IP-адреса 8.8.8.8 и покажи ее описание.