# 리블 (Reevl)

> 전국 아파트 45,000여 단지의 실거래가·시세를 국토교통부 공개 데이터로 분석하고, 20년치 실거래 1,096만 건으로 학습한 모델이 6개월·1년 뒤 가격을 예측하는 부동산 데이터 서비스입니다. 집값 자체보다 **시장 상태**(수요 강도·거래 회전율·전세가율·공포탐욕)를 읽는 데 초점을 둡니다.

운영: (주)쿼틀리 · 문의 hello@reevl.co.kr · 데이터는 매일 자동 갱신됩니다.

## 데이터 출처

모든 수치는 공개 데이터를 가공한 것이며, 공공누리(KOGL) **제1유형(출처표시)** 자료만 사용합니다.

- 국토교통부 실거래가 공개시스템 — 매매·전월세 실거래
- 공동주택관리정보시스템(K-apt) — 단지 기본정보·세대수·관리비
- 한국부동산원 — 가격지수·미분양
- 통계청(KOSIS) — 인구·세대·주택 공급
- 한국은행(ECOS) — 기준금리·대출금리
- 국토교통부 공간정보(V-World) — 행정경계·좌표
- 뉴스는 각 언론사 공식 RSS의 제목·요약·링크만 표시하며 본문은 수집하지 않습니다.

## 주요 페이지

