lookup_whois

Consulta el registro de un dominio mediante WHOIS o RDAP. Devuelve los mismos datos que la herramienta WHOIS de namebeta.com, desglosados en campos, junto con el registro sin procesar.

Solo lectura · Mundo abierto

Pregúntale a tu asistente

Pega esto en una conversación con NameBeta conectado:

¿Cuál es el registrador de example.com y cuándo vence?

Tu asistente llama a lookup_whois y lee registrar y expiration.

Entrada

Campo	Tipo	Requerido	Restricciones
domain	string	Sí	1–253 caracteres; Coincide con \.

Salida

Devuelto como structuredContent, y repetido como JSON en un bloque de contenido text.

Campo	Tipo	Requerido	Restricciones
domain	string	Sí
status	string	Sí	Uno de available, taken, unknown, forsale, reserved, tld, sld, publicsuffix
registrar	string	No
registrar_iana_id	number	No
expiration	string	No	Formato date-time
nameservers	string[]	No
epp_status	string[]	No
lifecycle	string	No	Uno de active, autorenew, redemption, pendingdelete
raw	string	No

Comportamiento

• domain debe ser un nombre de dominio completo.

• Solo domain y status aparecen siempre. Los demás campos solo se incluyen cuando el registro del operador los proporciona; para un dominio sin registrar lo habitual es obtener status: "available", un array nameservers vacío y la respuesta de «sin coincidencias» del operador de registro en raw.

• expiration es la fecha de vencimiento en el operador de registro, en formato ISO 8601 y en UTC.

• epp_status contiene los códigos de estado EPP tal como los notifica el operador de registro, por ejemplo clientTransferProhibited.

• lifecycle es la fase en la que se encuentra el registro, algo que importa sobre todo cerca del vencimiento:

  lifecycle	Significado
  active	Registrado y dentro de su periodo de vigencia
  autorenew	Ya ha pasado su fecha de vencimiento y está en el periodo de gracia del registrador
  redemption	El registrador lo ha eliminado; el titular aún puede recuperarlo, con un recargo
  pendingdelete	El operador de registro está a punto de liberarlo; ya no se puede recuperar

• raw es el registro completo tal como lo devolvió el servidor. Puede ocupar varios kilobytes e incluye las condiciones de uso del operador de registro.

• Muchos operadores de registro ocultan los datos de contacto por motivos de privacidad, por lo que el registro no incluye el nombre ni el correo electrónico del titular.

• Los registros se guardan en caché hasta 1 hora. Si se vuelve a consultar el mismo dominio dentro de esa hora, se devuelve el mismo registro, independientemente de quién hiciera la primera consulta, y no se vuelve a consultar al operador de registro. Por eso, un cambio en el operador de registro (un dominio que se acaba de registrar, que se ha liberado o que ha pasado a redemption) puede tardar hasta una hora en reflejarse.

• La consulta también guarda el status del dominio para check_availability, que lo devuelve durante esa misma hora en lugar de hacer su propia comprobación.

Ejemplo

Argumentos:

{ "domain": "example.com" }

Resultado, con raw abreviado:

{
    "domain": "example.com",
    "status": "taken",
    "registrar": "RESERVED-Internet Assigned Numbers Authority",
    "registrar_iana_id": 376,
    "expiration": "2027-08-13T04:00:00.000Z",
    "nameservers": ["ELLIOTT.NS.CLOUDFLARE.COM", "HERA.NS.CLOUDFLARE.COM"],
    "epp_status": [
        "clientDeleteProhibited",
        "clientTransferProhibited",
        "clientUpdateProhibited"
    ],
    "lifecycle": "active",
    "raw": "   Domain Name: EXAMPLE.COM\r\n   Registry Domain ID: 2336799_DOMAIN_COM-VRSN\r\n…"
}

Cuota

WHOIS tiene los límites más estrictos de todas las herramientas.

Herramienta	Categoría	Gratis (hora / día)	Pro (hora / día)	Negocios (hora / día)	Empresarial (hora / día)
lookup_whois	whois	5 / 15	60 / 200	150 / 500	Ilimitado

Errores

Errores propios de esta herramienta. Errores cubre el resto, incluido cómo llega cada tipo a tu cliente.

Situación	Resultado
domain no contiene ningún punto	Error de herramienta MCP error -32602: Input validation error: … (A full domain name is required)
domain no es un dominio válido	Error de herramienta Invalid domain format
La consulta WHOIS o RDAP falla	Error de herramienta con el motivo, por ejemplo cuando el operador de registro no responde a tiempo

Véase también

• check_availability: una primera comprobación más económica de muchos nombres
• lookup_dns: los registros que publican los servidores de nombres del dominio
• Herramientas: las cinco herramientas y cómo se combinan
• Cuotas y Errores
• Conectar un cliente, si tu asistente aún no muestra las herramientas de NameBeta