lookup_whois

Consulta o registro de um domínio via WHOIS ou RDAP. Retorna os mesmos dados da ferramenta de WHOIS de namebeta.com, organizados em campos, além do registro bruto.

Somente leitura · Mundo aberto

Pergunte ao seu assistente

Cole isto em um chat com o NameBeta conectado:

Qual é o registrador de example.com e quando ele expira?

O assistente chama lookup_whois e lê registrar e expiration.

Entrada

Campo	Tipo	Obrigatório	Restrições
domain	string	Sim	1–253 caracteres; Corresponde a \.

Saída

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

Campo	Tipo	Obrigatório	Restrições
domain	string	Sim
status	string	Sim	Um de available, taken, unknown, forsale, reserved, tld, sld, publicsuffix
registrar	string	Não
registrar_iana_id	number	Não
expiration	string	Não	Formato date-time
nameservers	string[]	Não
epp_status	string[]	Não
lifecycle	string	Não	Um de active, autorenew, redemption, pendingdelete
raw	string	Não

Comportamento

• domain precisa ser um nome de domínio completo.

• Apenas domain e status estão sempre presentes. Os demais campos só aparecem quando o registro do operador de registro os fornece; para um domínio não registrado, normalmente você recebe status: "available", um array nameservers vazio e a resposta "no match" do operador de registro em raw.

• expiration é a data de expiração no operador de registro, em ISO 8601 e UTC.

• epp_status contém os códigos de status EPP tal como o operador de registro os informa, por exemplo clientTransferProhibited.

• lifecycle é a fase em que o registro se encontra, o que importa principalmente perto da expiração:

  lifecycle	Significado
  active	Registrado e dentro do prazo
  autorenew	Passou da data de expiração e está no período de carência do registrador
  redemption	Excluído pelo registrador; o titular ainda pode recuperá-lo, mediante uma taxa
  pendingdelete	Prestes a ser liberado pelo operador de registro; não pode mais ser recuperado

• raw é o registro completo, tal como o servidor o retornou. Pode ter vários kilobytes e inclui os termos de uso do operador de registro.

• Muitos operadores de registro ocultam os dados de contato por privacidade, então o registro não inclui o nome nem o e-mail do titular.

• Os registros ficam em cache por até 1 hora. Uma nova consulta do mesmo domínio dentro dessa hora retorna o mesmo registro, não importa quem fez a primeira consulta, e o operador de registro não é consultado de novo. Por isso, uma mudança no operador de registro (um domínio que acabou de ser registrado, liberado ou colocado em redemption) pode levar até uma hora para aparecer.

• A consulta também registra o status do domínio para check_availability, que o retorna durante essa mesma hora em vez de fazer a própria verificação.

Exemplo

Argumentos:

{ "domain": "example.com" }

Resultado, com raw resumido:

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

Cota

O WHOIS tem os limites mais restritos de todas as ferramentas.

Ferramenta	Categoria	Gratuito (hora / dia)	Pro (hora / dia)	Business (hora / dia)	Enterprise (hora / dia)
lookup_whois	whois	5 / 15	60 / 200	150 / 500	Ilimitado

Erros

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

Situação	Resultado
domain não tem ponto	Erro de ferramenta MCP error -32602: Input validation error: … (A full domain name is required)
domain não é um domínio válido	Erro de ferramenta Invalid domain format
A consulta WHOIS ou RDAP falha	Erro de ferramenta com o motivo, por exemplo quando o operador de registro não responde a tempo

Veja também

• check_availability: uma primeira verificação mais econômica de muitos nomes
• lookup_dns: os registros publicados pelos servidores de nomes do domínio
• Ferramentas: as cinco ferramentas e como elas se complementam
• Cotas e Erros
• Conectar um cliente, se o seu assistente ainda não lista as ferramentas do NameBeta