Geliştiriciler

API ve MCP sunucusu

whois.info.tr sorgularını kendi yazılımınızdan JSON API ile, yapay zekâ asistanınızdan MCP sunucusu ile kullanın. Ücretsizdir, anahtar gerekmez; adil kullanım sınırları geçerlidir.

Yapay zekâ asistanınız için MCP sunucusu

Model Context Protocol (MCP), yapay zekâ asistanlarının dış araçları güvenle çağırmasını sağlayan açık bir standarttır. Aşağıdaki adresi eklediğinizde asistanınız alan adı taraması, WHOIS ve DNS sorgusunu doğrudan whois.info.tr üzerinden yapar. Sunucu yalnızca okuma yapar; oturum ve anahtar gerektirmez.

Sunucu adresi (Streamable HTTP)

https://whois.info.tr/api/mcp.php

Claude Code

claude mcp add --transport http whois-info-tr https://whois.info.tr/api/mcp.php

JSON yapılandırması (.mcp.json, Cursor ve benzerleri)

{
  "mcpServers": {
    "whois-info-tr": {
      "type": "http",
      "url": "https://whois.info.tr/api/mcp.php"
    }
  }
}

Araçlar

  • scan_name

    Uzantısız bir adı popüler uzantılarda tarar, müsait olanları ayırır.

    Örnek soru: “duyumak adı hangi uzantılarda boş?”

  • check_availability

    Tek çağrıda 10 alan adına kadar müsaitlik ve bitiş tarihi.

    Örnek soru: “duyumak.com.tr ve duyumak.com alınabilir mi?”

  • whois_lookup

    Kayıt firması, kayıt/bitiş tarihleri, ad sunucuları, durum kodları ve veri kaynağı.

    Örnek soru: “asd.web.tr ne zaman bitiyor, kayıt firması kim?”

  • dns_lookup

    DNS kayıtları, SPF/DMARC, sunucu IP'si, SSL bitişi ve sayfa başlığı.

    Örnek soru: “asd.web.tr'nin MX ve SPF kayıtları doğru mu?”

JSON API

Tüm uç noktalar GET ile çağrılır ve JSON döndürür. Alan adı Türkçe karakterli (çiçek.com.tr) ya da tam adres (https://www.ornek.com/iletisim) olarak verilebilir; kayıt edilebilir ada indirgenir.

  • GET /api/lookup.php?domain=ornek.com.tr

    Tam sonuç: durum, tarihler, kayıt firması, ad sunucuları, EPP durumları, DNSSEC, kaynak ve ham yanıt. &fresh=1 önbelleği atlar.

  • GET /api/check.php?domain=ornek.com.tr

    Hafif sonuç: yalnızca durum, bitiş tarihi ve kaynak. Uzantı taraması için.

  • GET /api/dns.php?domain=ornek.com.tr

    DNS kayıtları ve site bilgisi: IP, ters kayıt, web sunucusu, SSL ve sayfa başlığı.

Örnek istek

curl "https://whois.info.tr/api/lookup.php?domain=ornek.com.tr"

Örnek yanıt (kısaltılmış, örnek veri)

{
  "domain": "ornek.com.tr",
  "unicodeDomain": "ornek.com.tr",
  "availability": "registered",
  "source": { "protocol": "whois", "server": "whois.trabis.gov.tr" },
  "queriedAt": "2026-10-09T09:41:07.312Z",
  "durationMs": 104,
  "cached": false,
  "dates": { "created": "2009-03-12T00:00:00Z", "expires": "2027-03-11T00:00:00Z" },
  "registrar": { "name": "Örnek Kayıt Kuruluşu A.Ş." },
  "nameservers": ["ns1.ornek-dns.com", "ns2.ornek-dns.com"],
  "statuses": ["active"],
  "dnssec": null,
  "raw": "** Domain Name: ornek.com.tr …",
  "rawFormat": "text"
}

Hata biçimi

{ "error": { "code": "RATE_LIMITED", "message": "Kısa sürede çok fazla sorgu yapıldı.", "retryAfter": 18 } }
KodHTTPAnlamı
INVALID_DOMAIN400Geçersiz alan adı
UNSUPPORTED_TLD422Uzantının herkese açık RDAP/WHOIS sunucusu yok
RATE_LIMITED429Sınır aşıldı; retryAfter saniye bekleyin
TIMEOUT504Kayıt otoritesi zamanında yanıt vermedi
UPSTREAM502Kayıt otoritesinden geçerli yanıt alınamadı
UPSTREAM_RATE_LIMITED502Kayıt otoritesi kendi sınırına ulaştı
NETWORK502Kayıt otoritesine bağlanılamadı

Sınırlar ve kullanım koşulları

  • IP başına dakikada: tam sorgu 40, önbelleksiz sorgu 10, hafif sorgu 160, DNS 40, MCP isteği 60. MCP araçları da aynı sorgu sınırlarına tabidir.
  • Sonuçlar kısa süre önbellekte tutulur: kayıtlı alan adları 3 dakika, müsait olanlar 1 dakika, DNS 5 dakika. Önbellekten gelen yanıtta "cached": true yazar.
  • .tr uzantıları TRABIS'e port 43 üzerinden sorulur; kayıt otoritesini yormamak için aynı sunucuya en fazla iki eşzamanlı bağlantı açılır.
  • Başka sitelerin tarayıcıdan doğrudan çağırması (CORS) açık değildir; API'yi sunucu tarafından çağırın.
  • Toplu veri toplama ve kazıma için kullanmayın. Yoğun ya da ticari kullanım için asd@asd.web.tr adresine yazın.