DomScan mit KI-Agenten nutzen

DomScan mit KI-Agenten nutzen

Verbinde DomScan per MCP mit Claude, ChatGPT, Cursor, VS Code, Codex und Windsurf, gib Coding-Agenten die nötigen API-Regeln an die Hand und starte mit fertigen Prompts.

MCP oder REST-API?

Viele Teams nutzen beides: MCP zum Erkunden und Prototyping im Chat oder Editor und die REST-API im Code, den der Agent schreibt. Beide verwenden denselben API-Schlüssel und dasselbe Credit-Guthaben.

Mit deinem KI-Tool verbinden

Einrichtung je Tool

Jedes Tool verbindet sich mit demselben MCP-Server unter https://domscan.net/mcp. Tools mit Anmeldeunterstützung öffnen beim ersten Ausführen einer Prüfung eine DomScan-Anmeldung. Die übrigen senden deinen API-Schlüssel im Header X-API-Key.

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

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

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

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

Diese Links und Befehle enthalten niemals deinen API-Schlüssel. Tools mit Anmeldeunterstützung verbinden sich direkt mit deinem DomScan-Konto. Um stattdessen einen Schlüssel zu verwenden, ersetze YOUR_API_KEY durch einen Schlüssel aus deinen API-Schlüsseln.

Anweisungen für Coding-Agenten

Füge dies in AGENTS.md, CLAUDE.md oder deine Regeldatei des Editors ein, damit Coding-Agenten DomScan korrekt aufrufen.

## DomScan API

Nutze DomScan (https://domscan.net) für Prüfungen zu Domainverfügbarkeit, DNS, WHOIS und RDAP, SSL, E-Mail-Sicherheit und Bewertung.

- Basis-URL: `https://domscan.net`. Die Endpunkte liegen unter `/v1`.
- Authentifizierung: sende `X-API-Key: $DOMSCAN_API_KEY` (oder `Authorization: Bearer $DOMSCAN_API_KEY`). Lies den Schlüssel aus der Umgebung. Hardcode ihn nie, logge ihn nicht und setze ihn nicht in eine URL.
- Vertrag: lies die OpenAPI-Beschreibung unter https://domscan.net/v1/openapi.json, bevor du einen Endpunkt oder Parameter wählst, und rate keine Parameternamen. Eine Zusammenfassung der Website für LLMs gibt es unter https://domscan.net/llms.txt.
- MCP: der Remote-Server ist https://domscan.net/mcp (Streamable HTTP, Anmeldung oder dieselben API-Schlüssel-Header).
- Credits: die meisten Endpunkte kosten Credits. Rufe vor Bulk- oder wiederholten Aufgaben `POST /v1/estimate` mit `method`, `path`, `query` und `body` der Anfrage auf, oder füge `dry_run=true` zu Bulk-, Compare-, Recipe- und Preis-Endpunkten hinzu. Beides ist kostenlos. Beachte die Antwort-Header `X-Credits-Charged` und `X-Credits-Remaining`.
- Bulk: prüfe bis zu 50 vollständige Domainnamen mit einer einzigen `POST /v1/status/bulk`-Anfrage, statt Einzelprüfungen in einer Schleife auszuführen.
- Wiederholungen: sende bei POST-Anfragen, die Credits kosten, einen `Idempotency-Key`-Header (zum Beispiel eine UUID). Wiederholst du dieselbe Anfrage mit demselben Schlüssel innerhalb von 24 Stunden, wird die gespeicherte Antwort ohne erneute Abbuchung zurückgegeben. Wiederhole nur, wenn `error.retryable` true ist, und warte bei 429 auf `Retry-After`.
- Fehler: jeder Fehler-Body hat die Form `{"error": {"type", "code", "message", "status", "retryable", "request_id", ...}}`. Verzweige anhand von `error.code`, etwa `INVALID_PARAMETER`, `INSUFFICIENT_CREDITS` oder `RATE_LIMITED`, nicht anhand der Meldung.
- Unbekannt heißt nicht fehlend: Ergebnisse enthalten `classification.status` mit dem Wert `present`, `absent` oder `unknown`. Behandle `unknown` als "später erneut versuchen", nie als verfügbar oder nicht vorhanden, und werte Abwesenheit nie als Beleg dafür, dass ein Name registriert oder beansprucht werden kann.
- Aktualität: Endpunkte, die aus aktuellen Daten antworten können, akzeptieren `max_age` in Sekunden (`max_age=0` fordert eine frische Prüfung an) und liefern `cache_age_s`. Das ändert die Kosten nicht.
- Kleinere Antworten: füge `fields=a,b.c` oder `compact=true` zur Query-String hinzu. Beides ändert die Kosten nicht.
- Mehr: https://domscan.net/AGENTS.md und https://domscan.net/docs.

Prompts zum Ausprobieren

Kopiere einen Prompt oder öffne ihn in deinem Assistenten. Verbinde zuerst DomScan, damit der Assistent die Prüfungen ausführen kann.

1. Prüfe mit DomScan, ob diese 50 Namen als .com-Domains verfügbar sind: [Namen einfügen]. Schätze zuerst die Credit-Kosten und zeige sie mir, bevor du etwas ausführst. Liste dann verfügbare, vergebene und unbekannte Ergebnisse getrennt auf und behandle unbekannte Ergebnisse nicht als verfügbar.

   In Claude öffnenIn ChatGPT öffnenIn Cursor öffnen

2. Prüfe mit DomScan die E-Mail-Sicherheit von example.com: SPF, DKIM, DMARC und Blacklist-Status. Erkläre jedes Problem in verständlicher Sprache und schlage den DNS-Eintrag vor, der es behebt.

   In Claude öffnenIn ChatGPT öffnenIn Cursor öffnen

3. Ich überlege, example.com zu kaufen. Prüfe mit DomScan WHOIS und Registrierungsdaten, DNS, SSL-Zertifikat, Reputation und geschätzten Wert und fasse dann die Risiken zusammen und was ich vor der Zahlung überprüfen sollte.

   In Claude öffnenIn ChatGPT öffnenIn Cursor öffnen

4. Finde mit DomScan ähnliche Domains und Typosquatting-Domains von example.com, die bereits registriert sind. Sortiere sie nach Risiko und weise auf alle hin, die eine Website oder einen Mailserver haben.

   In Claude öffnenIn ChatGPT öffnenIn Cursor öffnen

5. Füge DomScan zu diesem Projekt hinzu. Lies https://domscan.net/AGENTS.md und https://domscan.net/v1/openapi.json und schreibe dann einen kleinen typisierten Client für POST /v1/status/bulk, der DOMSCAN_API_KEY aus der Umgebung liest, einen Idempotency-Key-Header sendet und unbekannte Ergebnisse getrennt von verfügbaren hält. Ergänze Tests.

   In Claude öffnenIn ChatGPT öffnenIn Cursor öffnen

Maschinenlesbare Ressourcen

Verweise Agenten auf diese öffentlichen Dateien, statt Dokumentation in Prompts zu kopieren.

• /AGENTS.md Öffentliche Agenten-Anleitung
• /llms.txt Website-Zusammenfassung für LLMs
• /v1/openapi.json OpenAPI 3.0
• /mcp/tool-mapping.json Alte und neue MCP-Tool-Namen