Негізгі мазмұнға өту

Әзірлеушілер мен AI агенттеріне арналған құралдар

CloudExplorer API/MCP

CloudExplorer-дің тексерілетін деректерін қолданбалардан тікелей алыңыз немесе AI моделіңізге қолжетімді етіңіз.

REST API

REST API CloudExplorer домендері, желілері және субдомендерді сканерлеу тарихы туралы деректерді береді. GET әдістері сақталған деректерді оқиды; POST /api/v1/check_subdomain жаңа сканерлеуді кезекке қойып, Bearer токенін талап етеді.

REST API-ге қосылу

Негізгі мекенжайға HTTPS сұрауларын жіберіңіз. GET әдістері анонимді түрде қолжетімді, ортақ шектеу — секундына 30 сұрау (асқанда 429); жарамды Bearer токені бұл шектеуді айналып өтеді, ал жарамсыз Authorization тақырыбы 401 қайтарады. Қателер code және request_id өрістері бар application/problem+json түрінде қайтады. Нақты жауап схемалары интерактивті құжаттамада көрсетілген.

Негізгі мекенжай https://api.cloudexplorer.ru
REST API құжаттамасын ашу

Негізгі әдістер

GET
/api/v1/status

Деректер күйі

API күйін және оған қосылған деректер жиындарының қолжетімділігін көрсетеді.

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

Аймақ домендері

Таңдалған аймақтың белсенді домендерін курсорлық беттеумен қайтарады; келесі бет үшін сервер қайтарған cursor мәнін жіберіңіз.

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

Аймақ статистикасы

Таңдалған аймақ, күн және метрика үшін сақталған күнделікті көрсеткіштерді қайтарады.

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

Доменнің ағымдағы деректері және NS тарихы

Ағымдағы A, AAAA, MX, NS, CNAME және TXT жазбаларын, қолжетімді болғанда ағымдағы WHOIS деректерін және бақыланған NS өзгерістерінің 200 жазбасына дейін қайтарады. A және AAAA жазбаларындағы ашық IP-мекенжайлар мен MX, NS және CNAME нысандарын DNS арқылы шешу кезінде табылған мекенжайлар үшін жауап AS іздеу күйін қамтиды; сәйкестік табылса, BGP-де бақыланған бастапқы AS көрсетіледі, ал оның ағымдағы сипаттамасы қолжетімді болса, ол да беріледі. Егер домен немесе оның аймағы үшін қолдау көрсетілетін сақталған NS тарихы болмаса, ағымдағы деректер history_available=false мәнімен қайтарылады.

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

Доменнің WHOIS деректері

Домен үшін жүйелік WHOIS утилитасының ағымдағы мәтіндік жауабын қайтарады.

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

IP және бастапқы AS

Ашық IP-мекенжайдың бақыланған бастапқы BGP AS жүйесін анықтап, оның ағымдағы сипаттамасын қайтарады.

GET
/api/v1/ptr/lookup?ip={ip}

IP бойынша PTR жазбасы, AS және PTR тарихы

Ашық IPv4 мекенжайдың ағымдағы PTR жазбасын, BGP-де бақыланған бастапқы AS жүйесін және PTR өзгерістер тарихын қайтарады. PTR деректері коллектор қамту аймағына кіретін AS префикстерінің тәуліктік сканерлеуінен жиналады: IPv6 қолданылмайды, ал қамту аймағының сыртындағы мекенжай ptr.status=no_data мәнін қайтарады. absent күйі PTR жазбасының авторитетті жоқтығын білдіреді, бұл таймаут емес. limit параметрі (1-ден 500-ге дейін, әдепкі 100) тарихтағы ең жаңа жазбалар санын шектейді; history_truncated=true тарихтың қиылғанын көрсетеді.

GET
/api/v1/as/graph/dates

RouteViews лездік көшірмелерінің күндері

AS көршілерінің графын құруға арналған күнделікті RouteViews BGP лездік көшірмелерінің қолжетімді күндерін ең жаңасынан бастап қайтарады.

