> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/tr/docs/ai-agents

# DomScan'i yapay zeka ajanlarıyla kullanın

DomScan'i yapay zeka ajanlarıyla kullanın API belgelerini, istek parametrelerini, yanıt alanlarını, kod örneklerini ve DomScan entegrasyonları için hata işlemeyi inceleyin.

DomScan'i MCP üzerinden Claude, ChatGPT, Cursor, VS Code, Codex ve Windsurf ile bağlayın, kodlama ajanlarına ihtiyaç duydukları API kurallarını verin ve hazır istemlerle başlayın.

### MCP mi, REST API mi?

#### Karar asistandaysa MCP kullanın

Bir asistan, sohbet sırasında hangi kontrolleri çalıştıracağını kendisi seçiyorsa MCP sunucusunu bağlayın. DomScan araçlarını kendi başına bulur, hesabınızla veya bir API anahtarıyla giriş yapar ve API ile aynı sınıflandırmaya, kredi maliyetlerine ve hata kodlarına sahip yapılandırılmış sonuçlar alır.

#### Karar kodunuzdaysa REST kullanın

REST API'yi asistan olmadan çalışan koddan çağırın: zamanlanmış işler, toplu işlem hatları, arka uçlar ve CI kontrolleri. Bir kodlama ajanı ürününüzde yayınlanacak kod yazıyorsa, REST API'yi OpenAPI açıklamasından çağırmasını sağlayın.

Birçok ekip ikisini birlikte kullanır: bir sohbette veya düzenleyicide keşif ve prototip için MCP, ajanın yazdığı kodda ise REST API. İkisi de aynı API anahtarını ve kredi bakiyesini kullanır.

### Yapay zeka aracınıza bağlanın

DomScan MCP sunucusunu tek tıkla kurun ya da terminalinizde tek bir komut çalıştırın. Aracınız, bir kontrolü ilk kez çalıştırdığında sizden DomScan'e giriş yapmanızı ister.

