juso

Korean postal code lookup CLI & Go library

Install

brew install kyungw00k/cli/juso

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

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

Search both road name and lot number addresses by keyword. Use --jibun to display lot addresses.

Supports both Korean and English addresses. Select language with --lang ko|en|all.

Caches search results in a local SQLite database for 24 hours to maximize repeated lookup speed.

Supports Table, JSON, and CSV output. Use -o json or -o csv options.

Export JSON Schema via the tool-schema subcommand for direct LLM tool-call integration.

Automatically update to the latest version with the juso update command.

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

Export JSON Schema for LLM/MCP tool calls via the tool-schema subcommand. Integrates directly with Claude Code and AI agents.

A Claude Code skill is available for AI agents to use juso automatically.

/plugin marketplace add kyungw00k/skills

/plugin install cli-tools@kyungw00k-skills