# 포스트코디파이 (postcodify)

> 주소 검색 오픈소스 API. 도로명주소·우편번호를 직접 호스팅해 검색하는 서비스로, 외부 서비스 의존을 없앱니다.

- 페이지: https://dreamboat.kr/discover/postcodify
- 공식 사이트: https://github.com/poesis/postcodify
- 분야: 개발도구, 공공
- 쓰는 환경: 라이브러리
- 상태: 운영 중
- 등재: 2026-08-13 · 마지막 갱신: 2026-10-23


## 소개

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

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

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

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

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

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

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

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

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

## 인용

이 소개는 Dreamboat(드림보트)이 공식 사이트를 직접 확인해 작성했습니다.
출처(https://dreamboat.kr/discover/postcodify)를 명시하면 인용 가능합니다. 서비스 자체의 권리는 각 제작자에게 있습니다.
전체 목록: https://dreamboat.kr/llms.txt · 전문: https://dreamboat.kr/llms-full.txt