Korea Ground-Truth / Examples / real-estate

아파트 실거래가 — 단지명만으로 최근 거래 확인

Look up recent apartment transactions from just a name

사용자 → 에이전트

You: 래미안 개포 루체하임 2025년 7월 실거래가 확인해줘.
Agent (툴 2회 호출, 4 credits)

실거래가 API는 법정동코드 5자리가 필요합니다. 주소 검색이 lawd_code를 돌려주므로 에이전트가 사람에게 코드를 묻지 않습니다. 총 4 credits(40원).

호출 체인

search_address → apartment_trade_prices

실제 호출 trace (2026-08-27, 프로덕션)

1. search_address Cost: 1 credit/call (cache hit: 1).

→ tools/call search_address {"keyword":"래미안 개포 루체하임","per_page":1}
{
  "ok": true,
  "data": {
    "page": 1,
    "total": 1,
    "source": "행정안전부 도로명주소 (juso.go.kr)",
    "results": [
      {
        "ri": null,
        "sido": "서울특별시",
        "sigungu": "강남구",
        "adm_code": "1168011400",
        "lawd_code": "11680",
        "road_name": "개포로110길",
        "lot_sub_no": "0",
        "lot_main_no": "741",
        "postal_code": "06344",
        "eupmyeondong": "일원동",
        "road_address": "서울특별시 강남구 개포로110길 50 (일원동, 래미안 개포 루체하임)",
        "road_mgmt_no": "116804166041",
        "building_name": "래미안 개포 루체하임",
        "jibun_address": "서울특별시 강남구 일원동 741 래미안 개포 루체하임",
        "is_underground": false,
        "building_sub_no": "0",
        "english_address": "50 Gaepo-ro 110-gil, Gangnam-gu, Seoul",
        "is_mountain_lot": false,
        "building_main_no": "50",
        "building_mgmt_no": "1168011400106890001002803",
        "road_address_main": "서울특별시 강남구 개포로110길 50",
        "road_address_detail": " (일원동, 래미안 개포 루체하임)"
      }
    ]
  },
  "meta": {
    "tool": "search_address",
    "cost": 1,
    "balance_remaining": 123,
    "cache_hit": true,
    "source": "행정안전부 (juso.go.kr)",
    "fetched_at": "2026-08-27T09:00:00.000Z",
    "usage_event_id": "usg_…"
  }
}

2. apartment_trade_prices Cost: 3 credits/call (cache hit: 1).

→ tools/call apartment_trade_prices {"lawd_code":"11680","deal_month":"202507","per_page":100}
{
  "ok": true,
  "data": {
    "source": "국토교통부 아파트 매매 실거래가 (data.go.kr)",
    "lawd_code": "11680",
    "deal_month": "202507",
    "total": 376,
    "page": 1,
    "results": [
      {
        "apartment_name": "래미안 개포 루체하임",
        "deal_amount_krw": 3300000000,
        "deal_amount_raw": "330,000",
        "deal_date": "2025-07-11",
        "exclusive_area_m2": 84.97,
        "floor": 12,
        "build_year": 2018,
        "dong": "일원동",
        "jibun": "741",
        "road_name": null,
        "sigungu_code": "11680",
        "deal_type": "중개거래",
        "canceled": false,
        "canceled_date": null,
        "seller_type": "개인",
        "buyer_type": "개인"
      }
    ],
    "note": "376건 중 '래미안 개포 루체하임' 3건만 표시"
  },
  "meta": {
    "tool": "apartment_trade_prices",
    "cost": 3,
    "balance_remaining": 120,
    "cache_hit": false,
    "source": "국토교통부 (data.go.kr)",
    "fetched_at": "2026-08-27T09:00:00.000Z",
    "usage_event_id": "usg_…"
  }
}

직접 실행하기

# 1) 키 발급 (무료 50 credits)
curl -X POST https://kr-groundtruth-mcp.vercel.app/v1/accounts -H "content-type: application/json" -d '{"email":"you@example.com"}'
# 2) MCP 연결
claude mcp add --transport http kgt https://kr-groundtruth-mcp.vercel.app/api/mcp --header "Authorization: Bearer kgt_live_..."
# 3) Claude에게 그대로 말하기
"래미안 개포 루체하임 2025년 7월 실거래가 확인해줘."

다른 예시