`check_availability`

Vérifie si des domaines peuvent être enregistrés. C’est le champ de recherche de NameBeta sous forme d’outil : un domaine complet comme kettlory.com est vérifié seul, tandis qu’un libellé sans extension comme kettlory est décliné sur l’ensemble des TLD par défaut et sur les domain hacks qu’affiche la page de recherche.

Lecture seule · Monde ouvert

Demander à votre assistant

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

Quels TLD sont encore libres pour brewlab ? Parmi ceux qui sont déjà pris, lesquels sont à vendre ?

Votre assistant appelle check_availability avec brewlab, et la réponse devrait mêler les trois états. L’exemple montre ce que l’outil a renvoyé le 29 septembre 2026.

Entrée

Champ	Type	Requis	Contraintes
`domains`	`string[]`	Oui	1–20 éléments; chaque 1–253 caractères

Sortie

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

Champ	Type	Requis	Contraintes
`results`	`object[]`	Oui
`results[].domain`	`string`	Oui
`results[].status`	`string`	Oui	Un de `available`, `taken`, `unknown`, `forsale`, `reserved`, `tld`, `sld`, `publicsuffix`
`results[].url`	`string`	Oui	Format `uri`

Fonctionnement

Chaque entrée de domains est traitée séparément, et les résultats sont concaténés dans l’ordre des entrées.
Une entrée contenant un point est vérifiée comme un seul domaine et produit un seul résultat.
Une entrée sans point est un libellé sans extension. Elle produit un résultat par TLD par défaut (.com, .net, .org, .io, .ai, etc.), suivi de domain hacks comme ke.tt. Un libellé produit généralement de 10 à 20 résultats.
Les caractères qui ne peuvent pas figurer dans un nom de domaine — espaces, !, _ et autres signes de ponctuation, à l’exception des points et des tirets — sont retirés avant l’analyse de l’entrée, et le reste est converti en minuscules. my startup! est ainsi vérifié comme le libellé sans extension mystartup, sans erreur. Le champ domain de chaque résultat indique ce qui a réellement été vérifié.
status provient d’une vérification en direct de la délégation DNS, le même signal que le champ de recherche de namebeta.com. Une exception : une consultation WHOIS d’un domaine — via lookup_whois ou l’outil WHOIS de namebeta.com, par n’importe quel utilisateur — enregistre le statut de ce domaine pendant 1 heure, et pendant cette heure check_availability renvoie le statut enregistré au lieu d’effectuer une nouvelle vérification. Utilisez lookup_whois pour confirmer le statut avant d’enregistrer un domaine.
url ouvre la page du domaine sur namebeta.com, avec les prix et les données WHOIS.

Valeurs de statut

`status`	Signification
`available`	Peut être enregistré dès maintenant
`taken`	Déjà enregistré
`forsale`	Enregistré, mais proposé à la vente
`reserved`	Réservé par le registre et non ouvert à l’enregistrement normal
`unknown`	La vérification DNS n’a pas obtenu de réponse définitive, généralement parce qu’un serveur de noms n’a pas répondu à temps ; réessayez
`tld`	L’entrée est elle-même un domaine de premier niveau, comme `com`
`sld`	L’entrée est un suffixe de deuxième niveau comme `co.uk`, et non un domaine enregistrable
`publicsuffix`	L’entrée figure dans la Public Suffix List et ne peut pas être enregistrée comme domaine

Exemple

Arguments :

{ "domains": ["brewlab"] }

Résultat complet d’un appel effectué le 29 septembre 2026 :

{
    "results": [
        {
            "domain": "brewlab.com",
            "status": "taken",
            "url": "https://namebeta.com/search/brewlab.com"
        },
        {
            "domain": "brewlab.net",
            "status": "taken",
            "url": "https://namebeta.com/search/brewlab.net"
        },
        {
            "domain": "brewlab.org",
            "status": "taken",
            "url": "https://namebeta.com/search/brewlab.org"
        },
        {
            "domain": "brewlab.info",
            "status": "available",
            "url": "https://namebeta.com/search/brewlab.info"
        },
        {
            "domain": "brewlab.io",
            "status": "taken",
            "url": "https://namebeta.com/search/brewlab.io"
        },
        {
            "domain": "brewlab.co",
            "status": "forsale",
            "url": "https://namebeta.com/search/brewlab.co"
        },
        {
            "domain": "brewlab.xyz",
            "status": "forsale",
            "url": "https://namebeta.com/search/brewlab.xyz"
        },
        {
            "domain": "brewlab.ai",
            "status": "taken",
            "url": "https://namebeta.com/search/brewlab.ai"
        },
        {
            "domain": "brewlab.online",
            "status": "available",
            "url": "https://namebeta.com/search/brewlab.online"
        },
        {
            "domain": "brewlab.dev",
            "status": "taken",
            "url": "https://namebeta.com/search/brewlab.dev"
        },
        {
            "domain": "brew.la",
            "status": "taken",
            "url": "https://namebeta.com/search/brew.la"
        },
        {
            "domain": "brw.lb",
            "status": "available",
            "url": "https://namebeta.com/search/brw.lb"
        },
        {
            "domain": "b.re",
            "status": "available",
            "url": "https://namebeta.com/search/b.re"
        },
        {
            "domain": "b.rw",
            "status": "taken",
            "url": "https://namebeta.com/search/b.rw"
        }
    ]
}

Les dix premiers résultats correspondent aux TLD par défaut, dans cet ordre ; les quatre derniers sont des domain hacks. Les statuts évoluent au gré des enregistrements et des suppressions de domaines : le même appel effectué plus tard peut donc renvoyer une répartition différente.

Quota

La catégorie de requêtes dont un appel est décompté dépend de son entrée : si au moins une entrée de domains est un libellé sans extension, l’appel est décompté de query, la même catégorie qu’une recherche sur le site ; si toutes les entrées sont des domaines complets, il est décompté de check.

Outil	Catégorie	Gratuit (heure / jour)	Pro (heure / jour)	Business (heure / jour)	Entreprise (heure / jour)
`check_availability` avec n'importe quelle étiquette nue	`query`	90 / 450	360 / 1,800	600 / 3,000	Illimité
`check_availability` avec uniquement des noms de domaine complets	`check`	45 / 135	120 / 360	300 / 900	Illimité

Pour vérifier à moindre coût de nombreux noms précis, envoyez-les sous forme de domaines complets, jusqu’à 20 par appel.

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.

Les entrées mal formées provoquent rarement une erreur : les caractères parasites sont d’abord retirés, comme décrit dans la section Fonctionnement.

Situation	Résultat
Une entrée est vide une fois les caractères invalides retirés, ou c’est un nom complet dont le TLD est inconnu de NameBeta	Erreur d’outil `Invalid domain format` ; aucun résultat n’est renvoyé pour l’appel
Tableau vide, ou plus de 20 entrées	Erreur d’outil `MCP error -32602: Input validation error: …`

Voir aussi

suggest_domains : des noms à vérifier
compare_prices : les prix des domaines disponibles
lookup_whois : confirmer un statut avant d’enregistrer un 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

Demander à votre assistant​

Entrée​

Sortie​

Fonctionnement​

Valeurs de statut​

Exemple​

Quota​

Erreurs​

Voir aussi​