zipcode-search

Retrieve Korean postal codes and official English addresses from ePost search results.

7.1k|836|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/NomaDamas/k-skill --skill zipcode-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zipcode-search
Source: https://github.com/NomaDamas/k-skill/tree/main/zipcode-search
Command: npx skills add https://github.com/NomaDamas/k-skill --skill zipcode-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill solves the problem of finding the correct Korean postal code and the official English address for a given Korean location so you don’t have to rely on unofficial converters or guess for international forms and deliveries.

Core Features & Use Cases

  • Official ePost integrated lookup: Queries the 우체국 official integrated search page and uses the returned postcode and official English address.
  • Address normalization and multi-match handling: Extracts up to the top candidates and presents structured results (zip, road address, official English address, and optionally jibun address).
  • Robust retrieval strategy: Uses curl with conservative TLS/HTTP settings and retry options, then parses the specific viewDetail(...) rows from the HTML response.

Quick Start

Ask: “Look up the postcode and official English address for 서울특별시 강남구 테헤란로 123.”

Frequently Asked Questions about zipcode-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the official English address and postal code for a Korean location?

You can retrieve the Korean postal code and official English address by querying the ePost integrated search page with a Korean address keyword and parsing the returned results for zip, road, and English address fields.

Can I get English addresses for international shipping directly from the Korea Post database?

Yes, you can get English addresses for international shipping directly from the Korea Post database by fetching the official ePost search page, which returns the official English address alongside the Korean postal code.

How does address normalization handle multiple matches when looking up Korean zip codes?

Address normalization handles multiple matches by extracting the top candidates from the ePost response and presenting structured results containing zip, road address, English address, and jibun address fields for you to choose from.

What is the best way to automate Korean address lookup for form completion?

The best way to automate Korean address lookup for form completion is to use HTTP fetching with curl to query the ePost page, then parse the specific HTML response rows to extract deterministic postal code and address data.

Does this Korean address lookup require any external libraries or API dependencies?

No, this Korean address lookup does not require external libraries or API dependencies, as it uses built-in curl HTTP fetching with conservative TLS settings to retrieve and parse HTML directly from the ePost page.

Why does the ePost HTML parsing return limited results for some Korean address searches?

The ePost HTML parsing returns limited results because it applies deterministic output restricted to the top candidates from the viewDetail rows, ensuring only the most relevant postal code and English address matches are presented.