lookup_whois

Fragt den Registrierungsdatensatz einer Domain über WHOIS oder RDAP ab. Das Tool liefert dieselben Daten wie das WHOIS-Tool auf namebeta.com, aufgeteilt in Felder und ergänzt um den Rohdatensatz.

Nur lesend · Offene Umgebung

Beispielanfrage an Ihren Assistenten

Fügen Sie dies in einen Chat ein, in dem NameBeta verbunden ist:

Bei welchem Registrar ist example.com registriert, und wann läuft die Domain ab?

Ihr Assistent ruft lookup_whois auf und liest registrar und expiration aus.

Eingabe

Feld	Typ	Erforderlich	Einschränkungen
domain	string	Ja	1–253 Zeichen; Entspricht \.

Ausgabe

Zurückgegeben als structuredContent, und wiederholt als JSON in einem text Inhaltsblock.

Feld	Typ	Erforderlich	Einschränkungen
domain	string	Ja
status	string	Ja	Eines von available, taken, unknown, forsale, reserved, tld, sld, publicsuffix
registrar	string	Nein
registrar_iana_id	number	Nein
expiration	string	Nein	Format date-time
nameservers	string[]	Nein
epp_status	string[]	Nein
lifecycle	string	Nein	Eines von active, autorenew, redemption, pendingdelete
raw	string	Nein

Verhalten

• domain muss ein vollständiger Domainname sein.

• Nur domain und status sind immer vorhanden. Alle anderen Felder werden nur aufgenommen, wenn der Datensatz der Registry sie enthält. Bei einer nicht registrierten Domain erhalten Sie üblicherweise status: "available", ein leeres Array nameservers und die Antwort der Registry, dass kein Treffer vorliegt, in raw.

• expiration ist das bei der Registry hinterlegte Ablaufdatum im Format ISO 8601, UTC.

• epp_status enthält die von der Registry gemeldeten EPP-Statuscodes, etwa clientTransferProhibited.

• lifecycle gibt die Phase der Registrierung an. Sie ist vor allem rund um das Ablaufdatum relevant:

  lifecycle	Bedeutung
  active	Registriert und innerhalb der Laufzeit
  autorenew	Ablaufdatum überschritten, innerhalb der Kulanzfrist des Registrars
  redemption	Vom Registrar gelöscht; der Inhaber kann die Domain noch gegen Gebühr wiederherstellen
  pendingdelete	Wird in Kürze von der Registry freigegeben; eine Wiederherstellung ist nicht mehr möglich

• raw enthält den vollständigen Datensatz, wie ihn der Server zurückgegeben hat. Er kann mehrere Kilobyte lang sein und enthält die Nutzungsbedingungen der Registry.

• Viele Registries blenden Kontaktdaten aus Datenschutzgründen aus. Der Datensatz enthält dann weder den Namen noch die E-Mail-Adresse des Domaininhabers.

• Datensätze werden bis zu eine Stunde zwischengespeichert. Eine erneute Abfrage derselben Domain innerhalb dieser Stunde liefert denselben Datensatz, unabhängig davon, wer die erste Abfrage ausgeführt hat. Die Registry wird nicht erneut abgefragt. Änderungen bei der Registry – etwa eine gerade registrierte, freigegebene oder in redemption versetzte Domain – können daher erst nach bis zu einer Stunde sichtbar werden.

• Die Abfrage speichert außerdem den status der Domain für check_availability. Dieses Tool gibt ihn während derselben Stunde zurück, statt eine eigene Prüfung durchzuführen.

Beispiel

Argumente:

{ "domain": "example.com" }

Ergebnis mit gekürztem raw:

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

Kontingent

Für WHOIS gelten die niedrigsten Limits aller Tools.

Tool	Abfragekategorie	Kostenlos (Stunde / Tag)	Pro (Stunde / Tag)	Business (Stunde / Tag)	Enterprise (Stunde / Tag)
lookup_whois	whois	5 / 15	60 / 200	150 / 500	Unbegrenzt

Fehler

Hier sind die toolspezifischen Fehler aufgeführt. Fehler beschreibt die übrigen Fälle und wie die einzelnen Fehlerarten bei Ihrem Client ankommen.

Situation	Ergebnis
domain enthält keinen Punkt	Tool-Fehler MCP error -32602: Input validation error: … (A full domain name is required)
domain ist keine gültige Domain	Tool-Fehler Invalid domain format
Die WHOIS- oder RDAP-Abfrage schlägt fehl	Tool-Fehler mit der Ursache, etwa wenn die Registry nicht rechtzeitig antwortet

Weiterführende Informationen

• check_availability: eine erste Prüfung vieler Namen mit geringerem Kontingentverbrauch
• lookup_dns: die von den Nameservern der Domain veröffentlichten Einträge
• Tools: alle fünf Tools und ihr Zusammenspiel
• Kontingente und Fehler
• Client verbinden, falls Ihr Assistent die NameBeta-Tools noch nicht anzeigt