juso

한국 우편번호 검색 CLI & Go 라이브러리

설치

brew install kyungw00k/cli/juso

go install github.com/kyungw00k/juso/cmd/juso@latest

curl -fsSL https://kyungw00k.dev/juso/install.sh | sh

키워드로 도로명과 지번 주소를 모두 검색합니다. --jibun 옵션으로 지번 주소를 표시합니다.

한국어와 영문 주소를 모두 지원합니다. --lang ko|en|all 옵션으로 언어를 선택합니다.

검색 결과를 로컬 SQLite DB에 24시간 캐싱해 반복 조회 속도를 극대화합니다.

Table · JSON · CSV 형식을 지원합니다. -o json 또는 -o csv 옵션을 사용합니다.

tool-schema 서브커맨드로 JSON Schema를 제공해 LLM 툴콜에 바로 연동됩니다.

juso update 명령으로 최신 버전으로 자동 업데이트할 수 있습니다.

juso 테헤란로

juso 판교역로 --lang en

juso 테헤란로 --jibun

juso 강남대로 --lang all

juso 테헤란로 -o json

juso 테헤란로 -o csv > results.csv

import "github.com/kyungw00k/juso"

results, err := juso.Search(ctx, "테헤란로")
for _, r := range results {
    fmt.Println(r.Postcode5, r.KoAddress)
}

juso tool-schema

juso tool-schema search

tool-schema 서브커맨드로 LLM/MCP 도구 호출용 JSON Schema를 내보냅니다. Claude Code 및 AI Agent와 바로 연동할 수 있습니다.

AI 에이전트가 juso를 자동으로 활용할 수 있는 Claude Code 스킬이 제공됩니다.

/plugin marketplace add kyungw00k/skills

/plugin install cli-tools@kyungw00k-skills