| name | juso |
| description | 한국 우편번호/주소 검색. 'juso', '우편번호', 'postal code', 'Korean address', '주소 검색', '주소 찾기' 키워드에서 트리거. juso CLI가 설치되어 있을 때 사용. |
juso — 한국 우편번호 검색
juso CLI로 한국 우편번호와 주소를 검색합니다.
사전 조건
juso CLI가 설치되어 있어야 합니다:
brew install kyungw00k/cli/juso
go install github.com/kyungw00k/juso/cmd/juso@latest
사용법
기본 검색
키워드로 우편번호와 도로명 주소를 검색합니다:
juso 테헤란로
juso 판교역로
juso 강남대로
영문 주소
--lang en 플래그로 영문 주소를 출력합니다. ASCII 키워드는 자동으로 영문 출력됩니다:
juso 테헤란로 --lang en
한/영 동시 출력
juso 판교역로 --lang all
지번 주소
도로명 대신 지번 주소를 출력합니다:
juso 테헤란로 --jibun
출력 형식
| 플래그 | 설명 | 용도 |
|---|
-o auto (기본) | TTY → 테이블, 파이프 → JSON | 기본 사용 |
-o table | 테이블 | 사람이 읽을 때 |
-o json | JSON | 프로그래밍/파이프 |
-o jsonl | JSON Lines | 스트리밍 처리 |
-o csv | CSV (전체 필드) | 스프레드시트 내보내기 |
AI 에이전트에서는 -o json을 사용하세요:
juso 테헤란로 -o json
응답 필드 (JSON)
| 필드 | 설명 |
|---|
postcode5 | 5자리 우편번호 |
postcode6 | 6자리 우편번호 (구) |
ko_address | 한국어 도로명 주소 |
ko_jibun | 한국어 지번 주소 |
en_address | 영문 도로명 주소 |
en_jibun | 영문 지번 주소 |
building_name | 건물명 |
kakao_map_url | 카카오맵 검색 링크 |
naver_map_url | 네이버지도 검색 링크 |
캐시
검색 결과는 SQLite에 24시간 캐시됩니다:
juso cache stats
juso cache clear
AI Tool Schema
JSON Schema를 내보내 다른 AI 도구에서 사용 가능:
juso tool-schema
juso tool-schema search
사용 예시 시나리오
"테헤란로 주소를 찾아줘"
juso 테헤란로 -o json
"판교역 근처 우편번호를 CSV로 내보내줘"
juso 판교역로 -o csv > pangyo.csv
"강남대로 주소를 영문으로 알려줘"
juso 강남대로 --lang en -o json
