OK Agent

도로명주소·우편번호 찾기 (지번 → 도로명 변환)

최종 수정

도로명주소와 우편번호는 행정안전부 도로명주소 API로 찾습니다. K-MCP의 kr_search_address 도구를 AI에 연결하면 건물 이름·지번·일부 주소만 줘도 도로명주소, 지번주소, 5자리 우편번호를 돌려주므로, 주소 목록을 통째로 주고 "우편번호 붙여 정리해 줘"라고 할 수 있습니다.

AI에게 이렇게 물어보세요

답하는 도구: kr_search_address (@appmonster/mcp-public-data) 도구 설명

AI에 연결하기 (1분, 무료)

설치 없이 주소 하나만 연결하면 됩니다. 조회 도구가 모두 열려 있고, 하루 100회까지는 가입도 필요 없습니다.

https://okagent.kr/api/mcp
Claude
설정 → 커넥터 → 커스텀 커넥터 추가 → 이름 K-MCP, URL에 위 주소
ChatGPT
설정 → 앱과 커넥터 → 고급 설정에서 개발자 모드 켜기 → 커넥터 만들기 → MCP 서버 URL에 위 주소, 인증 없음
Claude Code
claude mcp add --transport http kmcp https://okagent.kr/api/mcp
Cursor
{"mcpServers":{"kmcp":{"url":"https://okagent.kr/api/mcp"}}}

내 컴퓨터에서만 돌리고 싶으면 로컬 설치도 됩니다 (해당 서비스 키 필요):

claude mcp add public-data -- npx -y @appmonster/mcp-public-data

개발자: API로 바로 호출

같은 기능을 HTTP로도 씁니다. 도구 목록은 GET https://okagent.kr/api/tools, 명세는 openapi.json에 있습니다.

curl -s -X POST https://okagent.kr/api/tools/kr_search_address \
  -H "content-type: application/json" \
  -d '{"keyword":"테헤란로 152"}'

자주 묻는 질문

영문 주소도 나오나요?

현재는 국문 도로명·지번 주소와 우편번호를 줍니다. 영문 표기는 AI에게 도로명주소를 바탕으로 변환해 달라고 하면 됩니다.

함께 보면 좋은 글