메뉴
공공데이터포털 WHOIS 도메인/IP 정보 API를 k-skill-proxy 경유로 호출해 .kr/.한국 도메인, IP 주소, AS 번호의 공개 등록정보를 조회한다. 조회 전용.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
KOPIS 공연예술통합전산망 Open API를 k-skill-proxy 경유로 조회해 공연 목록·상세와 공연시설 정보를 찾는다. 조회 전용.
열린국회정보 Open API를 k-skill-proxy 경유로 호출해 의안 검색·상세와 국회의원 본회의 표결정보를 조회한다. 조회 전용.
Browse 대법원경매정보(courtauction.go.kr) 부동산 매각공고 by 매각기일·법원·기일/기간 입찰, expand each notice into 사건번호·용도·주소·감정평가액·최저매각가, search property items by free conditions(지역·용도·가격·면적·유찰횟수), and look up a case directly by 법원+사건번호. Read-only, slow-by-design (~2s/call) to avoid IP blocks.
법원 전자소송 지급명령 신청을 위해 채권자·채무자·청구금액·청구원인·증빙 정보를 인터뷰하고, 신청서 초안과 공식 전자소송 브라우저 입력 handoff를 준비한다.
국방전자조달시스템(D2B) 공개 입찰공고 검색 화면에서 공고건명·공고구분·공고/개찰일·G2B공고번호·발주기관 조건으로 공고를 조회한다.
당근부동산(realty.daangn.com) 공개 웹 데이터로 지역 기반 부동산 매물 검색과 상세 확인을 수행한다. 문의/예약/계약 자동화는 제외한다.
| name | kr-whois-lookup |
| description | 공공데이터포털 WHOIS 도메인/IP 정보 API를 k-skill-proxy 경유로 호출해 .kr/.한국 도메인, IP 주소, AS 번호의 공개 등록정보를 조회한다. 조회 전용. |
| license | MIT |
| metadata | {"category":"security","locale":"ko-KR","phase":"v1"} |
공공데이터포털의 WHOIS 도메인/IP 정보 API(data.go.kr 15094277)의 공식 endpoint를 k-skill-proxy 경유로 호출한다.
지원 범위는 .kr/.한국 도메인, IPv4/IPv6 주소, AS1234 형식의 AS 번호다. 등록기관, 등록/할당일, 상태, 네임서버, 네트워크 범위, 국가 코드 등 공개 가능한 필드를 원문 기반으로 요약한다.
.com, .net 등 해외 gTLD WHOIS 조회k-skill-proxy의 /v1/kr-whois/domain, /v1/kr-whois/ip, /v1/kr-whois/as route 접근 가능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 를 참고한다.
domain, query, 또는 q에 조회할 .kr/.한국 도메인ip, query, 또는 q에 유효한 IPv4/IPv6 주소asn, as, query, 또는 q에 AS9700 같은 AS<digits> 형식의 AS 번호도메인 URL은 scheme/path를 제거하고 .kr/.한국 도메인만 남긴다. IP는 유효한 IPv4/IPv6인지 검증한다. AS 번호는 대소문자와 공백을 정리해 AS<digits> 형식으로 만든다.
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"
응답에서 다음 필드를 우선 확인한다.
result_code, result_msg: upstream 결과query, queryType, result_code, result_msgname, regName, agency, agency_urlregDate, endDate, lastUpdatedDatedomainStatus, dnssecns1, ns2, ip1, ip2 등 네임서버/주소 필드개인 연락처로 보이는 값은 그대로 확산하지 말고, 공개 API 응답에 포함된 정보라는 점과 남용 금지 문구를 함께 둔다.
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 등).result_code가 10000이 아님: result_msg를 확인하고 입력 형식과 할당 여부를 점검한다.k-skill-proxy route를 통해 호출했고 사용자에게 API key를 요구하지 않았다.키 없이 가능한 검증:
./scripts/validate-skills.shnode --test packages/k-skill-proxy/test/server.test.jscurl -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다.