Feature Request: 한글 주소 영문 주소 변환 기능

[bluehyena]

Description
우편번호를 조회하는 기능에 추가 혹은 별도 기능으로 한글 주소를 표준 영문 주소로 변환해주는 기능이 있었으면 좋겠습니다.

현재 한국의 도로명 주소나 지번 주소를 영문으로 변환해야 하는 경우가 특히 해외 서비스 연동(배송, 결제, API 등) 시 많았어서 해당 기능이 있으면 활용도가 높을 것 같습니다.

Proposed Solution
한글 주소를 입력하면 표준 형식의 영문 주소로 변환

아래 링크에서 우편번호, 영문주소를 함께 검색할 수 있어서 링크 함께 첨부합니다.
https://www.epost.kr/search.RetrieveIntegrationNewZipCdList.comm

Example
입력:
서울특별시 강남구 테헤란로 123
출력:
123, Teheran-ro, Gangnam-gu, Seoul, Republic of Korea

유용한 오픈소스 공유에 감사드립니다!

[vkehfdl1]

• AI-understood issue summary

  • 이 이슈는 기존 우편번호 조회 인접 기능으로, 한글 도로명/지번 주소를 공식 표준 영문 주소로 변환하는 기능을 추가해 달라는 요청으로 이해했습니다.
  • 첨부하신 우체국 통합검색 표면은 실제로 검색 결과에 English/집배코드 열과 영문 주소 값을 함께 노출하므로, 임의 로마자 변환이 아니라 공식 표기값을 조회/정규화하는 방향이 맞아 보입니다.

• Why this issue is needed

  • 해외 배송/결제/API 연동에서는 한국 주소를 영문 표준 형식으로 즉시 제출해야 하는 경우가 많아서, 우편번호 조회와 함께 자주 붙는 실무 니즈입니다.
  • 이미 저장소에 zipcode-search 기능이 있으므로, 사용자는 “우편번호 찾기” 다음 단계로 자연스럽게 영문 주소까지 한 번에 기대할 가능성이 큽니다.
  • 공식 표면에서 영문 주소를 가져오면 LLM/규칙 기반 로마자 변환보다 신뢰도가 높고, 사용자도 결과를 검증하기 쉽습니다.

• Why this issue may not be needed

  • 별도 독립 기능으로 만들기보다, 기존 zipcode-search를 확장해서 우편번호 + 국문 주소 + 영문 주소를 같이 반환하는 편이 더 단순할 수 있습니다.
  • 만약 공식 표면이 항상 영문 주소를 주는 게 아니라면, 억지로 자체 로마자 변환을 추가하는 순간 유지보수 비용과 오표기 리스크가 커집니다.
  • 그래서 “새 스킬 추가”보다 먼저 기존 우편번호 조회 흐름의 옵션/출력 확장으로 충분한지를 판단하는 게 좋아 보입니다.

• Expected Outcome

  • 사용자가 한글 주소를 입력하면, 가능한 경우 아래 정보를 함께 받습니다.
    • 우편번호
    • 표준 국문 도로명 주소
    • 표준 국문 지번 주소(있으면)
    • 공식 영문 주소
  • 후보가 여러 개면 상위 3~5개를 보여주고, 어떤 후보가 가장 근접한지 안내합니다.
  • 결과가 없거나 너무 넓으면 기존 우편번호 검색처럼 더 구체적인 재검색 키워드를 제안합니다.

• Concise implementation plan

  1. 현재 zipcode-search 흐름과 ePost 통합검색 표면을 비교해, 기존 기능 확장 vs 별도 기능 분리를 먼저 결정합니다.
  2. 공식 ePost 결과에서 영문 주소 필드만 추출하고, 자체 로마자 생성은 하지 않습니다.
  3. 응답 포맷을 zip_code / korean_road_address / korean_jibun_address / english_address 중심으로 정리합니다.
  4. README, feature docs, sources, install/roadmap 문서와 scripts/skill-docs.test.js 같은 문서 정합성 테스트를 함께 갱신합니다.
  5. 도로명/지번 각각의 대표 주소로 검증해서 다중 후보, 무응답, 재검색 안내까지 확인합니다.

• Agent Signature

[vkehfdl1]

/approve

[vkehfdl1]

close at #100