Ana içeriğe geç

Geliştiriciler ve AI ajanları için araçlar

CloudExplorer API/MCP

Doğrulanabilir CloudExplorer verilerini doğrudan uygulamalarınızdan alın veya AI modelinizin kullanımına sunun.

REST API

REST API, CloudExplorer alan adı ve ağ verileri ile alt alan adı tarama geçmişini sunar. GET metotları kayıtlı verileri okur; POST /api/v1/check_subdomain yeni bir taramayı sıraya alır ve Bearer token gerektirir.

REST API bağlantısı

Temel adrese HTTPS istekleri gönderin. GET metotları, saniyede 30 istek ortak sınırıyla anonim erişime açıktır (aşılırsa 429); geçerli bir Bearer token bu sınırı aşar, geçersiz Authorization başlığı ise 401 döndürür. Hatalar code ve request_id içeren application/problem+json olarak döner. Etkileşimli dokümantasyon tam yanıt şemalarını gösterir.

Temel adres https://api.cloudexplorer.ru
REST API dokümantasyonunu aç

Temel metotlar

GET
/api/v1/status

Veri durumu

API durumunu ve bağlı veri kümelerinin kullanılabilirliğini bildirir.

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

Bölge alan adları

Seçilen bölgedeki etkin alan adlarını imleç tabanlı sayfalama ile döndürür; sonraki sayfa için sunucunun döndürdüğü cursor değerini gönderin.

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

Bölge istatistikleri

Seçilen bölge, tarih ve metrik için saklanan günlük değerleri döndürür.

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

Güncel alan adı verileri ve NS geçmişi

Güncel A, AAAA, MX, NS, CNAME ve TXT kayıtlarını, kullanılabildiğinde güncel WHOIS verisini ve en fazla 200 gözlemlenen NS değişikliğini döndürür. A ve AAAA kayıtlarındaki genel IP adresleri ile MX, NS ve CNAME hedeflerinin çözümlenmesiyle bulunan adresler için yanıt AS sorgulama durumunu, eşleşme varsa BGP’de gözlemlenen kaynak AS bilgisini ve mevcutsa güncel AS açıklamasını içerir. Alan adı veya bölgesi için desteklenen kayıtlı bir NS geçmişi yoksa güncel veriler history_available=false ile yine döndürülür.

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

Alan adı WHOIS bilgisi

Bir alan adı için sistem WHOIS aracının güncel düz metin çıktısını döndürür.

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

IP ve kaynak AS

Genel bir IP adresini gözlemlenen BGP kaynak AS sistemiyle eşleştirir ve güncel açıklamasını döndürür.

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

IP ile PTR kaydı, kaynak AS ve PTR geçmişi

Genel bir IPv4 adresinin güncel PTR kaydını, BGP’de gözlemlenen kaynak AS sistemini ve PTR değişiklik geçmişini döndürür. PTR verileri, toplayıcı kapsamındaki AS öneklerinin günlük taramasından toplanır: IPv6 desteklenmez ve kapsam dışındaki bir adres ptr.status=no_data döndürür. absent durumu, zaman aşımı değil, PTR kaydının yetkili yokluğudur. limit parametresi (1 ile 500 arasında, varsayılan 100) en yeni geçmiş kayıtlarının sayısını sınırlar; history_truncated=true geçmişin kırpıldığını gösterir.

GET
/api/v1/as/graph/dates

RouteViews anlık görüntü tarihleri

AS komşuluk grafiği oluşturmak için kullanılabilecek günlük RouteViews BGP anlık görüntü tarihlerini en yeniden başlayarak döndürür.

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

AS komşuluk grafiği

Belirtilen AS için komşuluk grafiğini tek bir RouteViews toplayıcısı ve anlık görüntüsünden döndürür; bu, internetin küresel bir haritası değildir. Tarama derinliği 1 ile 3 arasındadır ve görüntü tarihi date parametresiyle seçilebilir.

POST
/api/v1/check_subdomain

Alt alan adı taramasını sıraya alma

Yalnızca {"domain":"example.com"} JSON gövdesini kabul eder ve geçerli bir Bearer token gerektirir; priority dahil ek alanlar reddedilir. domain dizgesi en fazla 1024 karakter olmalı ve URL, IP veya wildcard yerine bir DNS adı olmalıdır; lowercase/IDNA biçimine dönüştürülür. Gövde sınırı 16 KiB. Her POST priority=10 olan ayrı bir iş oluşturur ve 202 yanıtında order_id, normalleştirilmiş domain, status="new" ve priority=10 döndürür. Geçersiz alan adı 422, fazla büyük gövde 413 döndürür.

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

