kr-whois-lookup

name	kr-whois-lookup
description	공공데이터포털 WHOIS 도메인/IP 정보 API를 k-skill-proxy 경유로 호출해 .kr/.한국 도메인, IP 주소, AS 번호의 공개 등록정보를 조회한다. 조회 전용.
license	MIT
metadata	{"category":"security","locale":"ko-KR","phase":"v1"}

KR WHOIS Lookup

What this skill does

공공데이터포털의 WHOIS 도메인/IP 정보 API(data.go.kr 15094277)의 공식 endpoint를 k-skill-proxy 경유로 호출한다.

지원 범위는 .kr/.한국 도메인, IPv4/IPv6 주소, AS1234 형식의 AS 번호다. 등록기관, 등록/할당일, 상태, 네임서버, 네트워크 범위, 국가 코드 등 공개 가능한 필드를 원문 기반으로 요약한다.

When to use

• ".kr 도메인 WHOIS 조회해줘"
• "kisa.or.kr 등록기관과 만료일 확인해줘"
• ".한국 도메인 네임서버 확인해줘"
• "202.30.50.51 IP WHOIS 조회해줘"
• "AS9700 할당 기관 확인해줘"

When not to use

• .com, .net 등 해외 gTLD WHOIS 조회
• 개인정보 비공개 우회, 대량 수집, 연락처 자동 추출
• 역방향 DNS, 지리 좌표, 위협 인텔리전스, 포트 스캔처럼 WHOIS 공개 등록정보가 아닌 조회

Prerequisites

• 인터넷 연결
• hosted/self-host k-skill-proxy의 /v1/kr-whois/domain, /v1/kr-whois/ip, /v1/kr-whois/as route 접근 가능

Credential requirements

• 사용자 측 필수 시크릿 없음.
• KSKILL_PROXY_BASE_URL — self-host·별도 프록시를 쓸 때만 설정. 비우면 기본 hosted https://k-skill-proxy.nomadamas.org 를 사용한다.
• DATA_GO_KR_API_KEY 는 프록시 운영 서버 환경에만 둔다. 공공데이터포털 WHOIS 도메인/IP 정보 API(15094277) 활용신청이 승인돼 있어야 한다.

키 발급: https://www.data.go.kr/data/15094277/openapi.do 에서 활용신청 후 공공데이터포털 마이페이지의 일반 인증키를 확인한다. 포털 이용 가이드는 https://www.data.go.kr/ugs/selectPublicDataUseGuideView.do 를 참고한다.

Inputs

• 도메인: domain, query, 또는 q에 조회할 .kr/.한국 도메인
• IP: ip, query, 또는 q에 유효한 IPv4/IPv6 주소
• AS: asn, as, query, 또는 q에 AS9700 같은 AS<digits> 형식의 AS 번호

Workflow

1. Classify and normalize the query

도메인 URL은 scheme/path를 제거하고 .kr/.한국 도메인만 남긴다. IP는 유효한 IPv4/IPv6인지 검증한다. AS 번호는 대소문자와 공백을 정리해 AS<digits> 형식으로 만든다.

2. Query through the proxy

BASE="${KSKILL_PROXY_BASE_URL:-https://k-skill-proxy.nomadamas.org}"
curl -fsS --get "$BASE/v1/kr-whois/domain" \
  --data-urlencode "domain=kisa.or.kr"

curl -fsS --get "$BASE/v1/kr-whois/ip" \
  --data-urlencode "ip=202.30.50.51"

curl -fsS --get "$BASE/v1/kr-whois/as" \
  --data-urlencode "asn=AS9700"

3. Summarize public fields only

응답에서 다음 필드를 우선 확인한다.

• result_code, result_msg: upstream 결과
• 공통: query, queryType, result_code, result_msg
• 도메인: name, regName, agency, agency_url
• regDate, endDate, lastUpdatedDate
• domainStatus, dnssec
• ns1, ns2, ip1, ip2 등 네임서버/주소 필드
• IP/AS: 할당 기관, 네트워크 범위, 국가 코드, 할당일과 공개 연락처 필드

개인 연락처로 보이는 값은 그대로 확산하지 말고, 공개 API 응답에 포함된 정보라는 점과 남용 금지 문구를 함께 둔다.

Failure modes

• 400 bad_request: 필수 입력이 없거나 도메인/IP/AS 형식이 올바르지 않음.
• 503 upstream_not_configured: 프록시 서버에 DATA_GO_KR_API_KEY 가 없거나 15094277 활용신청이 승인되지 않음.
• 502 upstream_forbidden: data.go.kr gateway가 키를 거부함(SERVICE KEY IS NOT REGISTERED ERROR 등).
• upstream result_code가 10000이 아님: result_msg를 확인하고 입력 형식과 할당 여부를 점검한다.
• 빈 결과: 등록·할당되지 않았거나 WHOIS가 공개하지 않는 대상일 수 있다.

Done when

• 입력 유형에 맞는 domain/IP/AS route를 사용했다.
• k-skill-proxy route를 통해 호출했고 사용자에게 API key를 요구하지 않았다.
• 등록·할당 기관, 날짜, 상태, 네임서버 또는 네트워크 범위를 원문 필드 기준으로 요약했다.
• 개인정보·연락처 필드는 남용 금지와 공개 원천 한계를 함께 설명했다.

Maintainer review notes

키 없이 가능한 검증:

• ./scripts/validate-skills.sh
• node --test packages/k-skill-proxy/test/server.test.js
• curl -fsS --get "$KSKILL_PROXY_BASE_URL/v1/kr-whois/domain" --data-urlencode "domain=kisa.or.kr"
• curl -fsS --get "$KSKILL_PROXY_BASE_URL/v1/kr-whois/ip" --data-urlencode "ip=202.30.50.51"
• curl -fsS --get "$KSKILL_PROXY_BASE_URL/v1/kr-whois/as" --data-urlencode "asn=AS9700"

위 live smoke는 hosted/self-host proxy에 DATA_GO_KR_API_KEY와 15094277 활용신청이 있을 때 수행한다. 공식 upstream 경로는 각각 B551505/whois/domain_name, B551505/whois/ip_address, B551505/whois/as_number다.

Safety notes

• 조회 전용 스킬이다.
• 개인정보 비공개 우회, 연락처 대량 수집, 보안 공격 자동화에 사용하지 않는다.
• 인증키는 프록시 서버에서만 다루며 repo/GitHub Actions/public docs에 저장하지 않는다.