GET
/api/v1/as/{asn}/graph

AS көршілерінің графы

Бір RouteViews коллекторы мен лездік көшірмесінен таңдалған AS көршілерінің графын қайтарады; бұл интернеттің ғаламдық картасы емес. Аралау тереңдігі 1-ден 3-ке дейін, ал көшірме күнін date параметрімен таңдауға болады.

POST
/api/v1/check_subdomain

Субдомендерді сканерлеуді кезекке қою

Тек {"domain":"example.com"} JSON нысанын қабылдайды және жарамды Bearer токенін талап етеді; priority қоса алғанда артық өрістер қабылданбайды. domain жолы 1024 таңбадан аспауы және URL, IP не wildcard емес, DNS атауы болуы тиіс; lowercase/IDNA түріне келтіріледі. Дене өлшемі 16 KiB аспауы тиіс. Әр POST priority=10 болатын бөлек тапсырыс жасап, 202 жауабында order_id, қалыптанған domain, status="new" және priority=10 қайтарады. Жарамсыз домен үшін 422, тым үлкен дене үшін 413 қайтады.

GET
/api/v1/check_subdomain_order?order_id={order_id}

Сканерлеу тапсырысының күйін тексеру

1-ден 18446744073709551615-ке дейінгі бүтін order_id қабылдайды. Жауапта тапсырыс ID-і мен домен, status (new/worked/done/error), priority, created_at, started_at, finished_at, duration_seconds, error_type, result_id және result болады. Уақыт UTC түрінде беріледі, толтырылмаған өрістер null. status="done" кезінде result ескертулері бар ішінара сканерлеуді қоса алғанда толық JSON нәтижесін қамтиды; нәтиже сақталғанша result=null. Белгісіз ID үшін 404, тым үлкен нәтиже үшін 413, қолжетімсіз деректер үшін 503 қайтады.

GET
/api/v1/check_subdomain_history?domain={domain}

Субдомендерді сканерлеу тарихын оқу

1–1024 таңбалы domain қабылдап, DNS атауын lowercase/IDNA түріне келтіреді. domain, scanned, latest={id,scanned_at,result}, history=[{id,scanned_at,diff}] және message қайтарады. Тарих UTC уақыты мен ID бойынша жаңасынан ескісіне қарай реттеледі. Әр JSON Patch diff (add/remove/replace) latest.result нысанына тікелей қолданылып, жеке ескі нәтижені қалпына келтіреді. Бұрын сканерленбесе: 200, scanned=false, latest=null, history=[] және хабарлама. Оқу сканерлеуді бастамайды. 10 000 жазба, сақталған JSON не жауаптың 32 MiB немесе өңдеудің 128 MiB шегі асса, 413; деректер қолжетімсіз болса, 503 қайтады.

Сұрау мысалдары

Аймақ домендерінің тізімін алу

Бұл сұрау RU аймағындағы алғашқы 100 белсенді доменді қайтарады. Келесі бет үшін сервер қайтарған cursor мәнін өзгертпей жіберіңіз.

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

Доменнің ағымдағы деректері мен NS тарихын алу

Бұл сұрау ағымдағы A, AAAA, MX, NS, CNAME және TXT жазбаларын, қолжетімді болғанда ағымдағы WHOIS деректерін және бақыланған NS тарихын қайтарады. A және AAAA жазбаларындағы ашық IP-мекенжайлар мен MX, NS және CNAME нысандарын DNS арқылы шешу кезінде табылған мекенжайлар үшін жауап AS іздеу күйін қамтиды; сәйкестік табылса, BGP-де бақыланған бастапқы AS көрсетіледі, ал оның ағымдағы сипаттамасы қолжетімді болса, ол да беріледі. Егер домен немесе оның аймағы үшін қолдау көрсетілетін сақталған NS тарихы болмаса, ағымдағы деректер қолжетімді болып қалады, ал history_available мәні false болады.

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