Alt alan adı tarama işini kontrol etme

1 ile 18446744073709551615 arasında bir tam sayı order_id alır. İş kimliği ve alan adıyla birlikte status (new/worked/done/error), priority, created_at, started_at, finished_at, duration_seconds, error_type, result_id ve result döndürür. Zaman damgaları UTC, boş alanlar null değerindedir. status="done" olduğunda result, uyarıları olan kısmi taramalar dahil tam JSON sonucudur; sonuç kaydedilene kadar result=null olur. Bilinmeyen ID için 404, fazla büyük sonuç için 413, erişilemeyen veri için 503 döner.

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

Alt alan adı tarama geçmişini okuma

1–1024 karakterlik domain alır ve DNS adını lowercase/IDNA biçimine dönüştürür. domain, scanned, latest={id,scanned_at,result}, history=[{id,scanned_at,diff}] ve message döndürür. Geçmiş UTC zamanı ve ID’ye göre yeniden eskiye sıralanır. Her JSON Patch diff (add/remove/replace), ayrı bir eski sonucu geri yüklemek için doğrudan latest.result üzerine uygulanır. Daha önce taranmamışsa: 200, scanned=false, latest=null, history=[] ve mesaj. Okuma tarama başlatmaz. 10.000 kayıt, saklanan JSON veya yanıt için 32 MiB ya da işleme için 128 MiB sınırı aşılırsa 413; veri erişilemezse 503 döner.

İstek örnekleri

Bir bölgedeki alan adlarını listeleme

Bu istek RU bölgesindeki ilk 100 etkin alan adını döndürür. Sonraki sayfa için sunucunun döndürdüğü cursor değerini değiştirmeden gönderin.

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

Güncel alan adı verilerini ve NS geçmişini alma

Bu istek güncel A, AAAA, MX, NS, CNAME ve TXT kayıtlarını, kullanılabildiğinde güncel WHOIS verisini ve gözlemlenen NS geçmişini döndürür. A ve AAAA kayıtlarındaki genel IP adresleri ile MX, NS ve CNAME hedeflerinin çözümlenmesiyle bulunan adresler için yanıt AS sorgulama durumunu, eşleşme varsa BGP’de gözlemlenen kaynak AS bilgisini ve mevcutsa güncel AS açıklamasını içerir. Alan adı veya bölgesi için desteklenen kayıtlı bir NS geçmişi yoksa güncel veriler kullanılabilir kalır ve history_available değeri false olur.

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

AS komşuluk grafiğini alma

Bu istek, bir RouteViews anlık görüntüsünden tarama derinliği 2 olan AS15169 komşuluk grafiğini döndürür. Anlık görüntü tarihi ayrı bir parametreyle belirtilebilir.

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

IP ile PTR kaydını ve PTR geçmişini alma

Bu istek, adresin güncel PTR kaydını, BGP’de gözlemlenen kaynak AS sistemini ve en yeni 100 PTR değişikliğini döndürür. Geçmiş daha uzunsa limit değerini 500’e kadar artırın.

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

Taramayı başlatma ve işi kontrol etme

Önce ortamınızda API_TOKEN değerini ayarlayın. POST, 202 ve order_id döndürür; ikinci istekte 123 yerine bu ID’yi yazın. Tekrarlanan POST yeni bir iş oluşturur. Sonuç status="done" olduğunda görünür.

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'

Alt alan adı tarama geçmişini görüntüleme

Bu istek en son tam sonucu ve eski durumları birbirinden bağımsız JSON Patch kayıtları olarak okur. Alan adı hiç taranmadıysa 200 yanıtı scanned=false ve boş geçmiş içerir.

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

MCP Server

MCP Server, CloudExplorer araçlarını modellere ve AI ajanlarına sunar. Model, REST isteklerini kendisi oluşturmadan alan adlarını, bölge istatistiklerini, WHOIS çıktısını, NS geçmişini, AS bilgilerini ve RouteViews anlık görüntülerindeki AS komşuluk grafiklerini alabilir.

MCP sunucusu salt okunurdur ve alt alan adı tarama araçları içermez. Taramayı Bearer token ile REST API üzerinden sıraya alın.

Kullanılabilir araçlar

TOOL
getAS

IP ile AS arama