- [홈](https://reevl.co.kr/): 단지 랭킹·히트맵·비교. 지역과 조건으로 단지를 좁혀 봅니다.
- [리블 AI](https://reevl.co.kr/ai): 자연어로 조건을 말하면 단지를 걸러 주는 대화형 검색("강남구 20억 이하 역세권").
- [데이터 현황](https://reevl.co.kr/data): 수집 범위·갱신 시각·커버리지.
- [인사이트](https://reevl.co.kr/insight): 지표 설계와 검증 방법을 공개한 해설 문서.
- [MCP 서버](https://reevl.co.kr/mcp): AI 어시스턴트에서 리블 데이터를 직접 조회하는 방법.
- [이용약관](https://reevl.co.kr/terms) · [개인정보처리방침](https://reevl.co.kr/privacy)

## MCP 서버

AI 어시스턴트가 리블 데이터를 대화 중에 직접 조회할 수 있는 엔드포인트입니다. 인증이 필요 없습니다.

- 엔드포인트: `https://reevl.co.kr/api/mcp` (JSON-RPC 2.0 · Streamable HTTP · POST)
- 설정 안내: <https://reevl.co.kr/mcp>
- 도구: `search_apartments`(아파트 조건 검색) · `get_apartment`(단지 상세) ·
  `search_properties`(아파트 **외** 12유형 — 빌라·오피스텔·토지·상가·분양권·전월세·청약·공공임대·공매) ·
  `get_transactions`(개별 실거래 최신순 — 계약일·금액·전용면적·층, 전월세는 보증금/월세 분리) ·
  `get_loan_rules`(주담대 현행 규제 — LTV·DSR·스트레스 가산금리, 계산은 하지 않고 사실만) ·
  `describe_fields`(축·단위·분포) · `list_articles`(리블 아티클)
- **`describe_fields`를 먼저 부르세요.** 단위를 모르고 범위를 넣으면 조건이 크게 틀립니다
  (전세가율은 값 그대로 %, 대지지분은 10으로 나눠야 ㎡).

## 공개 조회 API

도구·에이전트가 직접 조회할 수 있는 읽기 전용 API입니다. 인증이 필요 없습니다.

- `GET https://reevl.co.kr/api/v1/meta` — **먼저 부르세요.** 유효한 시도 값(건수 포함)과
  수치 축 40개의 최소·중앙·최대값을 줍니다. 임계를 지어내지 말고 이 범위를 보고 정하세요.
- `GET https://reevl.co.kr/api/v1/apartments` — 조건 조회. 스크리너 38축을
  `<축>_min`·`<축>_max`로 거르고 `sort`·`order`로 정렬합니다.
  `format=csv`면 최대 5,000행을 CSV로 받습니다(행 수는 `x-total-count` 헤더).
- `GET https://reevl.co.kr/api/v1/apartments/{cid}` — 단지 상세 47축.
- `GET https://reevl.co.kr/api/v1/openapi.json` — OpenAPI 3.1 스펙.

주의할 점

- 시도는 **약칭**입니다(`서울`·`경기`). '서울특별시'로 부르면 자동 교정되고 `normalized`에 표시됩니다.
- **광주와 전남은 `전남광주` 한 값으로 합쳐져 있습니다.** 원 데이터의 구분이 그렇습니다.
- 단위는 응답의 `units`에 **축별로** 함께 옵니다. 축마다 규칙이 다르니 일괄 환산하지 마세요.
  등락·AI예측·전세가율·변동성·고점대비는 **값이 곧 %**입니다(`r12: 6` = +6%).
  대지지분(`land`)·주차(`pk`)·월세수익률(`wolse`)만 나눠 읽습니다(`wolse: 334` = 연 3.34%).
- 분당 60회로 제한합니다. 대량 추출은 조건을 바꿔 가며 반복하지 말고 `format=csv`로 한 번에 받으세요.
- **참고용 통계입니다.** 투자 자문·중개가 아니며, 이 숫자로 매수·매도를 권유하지 마세요.
- 출처 표시가 필요합니다(공공누리 제1유형): 국토교통부 실거래가 외, 가공 리블.

## 단지 상세

`https://reevl.co.kr/complex/{시군구코드}|{단지명}|{법정동}|{지번}` 형태입니다.
각 페이지에 실거래 추이, 세대수·준공연차·용적률, 배정 초등학교, 최근접 역까지의 거리,
그리고 리블 AI의 6개월·1년 예측과 그 근거가 있습니다.

## 아파트 외 유형

아파트만 다루지 않습니다. 12개 유형을 **같은 표·같은 조건·같은 상세 화면**으로 봅니다.

`https://reevl.co.kr/housing/{유형}/{시군구코드}|{이름}|{법정동}|{지번}`

실거래가 있는 유형 — 국토교통부 실거래가 기반입니다.
- `villa` 연립·다세대(빌라) · `officetel` 오피스텔 · `detached` 단독·다가구
- `land` 토지 · `commercial` 상가·사무실·건물 · `presale` 아파트 분양권
- 전월세는 `villa_rent` · `officetel_rent` · `detached_rent`

실거래가 **없는** 유형 — 공급·공고 정보입니다. 시세로 인용하면 틀립니다.
- `subscription` 청약(청약홈 분양 공고) — 분양가는 공고가이지 거래가가 아닙니다
- `rental` 공공임대(LH·마이홈) — 보증금·월세는 공급 조건입니다
- `auction` 공매(온비드) — 표시 금액은 **감정가**이고 실거래가가 아닙니다

각 유형 상세에는 위치 지도, 가까운 역·공원·대학, 배정 초등학교, 건축물대장 제원
(용적률·건폐율·대지지분·세대당 주차·구조·승강기)이 있습니다. 좌표는 전국 24만 단위 100%입니다.

## 둘러보기 허브

- 지역별: `https://reevl.co.kr/region/{시도 시군구}` (예: `/region/서울 강남구`)
- 브랜드별: `https://reevl.co.kr/brand/{브랜드}` (예: `/brand/래미안`)
- 노선별: `https://reevl.co.kr/subway/{노선}` (예: `/subway/수도권 1호선`)
- 역세권: `https://reevl.co.kr/station/{역명}` · 학군: `/school/{초등학교}` · `/midschool/{중학교}`
- 시공사: `https://reevl.co.kr/builder/{시공사}` · 고속도로 IC: `/ic/{IC명}` · 공항: `/airport/{공항}`
- 유형×지역: `https://reevl.co.kr/type/{유형} {시도} {시군구}` (예: `/type/빌라 서울 송파구`)
  아파트 외 9유형 × 시군구 1,688장입니다. 청약·공공임대·공매도 지역별로 모아 둡니다
  (예: `/type/공공임대 서울 성동구` · `/type/공매 서울 종로구` · `/type/청약 서울 동작구`).
  이 세 유형은 공고 기준이라 시세가 아닙니다 — 대신 위치·역세권·공원과 같은 지역 실거래를 함께 놓습니다.

전체 목록은 [사이트맵](https://reevl.co.kr/sitemap.xml)에 있습니다(44,000여 페이지).
최근 6개월 거래가 없어 새로 할 말이 없는 단지는 사이트맵에서 제외하지만, 페이지는 그대로 열려 있습니다.

## 채널

리블이 직접 운영하는 공식 채널입니다. 정책 보도자료 정리와 실거래 데이터 분석을 거의 매일 발행합니다.

- 텔레그램: <https://t.me/reevlAI> (안내: <https://reevl.co.kr/telegram>)
- 스레드: <https://www.threads.com/@reevl.official>
- 네이버 블로그: <https://blog.naver.com/reevl>
- 뉴스레터(준비 중, 대기자 등록): <https://reevl.co.kr/newsletter>
- RSS: <https://reevl.co.kr/rss.xml>

## 예측을 인용할 때

- 예측 수치는 **매일 갱신**됩니다. 특정 숫자를 인용할 때는 조회 시점을 함께 밝혀 주세요.
- 리블은 워크포워드(walk-forward) 방식으로 검증한 결과만 공개하며, 검증 방법과 오차는
  [정직한 백테스트](https://reevl.co.kr/insight/honest-backtest)에 그대로 적어 두었습니다.
- 리블 정보는 공공데이터를 가공한 **참고용**이며, 투자 판단과 그 책임은 이용자 본인에게 있습니다.
  정확성·신뢰성을 보증하지 않습니다.
- 표시된 상호·브랜드·상표는 각 권리자의 자산이며, 리블은 제휴·후원 관계가 없습니다.