서울시 개별공시지가 정보 MCP

서울 열린데이터광장의 서울시 개별공시지가 정보(IndividuallyPostedLandPriceService)를 MCP 툴로 제공하는 서버입니다. 시군구명·기준년도(+ 법정동/본번/부번/필지구분코드)로 개별 필지의 공시지가(원/㎡)를 조회합니다.

제공 툴

get_individual_land_price

시군구명과 기준년도로 개별공시지가를 조회합니다. 법정동명/본번/부번/필지구분코드로 추가 필터링 가능.

파라미터	타입	필수	설명
sigungu_nm	string	필수	시군구명 (예: 종로구)
year	string	필수	기준년도 (YYYY)
bjdong_nm	string	선택	법정동명
bonbeon	string	선택	본번 (0~9999)
bubeon	string	선택	부번 (0~9999)
pilgi_cd	string	선택	필지구분코드 (1:토지 2:임야 3:가지번 4:가지번(부분세분) 5:블럭지번 6:블럭지번(롯트세분) 7:블럭지번(지구) 8:블럭지번(지구-롯트) 9:기타지번)
start_index	integer	선택 (기본 1)	조회 시작 위치
end_index	integer	선택 (기본 100)	조회 종료 위치 (start_index와 차이 최대 1000)

응답 필드: 시군구명/시군구코드/법정동명/법정동코드/본번/부번/필지구분명/필지구분코드/ 기준년월(YYYY-MM-DD 형식)/공시지가(원/㎡)/기준년도

⚠️ 실측으로 확인된 제약 (DEVLOG.md 참고):

• bjdong_nm/bonbeon/bubeon/pilgi_cd는 넷 다 채우거나 넷 다 비워야 합니다. 하나라도 부분적으로만 채우면 서울시 API가 ERROR-500(서버 오류)을 반환합니다. 이 서버는 부분 채움을 감지하면 API를 호출하기 전에 ERROR-CLIENT-PARTIAL-PARAMS로 안내합니다.
• 시군구명+기준년도만으로(선택 파라미터 4개를 전부 비운 채) 여러 건을 조회하는 것은 지원되지 않습니다. 이 조합도 ERROR-500을 반환하는 것으로 실측되었습니다. start_index/end_index로 실제 여러 건(list_total_count > 1)이 반환되는 유효한 조합은 아직 확인하지 못했습니다 — 4개 파라미터를 모두 채운 유효 요청은 필지 단위로 좁혀져 통상 1건만 반환됩니다.

설치 및 로컬 실행

pip install -r requirements.txt
cp .env.example .env   # SEOUL_API_KEY 값 입력 (BOM 없이 저장할 것)
python server.py

환경변수

이름	설명
SEOUL_API_KEY	서울 열린데이터광장에서 발급받은 인증키
PORT	서버 포트 (기본값은 server.py 참고)

배포 (fly.io)

fly launch --no-deploy
fly secrets set SEOUL_API_KEY=발급받은키
flyctl deploy

배포 후 Claude.ai > 설정 > 커넥터에서 연결하고, "사용 가능한 도구" 목록에 툴이 뜨는지 확인하세요.

라이선스 / 출처

• 원데이터: 서울특별시 (도시공간본부 토지관리과)
• 이용허락조건: 공공누리 1유형 (출처표시, 상업적 이용 및 변경 가능)
• 출처 표기 예: "본 서비스는 서울열린데이터광장의 개별공시지가 정보를 사용합니다."