Genel bir IP adresini gözlemlenen BGP kaynak AS sistemiyle eşleştirir ve açıklamasını döndürür.

TOOL
getASGraph

AS komşuluk grafiğini alma

Belirtilen AS için komşuluk grafiğini tek bir RouteViews toplayıcısı ve anlık görüntüsünden döndürür; bu, internetin küresel bir haritası değildir. Tarama derinliği 1 ile 3 arasındadır ve görüntü tarihi date parametresiyle seçilebilir.

TOOL
getASGraphDates

RouteViews anlık görüntü tarihlerini listeleme

AS komşuluk grafiği oluşturmak için kullanılabilecek günlük RouteViews BGP anlık görüntü tarihlerini en yeniden başlayarak döndürür.

TOOL
getPTR

IP ile PTR kaydı, kaynak AS ve PTR geçmişi

Genel bir IPv4 adresinin güncel PTR kaydını, BGP’de gözlemlenen kaynak AS sistemini ve PTR değişiklik geçmişini döndürür: ptr.status değeri present, absent (PTR kaydının yetkili yokluğu) veya no_data (adres, yalnızca toplayıcı AS sistemlerinin IPv4 öneklerini kapsayan günlük PTR taramasının kapsamı dışında) olabilir. limit parametresi (1 ile 500 arasında, varsayılan 100) en yeni geçmiş kayıtlarının sayısını sınırlar; history_truncated=true geçmişin kırpıldığını gösterir.

TOOL
getZoneDomains

Bölge alan adlarını listeleme

Seçilen bölgedeki etkin alan adlarını imleç tabanlı sayfalama ile döndürür; araç çağrısı başına en fazla 500 alan adı.

TOOL
getWHOIS

Alan adı WHOIS bilgisi

Bir alan adı için güncel düz metin WHOIS çıktısını alır.

TOOL
getNSHistory

Güncel alan adı verilerini ve NS geçmişini alma

Güncel A, AAAA, MX, NS, CNAME ve TXT kayıtlarını, kullanılabildiğinde güncel WHOIS verisini ve en fazla 200 gözlemlenen NS değişikliğini döndürür. A ve AAAA kayıtlarındaki genel IP adresleri ile MX, NS ve CNAME hedeflerinin çözümlenmesiyle bulunan adresler için AS sorgulama durumunu, eşleşme varsa BGP’de gözlemlenen kaynak AS bilgisini ve mevcutsa güncel AS açıklamasını içerir. Alan adı veya bölgesi için desteklenen kayıtlı bir NS geçmişi yoksa güncel verileri history_available=false ile döndürür.

TOOL
getZoneStatistics

Bölge istatistiklerini alma

Seçilen bölge, tarih ve metrik için saklanan günlük değerleri döndürür.

Bir modele bağlanma

CloudExplorer hizmetini Streamable HTTP aktarımını destekleyen istemcinize uzak bir MCP sunucusu olarak ekleyin, ardından modelden kullanılabilir araçları listelemesini isteyin.

MCP endpoint https://mcp.cloudexplorer.ru/mcp
Aktarım Streamable HTTP

CloudExplorer’ı ChatGPT’ye bağlama

CloudExplorer’ı OAuth kullanan özel bir MCP uygulaması olarak ChatGPT’ye ekleyin. CloudExplorer sayfasında oturum açtıktan sonra ChatGPT bir token alır ve bunu araç çağrılarına otomatik olarak ekler.

  1. Developer mode seçeneğini etkinleştirin

    ChatGPT’de Settings → Security and login bölümünü açın ve Developer mode seçeneğini etkinleştirin. Kullanılabilirlik planınıza ve çalışma alanı politikasına bağlıdır.

  2. Yeni bir uygulama oluşturun

    Plugins bölümünü açın, «+» düğmesine tıklayın ve yeni bağlantı oluşturmaya başlayın.

  3. MCP sunucusunu girin

    Ad ve açıklama girin, Connection: Server URL seçeneğini seçin, MCP sunucu adresini yapıştırın ve Authentication: OAuth seçeneğini seçin.

  4. OAuth ayarlarını yapılandırın

    Advanced OAuth settings bölümünü açın, User-Defined OAuth Client seçeneğini seçin ve aşağıdaki tablodaki değerleri girin. OAuth endpoints otomatik olarak algılanmalıdır.

  5. Bağlantıyı oluşturun

    Özel MCP sunucusu uyarısını onaylayın ve Create düğmesine tıklayın.

  6. Oturum açın ve izin verin

    oauth.cloudexplorer.ru sayfasında «Sign in with Google» düğmesiyle Google hesabınız (gmail) üzerinden oturum açın, ardından «İzin ver» düğmesine tıklayın.

  7. Araçları doğrulayın

    ChatGPT’ye döndükten sonra CloudExplorer kartını açın ve Actions listesinin göründüğünü doğrulayın. Yeni bir sohbet başlatın, araçlar menüsünden CloudExplorer’ı seçin ve bir test isteği gönderin.

