Utiliser DomScan avec des agents IA

Utiliser DomScan avec des agents IA

Connectez DomScan à Claude, ChatGPT, Cursor, VS Code, Codex et Windsurf via MCP, donnez aux agents de code les règles d'API dont ils ont besoin et démarrez avec des prompts prêts à l'emploi.

MCP ou API REST ?

De nombreuses équipes utilisent les deux : MCP pour explorer et prototyper dans un chat ou un éditeur, et l'API REST dans le code que l'agent écrit. Les deux utilisent la même clé API et le même solde de crédits.

Connectez votre outil d'IA

Configuration par outil

Tous les outils se connectent au même serveur MCP à l'adresse https://domscan.net/mcp. Les outils compatibles avec la connexion ouvrent une page de connexion DomScan la première fois qu'ils lancent une vérification. Les autres envoient votre clé API dans l'en-tête 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"
      }
    }
  }
}

Ces liens et ces commandes ne contiennent jamais votre clé API. Les outils compatibles avec la connexion se connectent directement à votre compte DomScan. Pour utiliser une clé à la place, remplacez YOUR_API_KEY par une clé issue de vos clés API.

Instructions pour les agents de code

Collez ceci dans AGENTS.md, CLAUDE.md ou le fichier de règles de votre éditeur pour que les agents de code appellent correctement DomScan.

## DomScan API

Utilisez DomScan (https://domscan.net) pour la disponibilité des domaines, le DNS, WHOIS et RDAP, le SSL, la sécurité des e-mails et l'évaluation.

- URL de base : `https://domscan.net`. Les endpoints sont sous `/v1`.
- Authentification : envoyez `X-API-Key: $DOMSCAN_API_KEY` (ou `Authorization: Bearer $DOMSCAN_API_KEY`). Lisez la clé depuis l'environnement. Ne la codez jamais en dur, ne la journalisez pas et ne la placez pas dans une URL.
- Contrat : lisez la description OpenAPI sur https://domscan.net/v1/openapi.json avant de choisir un endpoint ou un paramètre, et ne devinez pas les noms de paramètres. Un résumé du site pour les LLM est disponible sur https://domscan.net/llms.txt.
- MCP : le serveur distant est https://domscan.net/mcp (HTTP streamable, connexion ou mêmes en-têtes de clé API).
- Crédits : la plupart des endpoints consomment des crédits. Avant un traitement en masse ou répété, appelez `POST /v1/estimate` avec le `method`, le `path`, le `query` et le `body` de la requête, ou ajoutez `dry_run=true` aux endpoints bulk, compare, recipe et tarifs. Les deux sont gratuits. Suivez les en-têtes de réponse `X-Credits-Charged` et `X-Credits-Remaining`.
- Bulk : vérifiez jusqu'à 50 noms de domaine complets avec une seule requête `POST /v1/status/bulk` plutôt que de boucler sur des vérifications individuelles.
- Nouvelles tentatives : envoyez un en-tête `Idempotency-Key` (par exemple un UUID) sur les requêtes POST qui consomment des crédits. Renvoyer la même requête avec la même clé dans les 24 heures retourne la réponse enregistrée sans facturer à nouveau. Ne réessayez que lorsque `error.retryable` vaut true, et attendez `Retry-After` en cas de 429.
- Erreurs : chaque corps d'erreur a la forme `{"error": {"type", "code", "message", "status", "retryable", "request_id", ...}}`. Branchez votre logique sur `error.code`, par exemple `INVALID_PARAMETER`, `INSUFFICIENT_CREDITS` ou `RATE_LIMITED`, et non sur le message.
- Inconnu ne veut pas dire absent : les résultats incluent `classification.status` avec la valeur `present`, `absent` ou `unknown`. Traitez `unknown` comme "réessayer plus tard", jamais comme disponible ni comme inexistant, et ne considérez jamais l'absence comme une preuve qu'un nom peut être enregistré ou revendiqué.
- Fraîcheur : les endpoints qui peuvent répondre à partir de données récentes acceptent `max_age` en secondes (`max_age=0` demande une vérification à jour) et renvoient `cache_age_s`. Cela ne change pas le coût.
- Réponses plus légères : ajoutez `fields=a,b.c` ou `compact=true` à la query string. Aucun des deux ne change le coût.
- Pour aller plus loin : https://domscan.net/AGENTS.md et https://domscan.net/docs.

Prompts à essayer

Copiez un prompt ou ouvrez-le dans votre assistant. Connectez d'abord DomScan pour que l'assistant puisse lancer les vérifications.

1. Avec DomScan, vérifie si ces 50 noms sont disponibles en domaines .com : [collez les noms]. Estime d'abord le coût en crédits et montre-le-moi avant de lancer quoi que ce soit. Liste ensuite séparément les résultats disponibles, pris et inconnus, et ne traite pas les résultats inconnus comme disponibles.

   Ouvrir dans ClaudeOuvrir dans ChatGPTOuvrir dans Cursor

2. Utilise DomScan pour auditer la sécurité e-mail de example.com : SPF, DKIM, DMARC et statut sur les listes noires. Explique chaque problème en langage clair et propose l'enregistrement DNS qui le corrige.

   Ouvrir dans ClaudeOuvrir dans ChatGPTOuvrir dans Cursor

3. J'envisage d'acheter example.com. Utilise DomScan pour vérifier son WHOIS et ses dates d'enregistrement, son DNS, son certificat SSL, sa réputation et sa valeur estimée, puis résume les risques et ce que je devrais vérifier avant de payer.

   Ouvrir dans ClaudeOuvrir dans ChatGPTOuvrir dans Cursor

4. Utilise DomScan pour trouver les domaines similaires et de typosquatting de example.com qui sont déjà enregistrés. Classe-les par niveau de risque et signale ceux qui ont un site web ou un serveur de messagerie.

   Ouvrir dans ClaudeOuvrir dans ChatGPTOuvrir dans Cursor

5. Ajoute DomScan à ce projet. Lis https://domscan.net/AGENTS.md et https://domscan.net/v1/openapi.json, puis écris un petit client typé pour POST /v1/status/bulk qui lit DOMSCAN_API_KEY depuis l'environnement, envoie un en-tête Idempotency-Key et sépare les résultats inconnus des résultats disponibles. Ajoute des tests.

   Ouvrir dans ClaudeOuvrir dans ChatGPTOuvrir dans Cursor

Ressources lisibles par machine

Dirigez les agents vers ces fichiers publics plutôt que de copier la documentation dans les prompts.

• /AGENTS.md Guide public pour les agents
• /llms.txt Résumé du site pour les LLM
• /v1/openapi.json OpenAPI 3.0
• /mcp/tool-mapping.json Anciens et nouveaux noms des outils MCP