`lookup_whois`

通过 WHOIS 或 RDAP 查询域名的注册记录。返回的数据与 namebeta.com 上的 WHOIS 查询工具相同，已解析为各个字段，并附带原始记录。

只读 · 开放世界

向助手提问

在已连接 NameBeta 的对话中粘贴：

example.com 的注册商是谁？什么时候到期？

助手会调用 lookup_whois，并读取 registrar 和 expiration。

输入

字段	类型	必需	约束
`domain`	`string`	是	1–253 字符; 匹配 `\.`

输出

以structuredContent形式返回，并在text内容块中重复为JSON。

字段	类型	必需	约束
`domain`	`string`	是
`status`	`string`	是	其中之一 `available`, `taken`, `unknown`, `forsale`, `reserved`, `tld`, `sld`, `publicsuffix`
`registrar`	`string`	否
`registrar_iana_id`	`number`	否
`expiration`	`string`	否	格式 `date-time`
`nameservers`	`string[]`	否
`epp_status`	`string[]`	否
`lifecycle`	`string`	否	其中之一 `active`, `autorenew`, `redemption`, `pendingdelete`
`raw`	`string`	否

行为

domain 必须是完整域名。
只有 domain 和 status 始终存在。其他字段只有在注册局的记录中提供时才会出现；对于未注册的域名，通常会得到 status: "available"、空的 nameservers 数组，以及 raw 中注册局的「no match」回复。
expiration 是注册局记录的到期日期，格式为 ISO 8601，时区为 UTC。
epp_status 包含注册局报告的 EPP 状态码，例如 clientTransferProhibited。

lifecycle 是注册所处的阶段，在到期前后最为关键：

`lifecycle`	含义
`active`	已注册，且在有效期内
`autorenew`	已过到期日，处于注册商的宽限期内
`redemption`	已被注册商删除；持有人仍可付费赎回
`pendingdelete`	即将被注册局释放；已无法赎回

raw 是服务器返回的完整记录，可能长达数 KB，并包含注册局的使用条款。
许多注册局出于隐私保护会隐去联系人信息，因此记录中不含注册人的姓名或邮箱。
记录最多缓存 1 小时。在这一小时内再次查询同一域名，无论第一次是谁查的，都会返回同一份记录，不会再次查询注册局。因此注册局侧的变化——刚注册、刚释放或刚进入 redemption 的域名——最多可能要一小时才会显示出来。
这次查询还会为 check_availability 记录该域名的 status，在同一小时内它会直接返回这个状态，而不是自己重新检查。

示例

参数：

{ "domain": "example.com" }

结果（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…"
}

配额

WHOIS 是所有工具中上限最严格的。

工具	桶	免费 (小时 / 天)	专业版 (小时 / 天)	商业版 (小时 / 天)	企业版 (小时 / 天)
`lookup_whois`	`whois`	5 / 15	60 / 200	150 / 500	无限制

错误

本工具特有的错误。其他错误以及各类错误如何返回给客户端，见错误。

情况	结果
`domain` 中没有点号	工具错误 `MCP error -32602: Input validation error: …`（`A full domain name is required`）
`domain` 不是有效的域名	工具错误 `Invalid domain format`
WHOIS 或 RDAP 查询失败	工具错误，附带原因，例如注册局未能及时响应

另请参阅

check_availability：批量初筛名称，开销更低
lookup_dns：域名服务器发布的记录
工具：全部五个工具及其配合方式
配额和错误
连接客户端：如果你的助手还没有列出 NameBeta 的工具

向助手提问​

输入​

输出​

行为​

示例​

配额​

错误​

另请参阅​

向助手提问

输入

输出

行为

示例

配额

错误

另请参阅