AS көршілерінің графын алу

Бұл сұрау RouteViews лездік көшірмесінен аралау тереңдігі 2 болатын AS15169 көршілерінің графын қайтарады. Лездік көшірме күнін бөлек параметр арқылы көрсетуге болады.

curl 'https://api.cloudexplorer.ru/api/v1/as/15169/graph?depth=2'

IP бойынша PTR жазбасын және PTR тарихын алу

Бұл сұрау мекенжайдың ағымдағы PTR жазбасын, BGP-де бақыланған бастапқы AS жүйесін және PTR-дің 100-ге дейінгі ең жаңа өзгерісін қайтарады. Тарих ұзағырақ болса, limit мәнін 500-ге дейін арттырыңыз.

curl 'https://api.cloudexplorer.ru/api/v1/ptr/lookup?ip=8.8.8.8'

Сканерлеуді бастап, тапсырысты тексеру

Алдымен ортаңызда API_TOKEN мәнін орнатыңыз. POST 202 және order_id қайтарады; екінші сұрауда 123 орнына осы ID-ді қойыңыз. Қайталанған POST жаңа тапсырыс жасайды. Нәтиже status="done" болғанда пайда болады.

curl -i -X POST 'https://api.cloudexplorer.ru/api/v1/check_subdomain' -H "Authorization: Bearer ${API_TOKEN}" -H 'Content-Type: application/json' --data '{"domain":"example.com"}'
curl 'https://api.cloudexplorer.ru/api/v1/check_subdomain_order?order_id=123'

Субдомендерді сканерлеу тарихын қарау

Бұл сұрау соңғы толық нәтижені және бұрынғы күйлерді бір-бірінен тәуелсіз JSON Patch түрінде оқиды. Домен бұрын сканерленбесе, 200 жауабында scanned=false және бос тарих болады.

curl 'https://api.cloudexplorer.ru/api/v1/check_subdomain_history?domain=example.com'

MCP Server

MCP Server модельдер мен AI агенттеріне CloudExplorer құралдарын ұсынады. Модель REST сұрауларын өзі құрастырмай-ақ домендерді, аймақ статистикасын, WHOIS, NS тарихын, AS мәліметтерін және RouteViews лездік көшірмелеріндегі AS көршілерінің графтарын ала алады.

MCP сервері тек оқу режимінде жұмыс істейді және субдомендерді сканерлеу құралдары жоқ. Сканерлеу тапсырысын Bearer токенімен REST API арқылы жіберіңіз.

Қолжетімді құралдар

TOOL
getAS

IP бойынша AS іздеу

Ашық IP-мекенжайдың бақыланған бастапқы BGP AS жүйесін анықтап, оның сипаттамасын қайтарады.

TOOL
getASGraph

AS көршілерінің графын алу

Бір RouteViews коллекторы мен лездік көшірмесінен таңдалған AS көршілерінің графын қайтарады; бұл интернеттің ғаламдық картасы емес. Аралау тереңдігі 1-ден 3-ке дейін, ал көшірме күнін date параметрімен таңдауға болады.

TOOL
getASGraphDates

RouteViews лездік көшірмелерінің күндерін көрсету

AS көршілерінің графын құруға арналған күнделікті RouteViews BGP лездік көшірмелерінің қолжетімді күндерін ең жаңасынан бастап қайтарады.

TOOL
getPTR

IP бойынша PTR жазбасы, AS және PTR тарихы

Ашық IPv4 мекенжайдың ағымдағы PTR жазбасын, BGP-де бақыланған бастапқы AS жүйесін және PTR өзгерістер тарихын қайтарады: ptr.status мәні present, absent (PTR жазбасының авторитетті жоқтығы) немесе no_data (мекенжай тек коллектор AS жүйелерінің IPv4 префикстерін қамтитын тәуліктік PTR сканерлеуінің қамту аймағынан тыс) болуы мүмкін. limit параметрі (1-ден 500-ге дейін, әдепкі 100) тарихтағы ең жаңа жазбалар санын шектейді; history_truncated=true тарихтың қиылғанын көрсетеді.

