deals-export

실거래 CSV 내보내기 (/deals-export)

$ARGUMENTS 를 아래 규칙으로 해석해 deal-locator MCP 의 deals_export 도구를 호출하고, 생성된 CSV 경로와 모수 요약을 전한다. 기본이 역매칭(마스킹 지번 복원)이다 — DB·분석 파이프라인의 원천 데이터 용도이기 때문이다.

도구 한 번 호출은 최대 24개월이다. 그보다 긴 기간 요청은 이 스킬이 연 단위로 잘라 여러 번 호출해 연도별 파일로 확보한다(아래 4절).

1) 인자 해석

• 단기(24개월 이내) — 202607, 2026-07, 2026년 7월, 7월(연도 생략 시 올해)은 YYYYMM 으로 정규화해 year_month 에. 202601-202606, 1월~6월, 상반기는 year_month + year_month_to 로 한 번에 호출한다.
• 장기(24개월 초과) — 2006년부터, 2006~2020, 최근 10년, 전체 기간, 전기간 같은 표현이면 4절의 연 단위 오케스트레이션으로 넘어간다. 시작이 명시 안 된 "전체/전기간"은 2006년(실거래 신고 의무화 원년, 이보다 이전은 데이터 없음)부터, 끝이 명시 안 되면 현재 연월까지로 본다.
• 구 이름 — 강남구·강남 이 있으면 gu='강남구'(정식 명칭). 없으면 서울 25개 구 전체.
• 원본·마스킹 그대로·빠르게 류면 match=false(역매칭 없이 원본 1파일, 빠름). 그 외에는 기본값(match=true) 그대로.

예시:

• /deals-export 202607 → deals_export(year_month="202607") — 서울 전역, 복원본
• /deals-export 2026년 1월~6월 강남구 → year_month="202601", year_month_to="202606", gu="강남구"
• /deals-export 202607 원본 → match=false
• /deals-export 2006년부터 전체 → 4절 연 단위 오케스트레이션(2006~올해)

2) 답변 규칙 (반드시 지킬 것)

1. 파일 경로를 맨 앞에 전한다. 복원본(path)과 미복원본(path_unmatched) 둘 다. 고정 폴더(~/deal-locator-exports/, 날짜 하위폴더 없음)라 재실행 시 같은 경로를 덮어쓴다(멱등) — 파이프라인이 경로를 하드코딩해도 된다. utf-8-sig(엑셀 호환).
2. 파일 구성을 설명한다:
   • 복원본(rows_matched건) — 원본 마스킹 지번은 그대로 있고 복원지번· 대지위치_표제부·도로명대지위치_표제부·매칭단계·매칭신뢰도 컬럼이 추가됨. confidence_breakdown(정확매칭/추정매칭 건수)을 전한다.
   • 미복원본(rows_unmatched건) — 지번 특정 실패(역매칭실패사유 포함). 금액·면적은 실측값이므로 버리지 말라고 안내한다. 0건이면 파일이 없다(정상).
3. 모수를 함께 전한다 — rows_total · jiphap_excluded(집합 제외) · cancelled_count(해제신고 — 행은 남고 '해제사유발생일' 컬럼으로 구분).
4. 이 CSV 는 통건물(유형='일반')만 담는다. 집합(구분상가)은 취급 범위 밖(v1).
5. 시간 안내 — 서울 전역 역매칭은 동별 건축물대장 수신 때문에 콜드 캐시에서 수 분~수십 분. 큰 요청은 시작 전에 알리고, 빠르게 원본만 필요하면 원본 안내.
6. status 가 OK 가 아니면 그대로 전달. NOT_FOUND(데이터 부재·최근 월은 신고기한 30일로 아직 공개 전일 수 있음)·PARSE_ERROR 는 수치를 지어내지 않고 사유를 전한다.
7. 결과 끝에 도구가 준 source(출처 한 줄)를 유지한다.