check_availability
도메인을 등록할 수 있는지 확인합니다. NameBeta 검색창을 도구로 옮겨 놓은 것으로, kettlory.com 같은 전체 도메인은 그 도메인만 확인하고, kettlory 같은 TLD 없는 레이블은 기본 TLD 세트와 검색 페이지에 표시되는 도메인 핵으로 확장하여 확인합니다.
읽기 전용 · 오픈 월드
AI 어시스턴트에게 물어보기
NameBeta가 연결된 대화에 다음을 붙여 넣으세요.
brewlab으로 아직 등록할 수 있는 TLD는 어떤 게 있어? 이미 등록된 것 중에서 판매 중인 건 뭐야?
AI 어시스턴트는 brewlab으로 check_availability를 호출하며, 답변에는 세 가지 상태가 모두 섞여 있어야 합니다. 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의 각 항목은 따로 처리되며, 결과는 입력 순서대로 이어 붙여집니다.- 점이 있는 항목은 도메인 하나로 확인하며 결과도 하나입니다.
- 점이 없는 항목은 TLD 없는 레이블입니다. 기본 TLD(
.com,.net,.org,.io,.ai등)마다 결과가 하나씩 나오고, 그 뒤에ke.tt같은 도메인 핵이 이어집니다. 레이블 하나에서 보통 10–20개의 결과가 나옵니다. - 도메인 이름에 쓸 수 없는 문자(공백,
!,_, 그리고 점과 하이픈을 제외한 문장 부호)는 항목을 해석하기 전에 제거되고, 나머지는 소문자로 바뀝니다.my startup!은 오류 없이 TLD 없는 레이블mystartup으로 확인됩니다. 실제로 확인한 도메인은 각 결과의domain필드에 표시됩니다. status는 실시간 DNS 위임 확인 결과로, namebeta.com 검색창과 같은 기준입니다. 한 가지 예외가 있습니다. 누구든lookup_whois나 namebeta.com의 WHOIS 도구로 도메인을 WHOIS 조회하면 그 도메인의 상태가 1시간 동안 기록되며, 그 1시간 동안check_availability는 다시 확인하지 않고 기록된 상태를 반환합니다. 등록하기 전에lookup_whois로 확인하세요.url은 가격과 WHOIS가 표시되는 namebeta.com의 도메인 페이지를 엽니다.
상태 값
status | 의미 |
|---|---|
available | 지금 등록할 수 있음 |
taken | 이미 등록됨 |
forsale | 등록되어 있지만 판매 중 |
reserved | 레지스트리가 보유하고 있어 일반 등록이 불가능함 |
unknown | DNS 확인에서 확실한 응답을 받지 못함. 대개 네임서버 시간 초과이므로 다시 시도 |
tld | 입력 자체가 com 같은 최상위 도메인임 |
sld | 입력이 co.uk 같은 2단계 접미사로, 등록 가능한 도메인이 아님 |
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 없는 레이블이 하나라도 있으면 웹사이트 검색과 같은 버킷인 query에서 차감되고, 모든 항목이 전체 도메인이면 check에서 차감됩니다.
| 도구 | 버킷 | 무료 (시간 / 일) | 프로 (시간 / 일) | 비즈니스 (시간 / 일) | 엔터프라이즈 (시간 / 일) |
|---|---|---|---|---|---|
check_availability 모든 베어 레이블 포함 | query | 90 / 450 | 360 / 1,800 | 600 / 3,000 | 무제한 |
check_availability 전체 도메인 이름만 포함 | check | 45 / 135 | 120 / 360 | 300 / 900 | 무제한 |
특정 이름을 여러 개 저렴하게 확인하려면 전체 도메인 형태로 한 번에 최대 20개씩 보내세요.
오류
이 도구에만 해당하는 오류입니다. 나머지 오류와 각 오류가 클라이언트에 전달되는 방식은 오류에서 설명합니다.
형식이 잘못된 항목도 실패하는 경우는 드뭅니다. 동작에서 설명한 대로 불필요한 문자를 먼저 제거하기 때문입니다.
| 상황 | 결과 |
|---|---|
| 유효하지 않은 문자를 제거하니 항목이 비었거나, NameBeta가 모르는 TLD를 가진 전체 도메인임 | 도구 오류 Invalid domain format. 해당 호출의 결과는 반환되지 않음 |
| 빈 배열이거나 항목이 20개를 넘음 | 도구 오류 MCP error -32602: Input validation error: … |
참고 항목
suggest_domains: 확인할 이름 찾기compare_prices: 등록 가능한 도메인의 가격lookup_whois: 등록하기 전에 상태 확인- 도구: 다섯 가지 도구 전체와 함께 쓰는 방법
- 할당량 및 오류
- AI 어시스턴트에 아직 NameBeta 도구가 표시되지 않는다면 클라이언트 연결