TOOL
getZoneDomains

Аймақ домендері

Таңдалған аймақтың белсенді домендерін курсорлық беттеумен қайтарады; құралдың бір шақыруында 500 доменге дейін.

TOOL
getWHOIS

Доменнің WHOIS деректері

Домен үшін ағымдағы мәтіндік WHOIS жауабын алады.

TOOL
getNSHistory

Доменнің ағымдағы деректері және NS тарихы

Ағымдағы A, AAAA, MX, NS, CNAME және TXT жазбаларын, қолжетімді болғанда ағымдағы WHOIS деректерін және бақыланған NS өзгерістерінің 200 жазбасына дейін қайтарады. A және AAAA жазбаларындағы ашық IP-мекенжайлар мен MX, NS және CNAME нысандарын DNS арқылы шешу кезінде табылған мекенжайлар үшін AS іздеу күйін көрсетеді; сәйкестік табылса, BGP-де бақыланған бастапқы AS көрсетіледі, ал оның ағымдағы сипаттамасы қолжетімді болса, ол да беріледі. Егер домен немесе оның аймағы үшін қолдау көрсетілетін сақталған NS тарихы болмаса, ағымдағы деректерді history_available=false мәнімен қайтарады.

TOOL
getZoneStatistics

Аймақ статистикасы

Таңдалған аймақ, күн және метрика үшін сақталған күнделікті көрсеткіштерді қайтарады.

Модельге қосылу

CloudExplorer-ді Streamable HTTP тасымалдауын қолдайтын клиентке қашықтағы MCP сервері ретінде қосыңыз, содан кейін модельден қолжетімді құралдарды көрсетуін сұраңыз.

MCP endpoint https://mcp.cloudexplorer.ru/mcp
Тасымалдау Streamable HTTP

CloudExplorer-ді ChatGPT-ке қосу

CloudExplorer-ді ChatGPT-ке OAuth арқылы пайдаланушылық MCP қолданбасы ретінде қосыңыз. CloudExplorer бетінде кіргеннен кейін ChatGPT токен алып, оны құрал шақыруларына автоматты түрде қосады.

  1. Developer mode режимін қосыңыз

    ChatGPT ішінде Settings → Security and login бөлімін ашып, Developer mode режимін қосыңыз. Қолжетімділік тариф пен жұмыс кеңістігінің саясатына байланысты.

  2. Жаңа қолданба жасаңыз

    Plugins бөлімін ашып, «+» түймесін басыңыз және жаңа қосылым жасауды бастаңыз.

  3. MCP серверін көрсетіңіз

    Атауы мен сипаттамасын енгізіңіз, Connection: Server URL таңдаңыз, MCP серверінің мекенжайын қойыңыз және Authentication: OAuth таңдаңыз.

  4. OAuth параметрлерін баптаңыз

    Advanced OAuth settings бөлімін ашып, User-Defined OAuth Client таңдаңыз және төмендегі кестедегі мәндерді енгізіңіз. OAuth endpoints автоматты түрде анықталуы керек.

  5. Қосылымды жасаңыз

    Пайдаланушылық MCP сервері туралы ескертуді растаңыз да, Create түймесін басыңыз.

  6. Кіріп, рұқсат беріңіз

    oauth.cloudexplorer.ru бетінде «Sign in with Google» түймесі арқылы Google тіркелгісі (gmail) арқылы кіріп, «Рұқсат беру» түймесін басыңыз.

  7. Құралдарды тексеріңіз

    ChatGPT-ке оралғаннан кейін CloudExplorer картасын ашып, Actions көрсетілгенін тексеріңіз. Жаңа чат ашып, құралдар мәзірінен CloudExplorer-ді таңдап, тесттік сұрау жіберіңіз.

ChatGPT өрістерінің мәндері

