check_availability
ドメインが登録できるかを確認します。NameBeta の検索ボックスをツールにしたもので、kettlory.com のような完全なドメインはそのドメインだけを確認し、kettlory のような TLD なしの名前は、既定の TLD セットと、検索ページに表示されるドメインハックに展開して確認します。
読み取り専用 · オープンワールド
AI アシスタントに尋ねる
NameBeta を接続したチャットに、次のように貼り付けます。
brewlab でまだ取得できる TLD はどれですか?登録済みのものの中で、販売中のものはありますか?
AI アシスタントが brewlab を引数に check_availability を呼び出し、回答には 3 つの状態がすべて含まれるはずです。2026年9月29日にツールが返した結果は例に掲載しています。
入力
| フィールド | タイプ | 必須 | 制約 |
|---|---|---|---|
domains | string[] | はい | 1–20 アイテム; 各1–253 文字 |
出力
structuredContentとして返され、textコンテンツブロックでJSONとして繰り返されます。
| フィールド | タイプ | 必須 | 制約 |
|---|---|---|---|
results | object[] | はい | |
results[].domain | string | はい | |
results[].status | string | はい | available, taken, unknown, forsale, reserved, tld, sld, publicsuffixのいずれか |
results[].url | string | はい | フォーマット uri |
動作
domainsの各要素は個別に処理され、結果は入力の順に連結されます。- ドットを含む要素は 1 つのドメインとして確認され、結果は 1 件です。
- ドットを含まない要素は、TLD のない名前(ラベル)として扱われます。既定の TLD(
.com、.net、.org、.io、.aiなど)ごとに 1 件ずつ結果を返し、そのあとにke.ttのようなドメインハックが続きます。1 つのラベルからは通常 10〜20 件の結果が得られます。 - ドメイン名に使えない文字(スペース、
!、_、ドットとハイフン以外の記号)は要素を解析する前に取り除かれ、残りは小文字に変換されます。my startup!はエラーにならず、ラベルmystartupとして確認されます。実際に何が確認されたかは、各結果のdomainフィールドで確認できます。 statusは、namebeta.com の検索ボックスと同じく、DNS の委任状況をリアルタイムで確認した結果です。ただし例外が 1 つあります。いずれかのユーザーがlookup_whoisまたは namebeta.com の WHOIS ツールでドメインを検索すると、そのドメインの状態が 1 時間記録され、その間check_availabilityは改めて確認せずに記録された状態を返します。登録の前にはlookup_whoisで確認してください。urlは、価格と WHOIS を掲載した namebeta.com のドメインページを開きます。
状態の値
status | 意味 |
|---|---|
available | 今すぐ登録できます |
taken | すでに登録されています |
forsale | 登録済みですが、販売に出されています |
reserved | レジストリが保留しており、通常の登録はできません |
unknown | DNS のチェックで確定的な応答が得られませんでした。多くはネームサーバーのタイムアウトです。再試行してください |
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"
}
]
}
最初の 10 件が既定の TLD で、この順に並びます。最後の 4 件はドメインハックです。ドメインの登録や削除によって状態は変わるため、後日同じ呼び出しをすると異なる結果になることがあります。
クォータ
どのバケットを消費するかは入力によって決まります。domains の要素に TLD のない名前が 1 つでも含まれていれば、Web サイトでの検索と同じ query バケットを消費します。すべての要素が完全なドメインであれば、check バケットを消費します。
| ツール | バケット | Free (時間 / 日) | Pro (時間 / 日) | Business (時間 / 日) | Enterprise (時間 / 日) |
|---|---|---|---|---|---|
check_availability 任意のベアラベルを含む | query | 90 / 450 | 360 / 1,800 | 600 / 3,000 | 無制限 |
check_availability 完全なドメイン名のみ | check | 45 / 135 | 120 / 360 | 300 / 900 | 無制限 |
特定の名前を多数、クォータを抑えて確認したい場合は、完全なドメインとして 1 回の呼び出しに最大 20 個まとめて送ってください。
エラー
このツール固有のエラーです。それ以外のエラーと、各種エラーがクライアントにどう届くかはエラーで説明しています。
不正な要素でエラーになることはほとんどありません。動作で説明したとおり、余分な文字は先に取り除かれるためです。
| 状況 | 結果 |
|---|---|
| 無効な文字を取り除くと要素が空になる、または NameBeta が認識していない TLD の完全なドメインである | ツールエラー Invalid domain format。その呼び出しの結果は 1 件も返りません |
| 配列が空、または要素が 20 個を超える | ツールエラー MCP error -32602: Input validation error: … |
関連項目
suggest_domains:確認する名前の候補compare_prices:取得可能なドメインの価格lookup_whois:登録前の状態確認- ツール:5 つのツールすべてと、その組み合わせ方
- クォータとエラー
- AI アシスタントに NameBeta のツールがまだ表示されない場合は、クライアントを接続