[Cursor uygulamasına ekle](cursor://anysphere.cursor-deeplink/mcp/install?name=domscan&config=eyJ1cmwiOiJodHRwczovL2RvbXNjYW4ubmV0L21jcCJ9)[VS Code uygulamasına ekle](vscode:mcp/install?%7B%22name%22%3A%22domscan%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fdomscan.net%2Fmcp%22%7D)[VS Code Insiders uygulamasına ekle](vscode-insiders:mcp/install?%7B%22name%22%3A%22domscan%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fdomscan.net%2Fmcp%22%7D)

Claude Code

API anahtarıyla Claude Code

Codex

Codex girişi

`codex mcp login domscan`

### Araca göre kurulum

Her araç `https://domscan.net/mcp` adresindeki aynı MCP sunucusuna bağlanır. Girişi destekleyen araçlar, bir kontrolü ilk kez çalıştırdıklarında DomScan girişi açar. Diğerleri API anahtarınızı X-API-Key başlığıyla gönderir.

#### Claude Code

Bunu terminalinizde çalıştırın. Claude Code, DomScan'i ilk kullandığında sizden giriş yapmanızı ister. DomScan'i her projede kullanılabilir yapmak için `--scope user` ekleyin.

Claude Code

`claude mcp add --transport http domscan https://domscan.net/mcp`

API anahtarıyla Claude Code

`claude mcp add --transport http domscan https://domscan.net/mcp --header "X-API-Key: YOUR_API_KEY"`

#### Cursor

Yukarıdaki Add to Cursor düğmesini kullanın veya bu girdiyi tüm projeler için `~/.cursor/mcp.json` dosyasına, tek bir proje için `.cursor/mcp.json` dosyasına ekleyin.

mcp.json

```json
{
  "mcpServers": {
    "domscan": {
      "url": "https://domscan.net/mcp"
    }
  }
}
```

#### VS Code

Yukarıdaki Add to VS Code düğmesini kullanın veya bu girdiyi çalışma alanınızdaki `.vscode/mcp.json` dosyasına ekleyin. VS Code, sunucu başladığında sizden giriş yapmanızı ister.

.vscode/mcp.json

```json
{
  "servers": {
    "domscan": {
      "type": "http",
      "url": "https://domscan.net/mcp"
    }
  }
}
```

#### Codex

Sunucuyu ekleyin, ardından giriş yapın. Bunun yerine bir API anahtarı kullanmak için bu bloğu `~/.codex/config.toml` dosyasına ekleyin ve ortamınızda `DOMSCAN_API_KEY` değişkenini ayarlayın.

Codex

`codex mcp add domscan --url https://domscan.net/mcp`

Codex girişi

`codex mcp login domscan`

~/.codex/config.toml

```json
[mcp_servers.domscan]
url = "https://domscan.net/mcp"
env_http_headers = { "X-API-Key" = "DOMSCAN_API_KEY" }
```

#### ChatGPT

ChatGPT'de Settings, Connectors, Advanced altından geliştirici modunu açın. Ardından bu URL ile bir bağlayıcı oluşturun ve OAuth'u seçin. Adım adım yönergeler [MCP kurulum sayfası](https://domscan.net/tr/mcp-domain-checker) sayfasındadır.

MCP sunucu URL'si

`https://domscan.net/mcp`

#### Claude

Web üzerindeki Claude'da veya Claude Desktop'ta Settings, ardından Connectors bölümünü açın ve bu URL ile DomScan adında özel bir bağlayıcı ekleyin. Claude, işlemi tamamlamak için bir DomScan girişi açar.

MCP sunucu URL'si

`https://domscan.net/mcp`

#### Windsurf

Windsurf'te MCP ayarlarını açın, ham yapılandırmayı görüntüleyin ve bu girdiyi `mcp_config.json` dosyasına ekleyin. YOUR_API_KEY yerine kendi anahtarınızı yazın.

mcp_config.json

```json
{
  "mcpServers": {
    "domscan": {
      "serverUrl": "https://domscan.net/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}
```

Bu bağlantılar ve komutlar API anahtarınızı hiçbir zaman içermez. Girişi destekleyen araçlar doğrudan DomScan hesabınıza bağlanır. Bunun yerine bir anahtar kullanmak için `YOUR_API_KEY` değerini [API anahtarlarınız](https://domscan.net/tr/api-keys) bölümündeki bir anahtarla değiştirin.

### Kodlama ajanları için yönergeler

Kodlama ajanlarının DomScan'i doğru çağırması için bunu AGENTS.md, CLAUDE.md veya düzenleyicinizin kural dosyasına yapıştırın.

AGENTS.md

```text
## DomScan API

Alan adı uygunluğu, DNS, WHOIS ve RDAP, SSL, e-posta güvenliği ve değerleme kontrolleri için DomScan'i (https://domscan.net) kullan.

- Temel URL: `https://domscan.net`. Endpoint'ler `/v1` altındadır.
- Kimlik doğrulama: `X-API-Key: $DOMSCAN_API_KEY` gönder (veya `Authorization: Bearer $DOMSCAN_API_KEY`). Anahtarı ortamdan oku. Asla koda gömme, loglama ve URL içine koyma.
- Sözleşme: bir endpoint veya parametre seçmeden önce https://domscan.net/v1/openapi.json adresindeki OpenAPI açıklamasını oku ve parametre adlarını tahmin etme. LLM'ler için site özeti https://domscan.net/llms.txt adresindedir.
- MCP: uzak sunucu https://domscan.net/mcp adresindedir (streamable HTTP, giriş veya aynı API anahtarı başlıkları).
- Krediler: çoğu endpoint kredi harcar. Toplu veya tekrarlı işlerden önce isteğin `method`, `path`, `query` ve `body` alanlarıyla `POST /v1/estimate` çağır ya da toplu, karşılaştırma, recipe ve fiyat endpoint'lerine `dry_run=true` ekle. İkisi de ücretsizdir. `X-Credits-Charged` ve `X-Credits-Remaining` yanıt başlıklarını izle.
- Toplu: tek tek kontroller üzerinde döngü kurmak yerine tek bir `POST /v1/status/bulk` isteğiyle 50 tam alan adına kadar kontrol et.
- Yeniden denemeler: kredi harcayan POST isteklerinde bir `Idempotency-Key` başlığı (örneğin bir UUID) gönder. Aynı isteği aynı anahtarla 24 saat içinde yeniden denemek, tekrar ücretlendirmeden saklanan yanıtı döndürür. Yalnızca `error.retryable` true ise yeniden dene ve 429 durumunda `Retry-After` süresini bekle.
- Hatalar: her hata gövdesi `{"error": {"type", "code", "message", "status", "retryable", "request_id", ...}}` biçimindedir. Mesaja göre değil, `INVALID_PARAMETER`, `INSUFFICIENT_CREDITS` veya `RATE_LIMITED` gibi `error.code` değerine göre dallan.
- Bilinmeyen, yok anlamına gelmez: sonuçlar `present`, `absent` veya `unknown` değerlerinden birini taşıyan `classification.status` içerir. `unknown` değerini "daha sonra tekrar dene" olarak ele al, asla uygun ya da eksik olarak yorumlama ve yokluğu bir adın kaydedilebileceğinin veya sahiplenilebileceğinin kanıtı sayma.
- Güncellik: yakın tarihli verilerden yanıt verebilen endpoint'ler saniye cinsinden `max_age` kabul eder (`max_age=0` yeni bir kontrol ister) ve `cache_age_s` döndürür. Maliyeti değiştirmez.
- Daha küçük yanıtlar: sorgu dizesine `fields=a,b.c` veya `compact=true` ekle. İkisi de maliyeti değiştirmez.
- Daha fazlası: https://domscan.net/AGENTS.md ve https://domscan.net/docs.
```

### Denenecek istemler

Bir istemi kopyalayın veya asistanınızda açın. Asistanın kontrolleri çalıştırabilmesi için önce DomScan'i bağlayın.

1.

DomScan'i kullanarak bu 50 adın .com alan adı olarak uygun olup olmadığını kontrol et: [adları yapıştır]. Önce kredi maliyetini tahmin et ve herhangi bir şey çalıştırmadan önce bana göster. Ardından uygun, alınmış ve bilinmeyen sonuçları ayrı ayrı listele ve bilinmeyen sonuçları uygun sayma.

2.

DomScan'i kullanarak example.com için e-posta güvenliğini denetle: SPF, DKIM, DMARC ve kara liste durumu. Her sorunu sade bir dille açıkla ve onu çözecek DNS kaydını öner.

3.

example.com alan adını satın almayı düşünüyorum. DomScan'i kullanarak WHOIS ve kayıt tarihlerini, DNS'ini, SSL sertifikasını, itibarını ve tahmini değerini kontrol et; ardından riskleri ve ödeme yapmadan önce neleri doğrulamam gerektiğini özetle.

4.

DomScan'i kullanarak example.com'a benzeyen ve typosquatting amaçlı, hâlihazırda kayıtlı alan adlarını bul. Bunları riske göre sırala ve web sitesi ya da posta sunucusu olanları belirt.

5.

DomScan'i bu projeye ekle. https://domscan.net/AGENTS.md ve https://domscan.net/v1/openapi.json adreslerini oku, ardından POST /v1/status/bulk için DOMSCAN_API_KEY değerini ortamdan okuyan, bir Idempotency-Key başlığı gönderen ve bilinmeyen sonuçları uygun sonuçlardan ayrı tutan küçük, tür tanımlı bir istemci yaz. Testleri ekle.

### Makine tarafından okunabilir kaynaklar

Belgeleri istemlere kopyalamak yerine ajanları bu herkese açık dosyalara yönlendirin.

- [`/AGENTS.md`](https://domscan.net/AGENTS.md) Herkese açık ajan rehberi
- [`/llms.txt`](https://domscan.net/llms.txt) LLM'ler için site özeti
- [`/v1/openapi.json`](https://domscan.net/v1/openapi.json) OpenAPI 3.0
- [`/mcp/tool-mapping.json`](https://domscan.net/mcp/tool-mapping.json) Eski ve yeni MCP araç adları