`lookup_whois`

WHOIS 또는 RDAP로 도메인의 등록 레코드를 조회합니다. namebeta.com의 WHOIS 도구와 같은 데이터를 필드별로 파싱하여 반환하며, 원본 레코드도 함께 제공합니다.

읽기 전용 · 오픈 월드

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

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

example.com의 레지스트라는 어디고, 언제 만료돼?

AI 어시스턴트는 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에는 clientTransferProhibited처럼 레지스트리가 보고한 EPP 상태 코드가 그대로 들어 있습니다.

lifecycle은 등록의 현재 단계이며, 만료 시점 전후에 특히 중요합니다.

`lifecycle`	의미
`active`	등록되어 있으며 등록 기간 이내
`autorenew`	만료일이 지났으며 레지스트라의 유예 기간 중
`redemption`	레지스트라가 삭제함. 소유자가 수수료를 내면 아직 복구 가능
`pendingdelete`	레지스트리가 곧 해제할 예정. 더 이상 복구 불가

raw는 서버가 반환한 레코드 전체입니다. 길이가 수 KB에 이를 수 있으며, 레지스트리의 이용 약관도 포함됩니다.
많은 레지스트리가 개인정보 보호를 위해 연락처 정보를 가리므로, 레코드에는 등록자의 이름이나 이메일이 포함되지 않습니다.
레코드는 최대 1시간 동안 캐시됩니다. 누가 처음 조회했든 1시간 이내에 같은 도메인을 다시 조회하면 같은 레코드가 반환되며, 레지스트리에 다시 질의하지 않습니다. 따라서 방금 등록되었거나, 삭제되었거나, redemption으로 넘어간 도메인처럼 레지스트리에서 일어난 변경이 반영되기까지 최대 1시간이 걸릴 수 있습니다.
조회 시 도메인의 status도 check_availability용으로 기록됩니다. check_availability는 같은 1시간 동안 자체 확인을 하지 않고 이 값을 반환합니다.

예시

인수:

{ "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: 도메인의 네임서버가 게시한 레코드
도구: 다섯 가지 도구 전체와 함께 쓰는 방법
할당량 및 오류
AI 어시스턴트에 아직 NameBeta 도구가 표시되지 않는다면 클라이언트 연결

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

입력​

출력​

동작​

예시​

할당량​

오류​

참고 항목​

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

입력

출력

동작

예시

할당량

오류

참고 항목