juso

name	juso
description	Korean postal code and address lookup. Search by keyword, get postcode + Korean/English road/jibun addresses + map URLs.
version	1.0.0

juso — 한국 우편번호 검색

키워드로 한국 우편번호와 주소(도로명/지번, 한/영)를 검색합니다.

명령어

검색 (기본 동작)

파라미터	타입	필수	기본값	설명
keyword	string	O	-	검색어 (주소, 건물명, 우편번호)
--lang	string	X	ko	주소 언어: ko, en, all
--jibun	bool	X	false	지번 주소 표시
-o	string	X	auto	출력 형식: auto, table, json, jsonl, csv

예시:

• juso 강남역 — 강남역 관련 주소 검색
• juso gangnam --lang en — 영문 주소로 검색
• juso 역삼동 --jibun — 지번 주소 출력
• juso 강남역 -o json — JSON 형식 출력

응답 필드

필드	설명
postcode5	5자리 우편번호
ko_address	한국어 도로명 주소
ko_jibun	한국어 지번 주소
en_address	영문 도로명 주소
en_jibun	영문 지번 주소
building_name	건물명
kakao_map_url	카카오맵 링크
naver_map_url	네이버지도 링크

캐시 관리

• juso cache stats — 캐시 통계 (건수, 크기)
• juso cache clear — 캐시 전체 삭제

JSON Schema

• juso tool-schema — 전체 명령어 JSON Schema
• juso tool-schema search — 검색 명령어 Schema만