Usa DomScan con agentes de IA

Usa DomScan con agentes de IA

Conecta DomScan a Claude, ChatGPT, Cursor, VS Code, Codex y Windsurf mediante MCP, dale a los agentes de programación las reglas de la API que necesitan y empieza con prompts listos para usar.

¿MCP o API REST?

Muchos equipos usan ambos: MCP para explorar y crear prototipos en un chat o en el editor, y la API REST en el código que escribe el agente. Ambos usan la misma clave de API y el mismo saldo de créditos.

Conecta tu herramienta de IA

Configuración por herramienta

Todas las herramientas se conectan al mismo servidor MCP en https://domscan.net/mcp. Las que admiten inicio de sesión abren un acceso a DomScan la primera vez que ejecutan una comprobación. Las demás envían tu clave de API en el encabezado 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"
      }
    }
  }
}

Estos enlaces y comandos nunca incluyen tu clave de API. Las herramientas que admiten inicio de sesión se conectan directamente a tu cuenta de DomScan. Para usar una clave, sustituye YOUR_API_KEY por una clave de tus claves de API.

Instrucciones para agentes de programación

Pega esto en AGENTS.md, CLAUDE.md o en tu archivo de reglas del editor para que los agentes de programación llamen a DomScan correctamente.

## DomScan API

Usa DomScan (https://domscan.net) para comprobar disponibilidad de dominios, DNS, WHOIS y RDAP, SSL, seguridad del correo y valoración.

- URL base: `https://domscan.net`. Los endpoints están bajo `/v1`.
- Autenticación: envía `X-API-Key: $DOMSCAN_API_KEY` (o `Authorization: Bearer $DOMSCAN_API_KEY`). Lee la clave del entorno. No la escribas nunca en el código, no la registres en logs ni la pongas en una URL.
- Contrato: lee la descripción OpenAPI en https://domscan.net/v1/openapi.json antes de elegir un endpoint o un parámetro, y no adivines los nombres de los parámetros. Hay un resumen del sitio para LLMs en https://domscan.net/llms.txt.
- MCP: el servidor remoto es https://domscan.net/mcp (HTTP streamable, inicio de sesión o los mismos encabezados con la clave de API).
- Créditos: la mayoría de los endpoints cuestan créditos. Antes de trabajos masivos o repetidos, llama a `POST /v1/estimate` con el `method`, el `path`, el `query` y el `body` de la petición, o añade `dry_run=true` a los endpoints de bulk, compare, recipe y precios. Ambas opciones son gratuitas. Sigue los encabezados de respuesta `X-Credits-Charged` y `X-Credits-Remaining`.
- Bulk: comprueba hasta 50 nombres de dominio completos con una sola petición `POST /v1/status/bulk` en lugar de repetir comprobaciones individuales en un bucle.
- Reintentos: envía un encabezado `Idempotency-Key` (por ejemplo, un UUID) en las peticiones POST que cobran créditos. Si repites la misma petición con la misma clave en 24 horas, se devuelve la respuesta almacenada sin volver a cobrar. Reintenta solo cuando `error.retryable` sea true y espera el valor de `Retry-After` en un 429.
- Errores: todo cuerpo de error es `{"error": {"type", "code", "message", "status", "retryable", "request_id", ...}}`. Decide según `error.code`, como `INVALID_PARAMETER`, `INSUFFICIENT_CREDITS` o `RATE_LIMITED`, no según el mensaje.
- Desconocido no es ausente: los resultados incluyen `classification.status` con valor `present`, `absent` o `unknown`. Trata `unknown` como "vuelve a intentarlo más tarde", nunca como disponible ni como inexistente, y nunca tomes la ausencia como prueba de que un nombre se pueda registrar o reclamar.
- Frescura: los endpoints que pueden responder con datos recientes aceptan `max_age` en segundos (`max_age=0` pide una comprobación nueva) y devuelven `cache_age_s`. No cambia el coste.
- Respuestas más pequeñas: añade `fields=a,b.c` o `compact=true` a la query string. Ninguna de las dos cambia el coste.
- Más información: https://domscan.net/AGENTS.md y https://domscan.net/docs.

Prompts para probar

Copia un prompt o ábrelo en tu asistente. Conecta DomScan primero para que el asistente pueda ejecutar las comprobaciones.

1. Con DomScan, comprueba si estos 50 nombres están disponibles como dominios .com: [pega los nombres]. Primero estima el coste en créditos y muéstramelo antes de ejecutar nada. Después enumera por separado los resultados disponibles, ocupados y desconocidos, y no trates los resultados desconocidos como disponibles.

   Abrir en ClaudeAbrir en ChatGPTAbrir en Cursor

2. Usa DomScan para auditar la seguridad del correo de example.com: SPF, DKIM, DMARC y estado en listas negras. Explica cada problema en lenguaje sencillo y sugiere el registro DNS que lo soluciona.

   Abrir en ClaudeAbrir en ChatGPTAbrir en Cursor

3. Estoy pensando en comprar example.com. Usa DomScan para revisar su WHOIS y sus fechas de registro, el DNS, el certificado SSL, la reputación y el valor estimado, y luego resume los riesgos y lo que debería verificar antes de pagar.

   Abrir en ClaudeAbrir en ChatGPTAbrir en Cursor

4. Usa DomScan para encontrar dominios similares y de typosquatting de example.com que ya estén registrados. Ordénalos por riesgo y señala los que tengan sitio web o servidor de correo.

   Abrir en ClaudeAbrir en ChatGPTAbrir en Cursor

5. Añade DomScan a este proyecto. Lee https://domscan.net/AGENTS.md y https://domscan.net/v1/openapi.json, y luego escribe un pequeño cliente tipado para POST /v1/status/bulk que lea DOMSCAN_API_KEY del entorno, envíe un encabezado Idempotency-Key y mantenga los resultados desconocidos separados de los disponibles. Añade tests.

   Abrir en ClaudeAbrir en ChatGPTAbrir en Cursor

Recursos legibles por máquinas

Dirige a los agentes a estos archivos públicos en lugar de copiar la documentación en los prompts.

• /AGENTS.md Guía pública para agentes
• /llms.txt Resumen del sitio para LLMs
• /v1/openapi.json OpenAPI 3.0
• /mcp/tool-mapping.json Nombres antiguos y nuevos de las herramientas MCP