lookup_whois

Consulte l’enregistrement d’un domaine via WHOIS ou RDAP. L’outil renvoie les mêmes données que l’outil WHOIS de namebeta.com, analysées en champs, ainsi que l’enregistrement brut.

Lecture seule · Monde ouvert

Demander à votre assistant

Collez ceci dans une conversation où NameBeta est connecté :

Quel est le bureau d’enregistrement d’example.com, et quand le domaine expire-t-il ?

Votre assistant appelle lookup_whois et lit registrar et expiration.

Entrée

Champ	Type	Requis	Contraintes
domain	string	Oui	1–253 caractères; Correspond à \.

Sortie

Retourné comme structuredContent, et répété en JSON dans un bloc de contenu text.

Champ	Type	Requis	Contraintes
domain	string	Oui
status	string	Oui	Un de available, taken, unknown, forsale, reserved, tld, sld, publicsuffix
registrar	string	Non
registrar_iana_id	number	Non
expiration	string	Non	Format date-time
nameservers	string[]	Non
epp_status	string[]	Non
lifecycle	string	Non	Un de active, autorenew, redemption, pendingdelete
raw	string	Non

Fonctionnement

• domain doit être un nom de domaine complet.

• Seuls domain et status sont toujours présents. Les autres champs ne sont inclus que si l’enregistrement du registre les fournit ; pour un domaine non enregistré, vous obtenez généralement status: "available", un tableau nameservers vide et, dans raw, la réponse « no match » du registre.

• expiration est la date d’expiration fournie par le registre, au format ISO 8601, en UTC.

• epp_status contient les codes de statut EPP tels que les communique le registre, par exemple clientTransferProhibited.

• lifecycle indique l’étape du cycle de vie de l’enregistrement, surtout utile autour de l’expiration :

  lifecycle	Signification
  active	Enregistré et en cours de validité
  autorenew	Date d’expiration dépassée, en période de grâce chez le bureau d’enregistrement
  redemption	Supprimé par le bureau d’enregistrement ; le titulaire peut encore le restaurer, moyennant des frais
  pendingdelete	Sur le point d’être libéré par le registre ; il ne peut plus être restauré

• raw est l’enregistrement complet tel que le serveur l’a renvoyé. Il peut peser plusieurs kilo-octets et inclut les conditions d’utilisation du registre.

• De nombreux registres masquent les coordonnées pour des raisons de confidentialité : l’enregistrement ne contient donc ni le nom ni l’adresse e-mail du titulaire.

• Les enregistrements sont mis en cache jusqu’à 1 heure. Une nouvelle consultation du même domaine au cours de cette heure renvoie le même enregistrement, quel que soit l’auteur de la première consultation, et le registre n’est pas interrogé de nouveau. Un changement au niveau du registre — un domaine qui vient d’être enregistré, supprimé ou placé en redemption — peut donc mettre jusqu’à une heure à apparaître.

• La consultation enregistre également le status du domaine pour check_availability, qui le renvoie pendant cette même heure au lieu d’effectuer sa propre vérification.

Exemple

Arguments :

{ "domain": "example.com" }

Résultat, avec raw abrégé :

{
    "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…"
}

Quota

WHOIS a les limites les plus strictes de tous les outils.

Outil	Catégorie	Gratuit (heure / jour)	Pro (heure / jour)	Business (heure / jour)	Entreprise (heure / jour)
lookup_whois	whois	5 / 15	60 / 200	150 / 500	Illimité

Erreurs

Erreurs propres à cet outil. La page Erreurs couvre les autres cas, y compris la manière dont chaque type d’erreur parvient à votre client.

Situation	Résultat
domain ne contient pas de point	Erreur d’outil MCP error -32602: Input validation error: … (A full domain name is required)
domain n’est pas un domaine valide	Erreur d’outil Invalid domain format
La consultation WHOIS ou RDAP échoue	Erreur d’outil indiquant la cause, par exemple lorsque le registre ne répond pas à temps

Voir aussi

• check_availability : une première vérification moins coûteuse sur de nombreux noms
• lookup_dns : les enregistrements publiés par les serveurs de noms du domaine
• Outils : les cinq outils et leur articulation
• Quotas et Erreurs
• Connecter un client, si votre assistant n’affiche pas encore les outils de NameBeta