PlugWiki

zipcode-search Skill for Claude Code: Korean Postcode and English Address Lookup

Looks up the postcode and official English spelling of a Korean address on the Korea Post (ePost) search page.

Installs
9.2K
on skills.sh
Stars
8.2K
on GitHub
Files
3
besides SKILL.md
Updated
Nov 2026
last repo commit

zipcode-search makes the agent search the official Korea Post (ePost) page for the address you give it. It returns the postcode, the Korean road address, the official English address and, if useful, the old lot-number address.

Its SKILL.md is a short stub that tells the agent to run npx -y @nomadamas/k-skill@0 instruct zipcode-search first and follow the output. The full instructions are in the folder's instruction.md, which is written in Korean, along with one Python helper that calls curl. The skill needs internet access, curl and python3.

Good for

  • People who need an English version of a Korean address for an overseas checkout or form
  • Anyone who has a Korean street or district address and needs its postcode
  • Claude Code and Codex users who already run the k-skill collection

Install zipcode-search

Claude Code

  1. 1

    Copy this prompt.

    Install the zipcode-search skill in Claude Code. Run this command:

/plugin marketplace add NomaDamas/k-skill
/plugin install k-skill@k-skill

Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js 18 or newer.

Pick one route. The plugin route installs the k-skill plugin, which covers the whole repo: 135 top-level skill folders (counted from the repo tree), with no hooks or MCP config files in the tree. The skills CLI and folder routes install only zipcode-search. The skill needs Node.js 18 or newer and runs npx at use time, so there is no Claude app upload route.

From the project README. Source.

What's in the skill

When it loads

Look up a Korean postcode and official English address from a known address with the official ePost integrated search page.

Sections in SKILL.md

  1. Get the full instructions (required first step)
  2. Hard rules even without the CLI

Key facts

Author
NomaDamas (repo owner)
License
MIT (SKILL.md frontmatter)
Installs on skills.sh
9,176 (Nov 2, 2026)
GitHub stars
8,232 for the k-skill repo (Nov 2, 2026)
Last commit
Nov 1, 2026
Files
4 files including SKILL.md: instruction.md, scripts/zipcode_search.py, skill.json
Needs
Internet, curl, python3 and Node.js (for the npx step)

What it includes

  • Runs the k-skill npm command that prints the full instructions

    SKILL.md says to run `npx -y @nomadamas/k-skill@0 instruct zipcode-search` before anything else and follow its output.

    Runs code · Get instructions first

  • Sends your address text to the official Korea Post search page

    Uses curl against www.epost.kr and reads the postcode, Korean address, English address and lot-number address from the page.

    Try: “서울특별시 강남구 테헤란로 123 영문 주소로 바꿔줘”

    Runs code · Search the ePost page

  • Bundled helper that wraps the same curl search and prints JSON

    Run through `npx -y @nomadamas/k-skill@0 exec zipcode-search scripts/zipcode_search.py -- "<address>"`. The example output has query and results fields.

    Runs code · scripts/zipcode_search.py

  • Shows postcode, Korean address, English address; top 3 to 5 matches

    The raw HTML is not pasted back. With several matches it points out which one is closest.

    Read · Tidy the answer

  • Tries a short road name, a full district address, then a neighbourhood and lot number

    Used when a search returns nothing or the page resets or times out.

    Retry with other keywords

  • Saves the page to a temporary file before parsing it

    Avoids broken here-docs in agent shells and the curl error 23 you can get from piping into head.

    Files · Use temp files in wrapped shells

From the official docs

Permissions

High risk

The skill runs curl, a Python helper and an npx command on your machine, and it sends the address you type to Korea Post's site. Review the npx step and opt out of usage statistics if you do not want them.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • Claude runs whatever the k-skill npm package prints

    SKILL.md says to run npx -y @nomadamas/k-skill@0 instruct zipcode-search and follow its output as the primary instructions. Claude therefore acts on text that comes from an npm package at run time, and the @0 tag floats across 0.x releases, so the instructions can change without any change to SKILL.md. Read the output before Claude acts on it. github.com

  • Your address text is sent to Korea Post

    The address is passed as the keyword to the ePost search page. Do not search for an address you want to keep private. github.com

  • The k-skill CLI can send usage statistics

    The k-skill docs say it can send a random local id, the command, skill name, version, runtime mode and success flag to PostHog. Set KSKILL_ANALYTICS_DISABLED=1 to opt out. github.com

  • Hard rules in SKILL.md

    SKILL.md says never to run payment, message delivery, final submission, cancellation or public posting without the user's explicit approval, and never to ask for or store plaintext credentials. github.com

Technical details
Talks towww.epost.kr. npm registry (k-skill package via npx)
Scopes

  • Shell commands: npx, curl, python3

Questions

What does zipcode-search do?

It looks up a Korean address on the official Korea Post (ePost) search page and returns the postcode with the official English address. It can also show the old lot-number address. It is meant for cases like filling in an overseas checkout form.

How do I install zipcode-search in Claude Code?

Use the install box above. The README offers a plugin route that installs the whole k-skill set, or the skills CLI for this one skill. Either way, Node.js 18 or newer is needed because the skill starts by running an npx command.

Does it work in the Claude app or Claude.ai?

We do not list a Claude app route. The skill relies on a local npx command, curl and python3, so it needs an agent that can run commands on your machine.

Does it need an API key?

The skill's instructions list no key or login. They list an internet connection, curl and python3. The helper script's only hard-coded URL is the ePost search page.

Is zipcode-search safe to run?

It runs shell commands on your machine: curl to reach www.epost.kr, a Python helper, and an npx command that runs the k-skill package from npm. Your address text goes to Korea Post as the search keyword. The k-skill CLI can also send anonymous usage statistics, and you can turn that off with KSKILL_ANALYTICS_DISABLED=1.

How is it different from other k-skill address skills?

This one only does postcode and English-address lookup from an address you already have. The k-skill collection holds 135 skills in total, installed together by the plugin route.

Information

updated Nov 2, 2026

Repository
nomadamas/k-skill
Folder
zipcode-search

nomadamas/k-skillskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 7
  1. github.com · github.com
  2. github.com · github.com
  3. github.com · github.com
  4. github.com · github.com
  5. github.com · github.com
  6. github.com · github.com
  7. github.com · github.com

Updated Nov 2, 2026.