# rtms-mcp

한국 아파트 매매 실거래가(국토교통부 RTMS) 데이터를 조회하는 MCP 서버입니다.

## 특징

- **토큰 절약**: 한글 필드명 변환, 공백 없는 압축 JSON, 필요 필드만 반환
- **간편 사용**: 도구 1개, 파라미터 2개(지역코드 + 계약년월)만으로 조회

## 조회 가능 데이터

아파트 매매 실거래가: 단지명, 전용면적, 거래금액, 층, 건축년도, 거래유형, 매도자/매수자 구분 등

## 설치 및 실행

### 사전 준비

[공공데이터포털](https://www.data.go.kr/data/15126469/openapi.do)에서 "아파트 매매 실거래가 자료" API 키를 발급받으세요.

### Claude Desktop

`claude_desktop_config.json`에 추가:

```json
{
  "mcpServers": {
    "rtms": {
      "command": "npx",
      "args": ["rtms-mcp"],
      "env": {
        "DATA_GO_KR_API_KEY": "발급받은_API_키"
      }
    }
  }
}
```

### Claude Code

```bash
claude mcp add rtms -- npx rtms-mcp
```

### 직접 실행

```bash
DATA_GO_KR_API_KEY=발급받은_API_키 npx rtms-mcp
```

## 파라미터

| 파라미터 | 필수 | 설명 |
|----------|:----:|------|
| `lawd_cd` | O | 지역코드 (법정동코드 앞 5자리) |
| `deal_ymd` | O | 계약년월 (YYYYMM 6자리) |
| `num_of_rows` | | 결과 수 (기본 20) |
| `page_no` | | 페이지 번호 (기본 1) |

## 응답 예시

```json
{"total_count":50,"items":[{"지역코드":"11680","법정동":"역삼동","단지명":"역삼래미안","전용면적":"84.92","거래금액만원":"230,000","층":"12","건축년도":"2004","거래유형":"중개거래","매도자":"개인","매수자":"개인"}]}
```

## API 원본

- [국토교통부 아파트 매매 실거래가 자료 (공공데이터포털)](https://www.data.go.kr/data/15126469/openapi.do)

## 라이선스

MIT