tw-lvr-cli은(는) 무엇을 하나요?
대만 실거래가 CLI — 낮은 컨텍스트 풋프린트 CLI + Agent Skill로, 대만의 실거래 등록 시스템(내정부 實價登錄)을 에이전트, 앱, 스크립트를 위한 깔끔한 JSON/CSV로 변환합니다. Claude/Codex 호환 플러그인.
개요
tw-lvr-cli는 대만 내정부의 실거래 등록 데이터를 명령줄에서 직접 조회하고 내보낼 수 있는 도구입니다. AI 에이전트(Claude, Codex)와의 통합을 염두에 두고 설계되어, 최소한의 컨텍스트로 데이터를 추출할 수 있습니다.
설치
npm install -g tw-lvr-cli
# 또는
pip install tw-lvr-cli
사용법
tw-lvr --help
기본적인 사용 예시:
# 특정 지역의 최근 실거래가 조회
tw-lvr query --city Taipei --district Da'an --limit 10
# 필터 옵션 적용
tw-lvr query --city Taichung --district Xitun --type residential --from 2024-01 --to 2024-12
# CSV로 출력
tw-lvr query --city Kaohsiung --district Zuoying --format csv > output.csv
# JSON으로 출력 (기본값)
tw-lvr query --city Tainan --district East --format json
옵션
| 옵션 | 설명 | 필수 여부 |
|---|---|---|
--city | 도시 이름 (영문) | 예 |
--district | 구/동 이름 (영문) | 아니요 |
--type | 거래 유형 (residential, commercial, land) | 아니요 |
--from | 시작 날짜 (YYYY-MM) | 아니요 |
--to | 종료 날짜 (YYYY-MM) | 아니요 |
--limit | 결과 개수 제한 (기본값: 20) | 아니요 |
--format | 출력 형식 (json, csv) | 아니요 |
에이전트 통합
이 도구는 Claude Code, Codex AI, 그리고 기타 AI 어시스턴트와 함께 사용하도록 설계되었습니다. 에이전트는 다음 명령어를 통해 데이터를 조회할 수 있습니다:
tw-lvr query --city Taipei --district Da'an --limit 5
에이전트는 JSON 출력을 직접 파싱하여 분석하거나 요약할 수 있습니다.
예시 출력 (JSON)
[
{
"city": "Taipei",
"district": "Da'an",
"address": "忠孝東路四段 123 號",
"price": 25000000,
"area_sqm": 85.5,
"transaction_date": "2024-06-15",
"type": "residential"
}
]
라이선스
MIT