landprice

한국 부동산공시가격 알리미의 토지 공시가격을 조회하는 읽기 전용 JSON CLI입니다. 표준지 공시지가와 개별공시지가를 브라우저 자동화 없이 같은 명령 체계로 조회할 수 있게 만드는 것이 목표입니다.

Landprice는 RealtyPrice 공개 웹 화면을 읽기 전용으로 사용합니다. 공식 API가 아니며, RealtyPrice 웹 동작이 바뀌면 결과나 파서가 영향을 받을 수 있습니다.

설치

npm install @sjunepark/landprice

CLI를 바로 실행하려면 다음처럼 사용할 수 있습니다.

npx @sjunepark/landprice --help

npm/npx 환경에서는 Node.js 20.18.1 이상이 필요합니다. 이 저장소의 개발, 테스트, 빌드는 Bun을 사용합니다.

CLI

설치 후 landprice 명령을 사용할 수 있습니다.

landprice --help
landprice get-available-years
landprice list-areas --year 2025 --surface individual-land --level legal-dong --sido-code 43 --district-code 43770
landprice search-individual-land-prices --years 2026,2025,2024 --district-code 43770 --legal-dong-code 25624 --parcel 603-1

명령과 옵션의 최신 기준은 CLI 도움말입니다. README에는 전체 옵션을 복제하지 않습니다.

landprice <command> --help

명령 성공은 표준 출력에 하나의 JSON 응답 객체로 출력됩니다. 명령 실패도 표준 출력에 하나의 JSON 실패 객체를 출력하고 0이 아닌 종료 코드로 끝납니다. 도움말 출력은 사람이 읽기 쉬운 텍스트로 유지됩니다.

현재 제공하는 주요 작업은 다음과 같습니다.

• get-available-years: 출처가 지원하는 조회 연도 확인
• list-areas: 표준지/개별공시지가 화면 기준 지역 코드 조회
• search-standard-land-prices: 표준지 공시지가 목록 조회
• search-individual-land-prices: 개별공시지가 지번 조회, 단일 연도 또는 최대 5개 연도 조회
• get-standard-land-price-detail: 표준지 검색 결과의 평가 근거/상세 정보 조회

조회 흐름

개별공시지가처럼 지역 코드를 알아야 하는 작업은 먼저 list-areas로 코드를 찾은 뒤 검색합니다.

landprice list-areas --year 2025 --surface individual-land --level district --sido-code 43
landprice list-areas --year 2025 --surface individual-land --level legal-dong --sido-code 43 --district-code 43770
landprice search-individual-land-prices --year 2025 --district-code 43770 --legal-dong-code 25624 --parcel 603-1 --pretty

표준지 상세 조회는 검색 결과에 포함된 standardLandReference를 그대로 넘겨 재현 가능한 후속 조회를 합니다.

landprice get-standard-land-price-detail --reference '{"year":2026,"regCode":"11680","eubCode":"10300","sourceSanFlag":"1","bun1":"0086","bun2":"0000","standardLandNumber":"276"}'

계약 안정성

재사용 가능한 공개 계약으로 보는 범위는 다음과 같습니다.

• CLI 명령 이름
• 입력 옵션 이름과 의미
• 성공 JSON의 최상위 응답 필드와 참조 정보
• 실패 JSON의 code, message, retryable, parameter, recoveryHint 의미

명령을 제거하거나 이름을 바꾸는 변경, 입력/결과 필드를 제거하는 변경, 실패 코드의 의미를 바꾸는 변경은 호환성을 깨는 변경입니다.

명령 추가, 선택 입력 필드 추가, 결과 필드 추가, 경고나 메타데이터 추가는 호환 가능한 변경입니다.

표준 통합 지점은 CLI, 런타임 중립 TypeScript toolset, Pi 어댑터입니다. toolset은 @sjunepark/landprice/toolset에서, Pi 어댑터는 @sjunepark/landprice/pi에서 가져올 수 있습니다. MCP 서버는 공개 계약으로 제공하지 않습니다.

주의사항

• 이 도구는 RealtyPrice 공개 웹 동작을 읽기 전용으로 사용합니다.
• 정부나 RealtyPrice가 제공하는 공식 API 패키지가 아닙니다.
• 법률, 세무, 감정평가, 투자 판단을 제공하지 않습니다.
• 결과를 중요한 의사결정에 사용할 때는 원문 RealtyPrice 화면과 응답 참조 정보를 직접 확인하세요.

라이선스

Elastic License 2.0. 자세한 내용은 LICENSE.md를 참고하세요.

개발

bun install
bun run typecheck
bun test
bun run build
node dist/cli.js get-available-years

# Package surfaces after build
node -e "import('./dist/toolset.js').then(({ createLandpriceToolset }) => console.log(createLandpriceToolset().listOperations().length))"

릴리스 자동화와 필요한 저장소 설정은 docs/release.md를 참고하세요.