포스트코디파이 (postcodify)

포스트코디파이(postcodify)는 도로명주소·우편번호 검색 API를 자체 서버에서 돌릴 수 있게 만든 오픈소스입니다. GitHub 137스타·LGPL-3.0, PHP. 2026년 8월에도 갱신되고 있습니다.

자체 호스팅이 왜 의미 있나

한국 웹사이트의 주소 입력은 대개 외부 우편번호 서비스 팝업을 띄웁니다. 편하지만 그 서비스가 느려지거나 멈추면 우리 가입·주문 흐름이 같이 멈춥니다. 디자인도 그쪽 규격에 맞춰야 합니다.

직접 호스팅하면 속도·디자인·가용성을 통제할 수 있습니다. 트래픽이 큰 서비스일수록 차이가 커집니다.

주소 데이터의 까다로운 지점

• 도로명·지번 병행 표기
• 같은 건물의 여러 표기(약칭·옛 이름)
• 상세주소 분리
• 주기적인 데이터 갱신

검색이 “되는 것”과 “사람이 치는 대로 찾아주는 것”은 다른 문제입니다.

한국 공공데이터·주소·지도 오픈소스

• 대한민국 행정구역 지도: 시도·시군구·읍면동 경계 데이터
• 포스트코디파이(postcodify): 도로명주소·우편번호 검색 API
• 공공데이터 분석(OpenDataWrangling): 실제 데이터로 분석 실습
• QGIS 한국 지도 플러그인: 카카오·네이버·VWorld 배경지도
• holidayskr: 음력·대체공휴일까지 계산하는 공휴일 패키지

공공데이터포털은 데이터를 열어두지만 형식이 제각각이고 문서가 불친절합니다. 그 사이를 개인 개발자들이 래퍼·정제 데이터·플러그인으로 메우고 있습니다.

그리고 초기 데이터 구축에 디스크와 색인 시간이 듭니다. 트래픽이 적은 서비스라면 공공 API를 쓰는 편이 총비용이 낮을 수 있습니다.

이런 분께 맞아요

• 주소 입력이 있는 커머스·회원 서비스 개발자
• 외부 팝업 의존을 줄이고 싶은 팀
• 배송·물류 서비스를 만드는 1인 메이커
• 주소 정규화를 다뤄야 하는 데이터 엔지니어