Pular para o conteúdo principal

check_availability

Verifica se domínios podem ser registrados. É a caixa de busca do NameBeta em forma de ferramenta: um domínio completo como kettlory.com é verificado individualmente, e um rótulo simples como kettlory é expandido para o conjunto padrão de TLDs e para os domain hacks que a página de busca mostra.

Somente leitura · Mundo aberto

Pergunte ao seu assistente​

Cole isto em um chat com o NameBeta conectado:

Quais TLDs ainda estão livres para brewlab? Dos que já estão registrados, quais estão à venda?

O assistente chama check_availability com brewlab, e a resposta deve misturar os três estados; o Exemplo mostra o que a ferramenta retornou em 29 de setembro de 2026.

Entrada​

CampoTipoObrigatórioRestrições
domainsstring[]Sim1–20 itens; cada 1–253 caracteres

Saída​

Retornado como structuredContent, e repetido como JSON em um bloco de conteúdo text.

CampoTipoObrigatórioRestrições
resultsobject[]Sim
results[].domainstringSim
results[].statusstringSimUm de available, taken, unknown, forsale, reserved, tld, sld, publicsuffix
results[].urlstringSimFormato uri

Comportamento​

  • Cada item de domains é tratado separadamente, e os resultados são concatenados na ordem da entrada.
  • Um item com ponto é verificado como um único domínio e gera um resultado.
  • Um item sem ponto é um rótulo simples. Ele gera um resultado para cada TLD padrão (.com, .net, .org, .io, .ai e outros), seguido de domain hacks como ke.tt. Um rótulo costuma gerar de 10 a 20 resultados.
  • Os caracteres que não podem aparecer em um nome de domínio (espaços, !, _ e outros sinais de pontuação, exceto pontos e hifens) são removidos antes de o item ser analisado, e o restante é convertido para minúsculas. my startup! é verificado como o rótulo simples mystartup, sem erro. O campo domain de cada resultado mostra o que foi realmente verificado.
  • status vem de uma verificação de delegação DNS em tempo real, o mesmo sinal usado pela caixa de busca de namebeta.com. Uma exceção: uma consulta WHOIS de um domínio, feita por qualquer usuário por meio de lookup_whois ou da ferramenta de WHOIS em namebeta.com, registra o status desse domínio por 1 hora, e durante essa hora check_availability retorna o status registrado em vez de verificar novamente. Use lookup_whois para confirmar antes de registrar.
  • url abre a página do domínio em namebeta.com, com preços e WHOIS.

Valores de status​

statusSignificado
availablePode ser registrado agora
takenJá está registrado
forsaleRegistrado, mas anunciado à venda
reservedReservado pelo operador de registro e indisponível para registro comum
unknownA verificação de DNS não obteve resposta definitiva, normalmente por tempo esgotado em um servidor de nomes; tente de novo
tldA entrada é o próprio domínio de nível superior, como com
sldA entrada é um sufixo de segundo nível, como co.uk, e não um domínio registrável
publicsuffixA entrada está na Public Suffix List e não pode ser registrada como domínio

Exemplo​

Argumentos:

{ "domains": ["brewlab"] }

Resultado completo de uma chamada em 29 de setembro de 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"
        }
    ]
}

Os dez primeiros resultados são os TLDs padrão, nesta ordem; os quatro últimos são domain hacks. Os status mudam à medida que domínios são registrados e liberados, então a mesma chamada feita mais tarde pode retornar uma combinação diferente.

Cota​

A categoria em que uma chamada é contabilizada depende da entrada: se algum item de domains for um rótulo simples, a chamada é contabilizada em query, a mesma categoria de uma busca no site; se todos os itens forem domínios completos, ela é contabilizada em check.

FerramentaCategoriaGratuito (hora / dia)Pro (hora / dia)Business (hora / dia)Enterprise (hora / dia)
check_availability com qualquer rótulo simplesquery90 / 450360 / 1,800600 / 3,000Ilimitado
check_availability apenas com nomes de domínio completoscheck45 / 135120 / 360300 / 900Ilimitado

Para verificar muitos nomes específicos gastando menos, envie-os como domínios completos em uma única chamada de até 20.

Erros​

Erros específicos desta ferramenta. Erros cobre os demais, incluindo como cada tipo chega ao seu cliente.

Itens malformados raramente causam falha: os caracteres indevidos são removidos antes, como descrito em Comportamento.

SituaçãoResultado
Um item fica vazio depois da remoção dos caracteres inválidos, ou é um nome completo com um TLD que o NameBeta não conheceErro de ferramenta Invalid domain format; a chamada não retorna nenhum resultado
Array vazio, ou mais de 20 itensErro de ferramenta MCP error -32602: Input validation error: …

Veja também​

Última atualização em