跳到主要内容

check_availability

查询域名能否注册。它就是以工具形式提供的 NameBeta 搜索框：完整域名（如 kettlory.com）只查询它本身；不带后缀的名称（如 kettlory）会扩展到默认的一组 TLD，以及搜索页上显示的拼词域名。

只读 · 开放世界

向助手提问​

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

brewlab 还有哪些后缀可以注册？已被注册的里面，哪些在出售？

助手会以 brewlab 调用 check_availability，回答中应同时出现三种状态——2026 年 9 月 29 日的返回结果见示例。

输入​

字段类型必需约束
domainsstring[]是1–20 项; 每个 1–253 字符

输出​

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

字段类型必需约束
resultsobject[]是
results[].domainstring是
results[].statusstring是其中之一 available, taken, unknown, forsale, reserved, tld, sld, publicsuffix
results[].urlstring是格式 uri

行为​

  • domains 中的每一项单独处理，结果按输入顺序依次拼接。
  • 带点号的项作为一个域名查询，产生一条结果。
  • 不带点号的项是不带后缀的名称。它会为每个默认 TLD（.com、.net、.org、.io、.ai 等）各产生一条结果，后面再跟上拼词域名，例如 ke.tt。一个名称通常产生 10–20 条结果。
  • 域名中不允许出现的字符——空格、!、_ 以及点号和连字符以外的其他标点——会在解析前被去掉，其余部分转为小写。my startup! 会被当作不带后缀的名称 mystartup 查询，不会报错。每条结果的 domain 字段显示实际查询的内容。
  • status 来自实时的 DNS 委派检查，与 namebeta.com 搜索框使用的依据相同。唯一的例外是：任何用户通过 lookup_whois 或 namebeta.com 上的 WHOIS 工具查询某个域名后，该域名的状态会被记录 1 小时，这一小时内 check_availability 直接返回记录的状态，不再重新检查。注册前请用 lookup_whois 确认。
  • url 打开该域名在 namebeta.com 上的页面，其中有价格和 WHOIS 信息。

状态值​

status含义
available现在即可注册
taken已被注册
forsale已被注册，但正在出售
reserved由注册局保留，不开放常规注册
unknownDNS 检查没有得到明确结果，通常是域名服务器超时；请重试
tld输入本身是一个顶级域，例如 com
sld输入是 co.uk 这样的二级后缀，而不是可注册的域名
publicsuffix输入在 Public Suffix List 中，无法作为域名注册

示例​

参数：

{ "domains": ["brewlab"] }

2026 年 9 月 29 日调用的完整结果：

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

前十条是默认 TLD，顺序固定；后四条是拼词域名。域名会不断被注册和释放，因此之后再做同样的调用，结果可能不同。

配额​

调用计入哪个配额桶取决于输入：只要 domains 中有任意一项是不带后缀的名称，调用就计入 query，与网站上的搜索相同；如果每一项都是完整域名，则计入 check。

工具桶免费 (小时 / 天)专业版 (小时 / 天)商业版 (小时 / 天)企业版 (小时 / 天)
check_availability 包含任何裸标签query90 / 450360 / 1,800600 / 3,000无限制
check_availability 仅包含完整域名check45 / 135120 / 360300 / 900无限制

如果要低成本地查询很多具体名称，把它们写成完整域名，一次最多放 20 个。

错误​

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

格式不对的输入很少会导致失败：多余字符会先被去掉，见行为。

情况结果
某一项去掉无效字符后为空，或是 TLD 不在 NameBeta 支持范围内的完整域名工具错误 Invalid domain format；整次调用不返回任何结果
数组为空，或超过 20 项工具错误 MCP error -32602: Input validation error: …

另请参阅​

最后于 更新