@sjunepark/landprice 0.0.0

package/LICENSE.md

@@ -0,0 +1,47 @@
+# Landprice Proprietary License Agreement
+
+Copyright (c) 2026 Sejun Park. All rights reserved.
+
+This Landprice Proprietary License Agreement (the "Agreement") governs your access to and use of the Landprice software, including the CLI, bundled files, documentation, updates, and related materials (the "Software").
+
+## 1. License Grant
+
+Subject to this Agreement and the accompanying Terms, Sejun Park grants you a limited, revocable, non-exclusive, non-transferable, non-sublicensable license to install and use the Software for personal use or internal business use.
+
+No ownership rights are transferred. All rights not expressly granted are reserved.
+
+## 2. Restrictions
+
+You must not, and must not permit others to:
+
+- copy, redistribute, publish, sublicense, rent, lease, sell, resell, or otherwise transfer the Software;
+- host, expose, wrap, or provide the Software as a service, API, managed service, or hosted tool for third parties;
+- modify, adapt, translate, create derivative works from, or publish modified versions of the Software;
+- reverse engineer, decompile, disassemble, deobfuscate, or otherwise attempt to derive source code, algorithms, or internal implementation details, except to the extent applicable law expressly permits despite this restriction;
+- remove, alter, bypass, or interfere with license notices, access controls, usage controls, authentication, telemetry, rate limits, or other protection mechanisms;
+- use the Software to build, train, benchmark, support, or operate a competing product or service;
+- use the Software for automated abuse, excessive traffic generation, scraping abuse, service disruption, security testing without authorization, or any unlawful purpose.
+
+## 3. Commercial Use
+
+Internal business use is permitted under this Agreement. External commercial exploitation, including resale, paid hosting, managed access, bundling in a commercial product, or use in a competing offering, requires prior written permission.
+
+## 4. Third-Party Services and Data
+
+The Software may access public RealtyPrice web pages and third-party services. You are responsible for complying with applicable laws, third-party terms, rate limits, and acceptable-use rules. This Agreement does not grant rights to third-party data, websites, APIs, or services.
+
+## 5. Termination
+
+This license terminates automatically if you violate this Agreement or the accompanying Terms. Upon termination, you must stop using the Software and delete all copies under your control.
+
+## 6. No Warranty
+
+The Software is provided "as is" and "as available," without warranties of any kind, whether express, implied, statutory, or otherwise, including warranties of merchantability, fitness for a particular purpose, title, non-infringement, accuracy, availability, or uninterrupted operation.
+
+## 7. Limitation of Liability
+
+To the maximum extent permitted by law, Sejun Park will not be liable for any indirect, incidental, special, consequential, exemplary, or punitive damages, or for lost profits, lost revenue, lost data, business interruption, or procurement of substitute services, arising from or related to the Software or this Agreement.
+
+## 8. Changes
+
+This Agreement may be updated from time to time. Continued use of the Software after an updated Agreement is published means you accept the updated Agreement.

package/README.md

@@ -0,0 +1,100 @@
+# landprice
+
+한국 부동산공시가격 알리미의 토지 공시가격을 조회하는 읽기 전용 JSON CLI입니다. 표준지 공시지가와 개별공시지가를 브라우저 자동화 없이 같은 명령 체계로 조회할 수 있게 만드는 것이 목표입니다.
+
+Landprice는 RealtyPrice 공개 웹 화면을 읽기 전용으로 사용합니다. 공식 API가 아니며, RealtyPrice 웹 동작이 바뀌면 결과나 파서가 영향을 받을 수 있습니다.
+
+## 설치
+
+```bash
+npm install @sjunepark/landprice
+```
+
+CLI를 바로 실행하려면 다음처럼 사용할 수 있습니다.
+
+```bash
+npx @sjunepark/landprice --help
+```
+
+npm/npx 환경에서는 Node.js 20.18.1 이상이 필요합니다. 이 저장소의 개발, 테스트, 빌드는 Bun을 사용합니다.
+
+## CLI
+
+설치 후 `landprice` 명령을 사용할 수 있습니다.
+
+```bash
+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에는 전체 옵션을 복제하지 않습니다.
+
+```bash
+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`로 코드를 찾은 뒤 검색합니다.
+
+```bash
+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`를 그대로 넘겨 재현 가능한 후속 조회를 합니다.
+
+```bash
+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입니다. 별도의 패키지 API, Pi 어댑터, MCP 서버는 아직 공개 계약으로 제공하지 않습니다.
+
+## 주의사항
+
+- 이 도구는 RealtyPrice 공개 웹 동작을 읽기 전용으로 사용합니다.
+- 정부나 RealtyPrice가 제공하는 공식 API 패키지가 아닙니다.
+- 법률, 세무, 감정평가, 투자 판단을 제공하지 않습니다.
+- 결과를 중요한 의사결정에 사용할 때는 원문 RealtyPrice 화면과 응답 참조 정보를 직접 확인하세요.
+
+## 라이선스
+
+Landprice는 오픈소스가 아닌 독점 소프트웨어입니다. npm 패키지 메타데이터는 `UNLICENSED`이며, 사용 조건은 [`LICENSE.md`](./LICENSE.md)와 [`TERMS.md`](./TERMS.md)를 따릅니다.
+
+## 개발
+
+```bash
+bun install
+bun run typecheck
+bun test
+bun run build
+node dist/cli.js get-available-years
+```
+
+릴리스 자동화와 필요한 저장소 설정은 [docs/release.md](docs/release.md)를 참고하세요.

package/TERMS.md

@@ -0,0 +1,38 @@
+# Landprice Terms of Use
+
+These Terms of Use (the "Terms") apply to your use of Landprice. They supplement the Landprice Proprietary License Agreement in `LICENSE.md`.
+
+## Permitted Use
+
+You may use Landprice only for lawful, read-only querying and viewing of RealtyPrice land-price information for personal or internal business purposes.
+
+## Prohibited Use
+
+You must not use Landprice to:
+
+- overload, disrupt, degrade, or interfere with RealtyPrice, Landprice, npm, GitHub, or any related service;
+- bypass authentication, access controls, rate limits, robots exclusions, or technical protections;
+- perform abusive, excessive, or unauthorized automated requests;
+- misrepresent Landprice as an official RealtyPrice, government, or regulator service;
+- remove legal notices, license notices, attribution, or usage restrictions;
+- redistribute, resell, host, sublicense, or provide Landprice to third parties;
+- build or operate a competing product or service without prior written permission;
+- violate any law, regulation, third-party right, or applicable third-party terms.
+
+## RealtyPrice Disclaimer
+
+Landprice is not affiliated with, endorsed by, or sponsored by RealtyPrice, the Ministry of Land, Infrastructure and Transport, or any Korean government or regulatory body. Landprice reads public RealtyPrice web pages and may break or return incomplete results if those pages change.
+
+You are responsible for verifying any land-price information before relying on it.
+
+## Availability and Changes
+
+Landprice may change, become unavailable, or stop being distributed at any time. Command names, output formats, and service behavior may change according to the project's published compatibility policy and release notes.
+
+## Termination
+
+Your right to use Landprice ends automatically if you violate these Terms or the License. After termination, you must stop using Landprice and delete all copies under your control.
+
+## No Legal, Tax, Appraisal, or Investment Advice
+
+Landprice is an information retrieval tool. It does not provide legal, tax, appraisal, financial, investment, or regulatory advice.