> 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/es/docs/ai-agents

# Usa DomScan con agentes de IA

Consulta la documentación de la API de Usa DomScan con agentes de IA, con parámetros de solicitud, campos de respuesta, ejemplos de código y gestión de errores para integraciones con DomScan.

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?

#### Usa MCP cuando decide el asistente

Conecta el servidor MCP cuando un asistente elige qué comprobaciones ejecutar durante una conversación. Encuentra por sí solo las herramientas de DomScan, inicia sesión con tu cuenta o con una clave de API y obtiene resultados estructurados con la misma clasificación, los mismos costes en créditos y los mismos códigos de error que la API.

#### Usa REST cuando decide tu código

Llama a la API REST desde código que se ejecuta sin un asistente: tareas programadas, pipelines masivos, backends y comprobaciones de CI. Cuando un agente de programación escribe código que se incluye en tu producto, haz que llame a la API REST a partir de la descripción OpenAPI.

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

Instala el servidor MCP de DomScan con un clic o ejecuta un solo comando en tu terminal. Tu herramienta te pedirá iniciar sesión en DomScan la primera vez que ejecute una comprobación.

[Añadir a Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=domscan&config=eyJ1cmwiOiJodHRwczovL2RvbXNjYW4ubmV0L21jcCJ9)[Añadir a VS Code](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)[Añadir a VS Code Insiders](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

Claude Code con una clave de API

Codex

Inicio de sesión en Codex

`codex mcp login domscan`

### 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.

#### Claude Code

Ejecuta esto en tu terminal. Claude Code te pide iniciar sesión la primera vez que usa DomScan. Añade `--scope user` para que DomScan esté disponible en todos los proyectos.

Claude Code

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

Claude Code con una clave de API

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

#### Cursor

Usa el botón Añadir a Cursor de arriba, o añade esta entrada a `~/.cursor/mcp.json` para todos los proyectos o a `.cursor/mcp.json` para un solo proyecto.

mcp.json

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

#### VS Code

Usa el botón Añadir a VS Code de arriba, o añade esta entrada a `.vscode/mcp.json` en tu espacio de trabajo. VS Code te pide iniciar sesión cuando arranca el servidor.

.vscode/mcp.json

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

#### Codex

Añade el servidor y luego inicia sesión. Para usar una clave de API en su lugar, añade este bloque a `~/.codex/config.toml` y define `DOMSCAN_API_KEY` en tu entorno.

Codex

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

Inicio de sesión en Codex

`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

Activa el modo desarrollador en ChatGPT en Configuración, Conectores, Avanzado. Después crea un conector con esta URL y elige OAuth. Encontrarás las instrucciones paso a paso en la [página de configuración de MCP](https://domscan.net/es/mcp-domain-checker).

URL del servidor MCP

`https://domscan.net/mcp`

#### Claude

En Claude en la web o en Claude Desktop, abre Configuración, luego Conectores, y añade un conector personalizado llamado DomScan con esta URL. Claude abre un inicio de sesión de DomScan para completar el proceso.

URL del servidor MCP

`https://domscan.net/mcp`

#### Windsurf

Abre la configuración de MCP en Windsurf, consulta la configuración en bruto y añade esta entrada a `mcp_config.json`. Sustituye YOUR_API_KEY por tu clave.

mcp_config.json

```json
{
  "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](https://domscan.net/es/api-keys).

### 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.

AGENTS.md

```text
## 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.

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.

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.

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.

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.

### 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`](https://domscan.net/AGENTS.md) Guía pública para agentes
- [`/llms.txt`](https://domscan.net/llms.txt) Resumen del sitio para LLMs
- [`/v1/openapi.json`](https://domscan.net/v1/openapi.json) OpenAPI 3.0
- [`/mcp/tool-mapping.json`](https://domscan.net/mcp/tool-mapping.json) Nombres antiguos y nuevos de las herramientas MCP