zipcode-search

The zipcode-search skill retrieves Korean postal codes and official English addresses using the official ePost integrated postcode search service provided by Korea Post. It is designed for situations where users need accurate postal information and standardized English address formatting for shipping, overseas payments, registrations, or international documentation. Instead of relying on unofficial address converters or manually translated address formats, the skill queries the official ePost search endpoint and extracts verified postcode, road address, English address, and lot-number address data directly from the source.

The skill supports multiple address input formats, including road names with building numbers, district-based address keywords, and lot-number style addresses. It uses curl with HTTP/1.1, TLS constraints, retry handling, and timeout controls to improve reliability when communicating with the ePost endpoint, which may occasionally reset or timeout. Results are parsed from the HTML response by extracting structured viewDetail(...) rows that contain the official address data. The workflow also includes helper scripts for repeatable execution, retry strategies for ambiguous searches, and normalization guidance for presenting results clearly to end users.

This skill is useful for developers, automation agents, customer support workflows, and users who frequently need standardized Korean address information in English. It is especially relevant for international commerce, shipping systems, payment verification flows, and administrative tasks requiring official address formatting. The skill is intended for environments with internet access, Python 3, and curl available, and is optimized for reliable command-line or agent-based execution.