Name
CloudExplorer
Description
DNS, WHOIS және AS туралы ақпарат
Connection
Server URL
Server URL
https://mcp.cloudexplorer.ru/mcp
Authentication
OAuth
Callback URL — тек тексеру үшін
https://chatgpt.com/connector_platform_oauth_redirect
Registration method
User-Defined OAuth Client
OAuth Client ID
cloudexplorer-chatgpt
OAuth Client Secret
Бос қалдырыңыз
Token endpoint auth method
none
Scope
mcp.read

Маңызды: OAuth Client Secret өрісін бос қалдырыңыз. Авторизация қосылым жасалғаннан кейін oauth.cloudexplorer.ru бетінде Google тіркелгісі (gmail) арқылы орындалады; бөлек логин мен құпиясөз қажет емес.

Автоматты түрде анықталған OAuth endpoints

ChatGPT бұл мәндерді сервер метадеректерінен алады. Тізімді тексеру үшін пайдаланыңыз; endpoints мәндерін қолмен енгізу әдетте қажет емес. Бос Registration URL және DCR/CIMD ескертулері User-Defined OAuth Client үшін қалыпты және қосылуға кедергі келтірмейді.

Auth URL
https://oauth.cloudexplorer.ru/authorize
Token URL
https://oauth.cloudexplorer.ru/token
Authorization server base
https://oauth.cloudexplorer.ru
Resource
https://mcp.cloudexplorer.ru/mcp
Registration URL
Бос қалдырыңыз

Google (gmail) арқылы авторизация

MCP-ке қолжетімділік CloudExplorer бетінде Google тіркелгісі (gmail) арқылы кіргеннен кейін беріледі.

Кіру әдісі
Sign in with Google
Кіру беті
https://oauth.cloudexplorer.ru

Қосылым жасалып, бірақ Actions көрінбесе, Plugins → CloudExplorer бөлімін ашып, Refresh түймесін басыңыз және жаңа чат бастаңыз.

OpenAI ресми нұсқаулығы

Басқа MCP клиенттеріне арналған командалар

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"
    }
  }
}

Модельге арналған сценарийлер

Аймақ домендерінің тізімі

ru аймағындағы алғашқы 100 белсенді доменді көрсет. Келесі бет бар болса, оның курсорын да қайтар.

Доменнің ағымдағы деректері және NS тарихы

beget.ru доменінің ағымдағы A, AAAA, MX, NS, CNAME және TXT жазбалары мен қолжетімді WHOIS деректерін көрсет. A және AAAA жазбаларындағы ашық IP-мекенжайлар мен MX, NS және CNAME нысандарын DNS арқылы шешу кезінде табылған мекенжайлар үшін AS іздеу күйін көрсет; сәйкестік табылса, BGP-де бақыланған бастапқы AS-ті көрсет, ал ағымдағы сипаттамасы қолжетімді болса, оны да көрсет. Содан кейін 100 NS өзгерісіне дейін қысқаша қорытындыла. history_available=false болса, сақталған тарихтың қолжетімсіз екенін анық жаз.

Аймақ статистикасы

ru аймағының соңғы қолжетімді күндегі статистикасын көрсетіп, қолданылған метриканы ата.

IP бойынша AS іздеу

8.8.8.8 IP-мекенжайының бақыланған бастапқы BGP AS жүйесін анықтап, оның сипаттамасын көрсет.

AS көршілерінің графын зерттеу

Соңғы қолжетімді RouteViews лездік көшірмесінен AS15169 көршілерінің графын аралау тереңдігін 2 етіп құрып, байланыстарды қысқаша сипатта.

IP бойынша PTR жазбасы және PTR тарихы

8.8.8.8 мекенжайының ағымдағы PTR жазбасы мен BGP-де бақыланған бастапқы AS жүйесін көрсет, содан кейін PTR-дің 100-ге дейінгі ең жаңа өзгерісін қысқаша сипатта. Егер ptr.status=no_data болса, мекенжайдың PTR сканерлеуінің қамту аймағынан тыс екенін ашық айт.