ChatGPT alan değerleri

Name
CloudExplorer
Description
DNS, WHOIS ve AS bilgileri
Connection
Server URL
Server URL
https://mcp.cloudexplorer.ru/mcp
Authentication
OAuth
Callback URL — yalnızca doğrulayın
https://chatgpt.com/connector_platform_oauth_redirect
Registration method
User-Defined OAuth Client
OAuth Client ID
cloudexplorer-chatgpt
OAuth Client Secret
Boş bırakın
Token endpoint auth method
none
Scope
mcp.read

Önemli: OAuth Client Secret alanını boş bırakın. Yetkilendirme, bağlantı oluşturulduktan sonra oauth.cloudexplorer.ru sayfasında bir Google hesabı (gmail) ile yapılır; ayrı bir kullanıcı adı ve parola gerekmez.

Otomatik algılanan OAuth endpoints

ChatGPT bu değerleri sunucu meta verilerinden okur. Listeyi doğrulama için kullanın; endpoints değerlerini elle girmeniz normalde gerekmez. Boş Registration URL ve DCR/CIMD uyarıları User-Defined OAuth Client için beklenir ve bağlantıyı engellemez.

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
Boş bırakın

Google (gmail) ile yetkilendirme

MCP erişimi, CloudExplorer sayfasında bir Google hesabı (gmail) ile oturum açıldıktan sonra verilir.

Oturum açma yöntemi
Sign in with Google
Oturum açma sayfası
https://oauth.cloudexplorer.ru

Bağlantı oluşturulduğu halde Actions görünmüyorsa Plugins → CloudExplorer bölümünü açın, Refresh düğmesine tıklayın ve yeni bir sohbet başlatın.

Resmî OpenAI talimatları

Diğer MCP istemcileri için komutlar

Codex

Uzak MCP sunucusunu Codex yapılandırmanıza ekleyin.

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

Claude Code

Sunucuyu HTTP üzerinden Claude Code yapılandırmanıza ekleyin.

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

Genel yapılandırma örneği

JSON yapılandırmasını kabul eden bir MCP istemcisi için bu örneği kullanın. Alan adları farklı olabilir; istemcinizin dokümantasyonunu kontrol edin.

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

Model kullanım senaryoları

Bölge alan adlarını listeleme

ru bölgesindeki ilk 100 etkin alan adını göster. Sonraki sayfa varsa cursor değerini de döndür.

Güncel alan adı verileri ve NS geçmişi

beget.ru için güncel A, AAAA, MX, NS, CNAME ve TXT kayıtlarını ve kullanılabilir WHOIS verisini göster. A ve AAAA kayıtlarındaki genel IP adresleri ile MX, NS ve CNAME hedeflerinin çözümlenmesiyle bulunan adresler için AS sorgulama durumunu, eşleşme varsa BGP’de gözlemlenen kaynak AS bilgisini ve mevcutsa güncel AS açıklamasını belirt. Ardından en fazla 100 NS değişikliğini özetle. history_available=false ise kayıtlı geçmişin kullanılamadığını açıkça söyle.

Bölge istatistiklerini inceleme

ru bölgesinin en son kullanılabilir tarihteki istatistiklerini göster ve kullanılan metriği belirt.

IP ile AS arama

8.8.8.8 IP adresinin gözlemlenen BGP kaynak AS sistemini bul ve açıklamasını göster.

AS komşuluk grafiğini inceleme

En son kullanılabilir RouteViews anlık görüntüsünden AS15169 komşuluk grafiğini tarama derinliği 2 olacak şekilde oluştur ve bağlantıları kısaca açıkla.

IP ile PTR kaydı ve PTR geçmişi

8.8.8.8 adresinin güncel PTR kaydını ve BGP’de gözlemlenen kaynak AS sistemini göster, ardından en yeni 100 PTR değişikliğini kısaca özetle. ptr.status=no_data ise adresin PTR tarama kapsamı dışında olduğunu açıkça söyle.