본문으로 건너뛰기

check_availability

도메인을 등록할 수 있는지 확인합니다. NameBeta 검색창을 도구로 옮겨 놓은 것으로, kettlory.com 같은 전체 도메인은 그 도메인만 확인하고, kettlory 같은 TLD 없는 레이블은 기본 TLD 세트와 검색 페이지에 표시되는 도메인 핵으로 확장하여 확인합니다.

읽기 전용 · 오픈 월드

AI 어시스턴트에게 물어보기​

NameBeta가 연결된 대화에 다음을 붙여 넣으세요.

brewlab으로 아직 등록할 수 있는 TLD는 어떤 게 있어? 이미 등록된 것 중에서 판매 중인 건 뭐야?

AI 어시스턴트는 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 없는 레이블입니다. 기본 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레지스트리가 보유하고 있어 일반 등록이 불가능함
unknownDNS 확인에서 확실한 응답을 받지 못함. 대개 네임서버 시간 초과이므로 다시 시도
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 모든 베어 레이블 포함query90 / 450360 / 1,800600 / 3,000무제한
check_availability 전체 도메인 이름만 포함check45 / 135120 / 360300 / 900무제한

특정 이름을 여러 개 저렴하게 확인하려면 전체 도메인 형태로 한 번에 최대 20개씩 보내세요.

오류​

이 도구에만 해당하는 오류입니다. 나머지 오류와 각 오류가 클라이언트에 전달되는 방식은 오류에서 설명합니다.

형식이 잘못된 항목도 실패하는 경우는 드뭅니다. 동작에서 설명한 대로 불필요한 문자를 먼저 제거하기 때문입니다.

상황결과
유효하지 않은 문자를 제거하니 항목이 비었거나, NameBeta가 모르는 TLD를 가진 전체 도메인임도구 오류 Invalid domain format. 해당 호출의 결과는 반환되지 않음
빈 배열이거나 항목이 20개를 넘음도구 오류 MCP error -32602: Input validation error: …

참고 항목​