Geliştiriciler
API ve MCP sunucusu
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.phpClaude Code
claude mcp add --transport http whois-info-tr https://whois.info.tr/api/mcp.phpJSON 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_nameUzantısız bir adı popüler uzantılarda tarar, müsait olanları ayırır.
Örnek soru: “duyumak adı hangi uzantılarda boş?”
check_availabilityTek ç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_lookupKayı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_lookupDNS 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.trTam 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.trHafif sonuç: yalnızca durum, bitiş tarihi ve kaynak. Uzantı taraması için.
GET /api/dns.php?domain=ornek.com.trDNS 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 } }| Kod | HTTP | Anlamı |
|---|---|---|
| INVALID_DOMAIN | 400 | Geçersiz alan adı |
| UNSUPPORTED_TLD | 422 | Uzantının herkese açık RDAP/WHOIS sunucusu yok |
| RATE_LIMITED | 429 | Sınır aşıldı; retryAfter saniye bekleyin |
| TIMEOUT | 504 | Kayıt otoritesi zamanında yanıt vermedi |
| UPSTREAM | 502 | Kayıt otoritesinden geçerli yanıt alınamadı |
| UPSTREAM_RATE_LIMITED | 502 | Kayıt otoritesi kendi sınırına ulaştı |
| NETWORK | 502 | Kayı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": trueyazar. - .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.