data-realestate

Korea real estate actual transaction price lookup

Look up sale and jeonse/monthly rent actual transactions based on the Ministry of Land, Infrastructure and Transport (MOLIT) actual transaction price report data. Use it for business/investment analysis, location review, and asset valuation.

This skill is tae0y/real-estate-mcp (MIT) simplified into a guide via the NomaDamas k-skill-proxy.

When to use / When not to use

Use: actual transaction price/jeonse-monthly rent lookup, price trends by complex, price distribution by unit size, regional price comparison.

Do not use: overseas real estate, asking price/listing comparison (not actual transactions), tax/registration/brokerage legal advice, Cheongyak Home pre-sale/winning lookup.

Inputs

q: region name (region-code endpoint, e.g. "서울 강남구")
lawd_cd: 5-digit legal district code (transaction endpoint, e.g. "11680")
deal_ymd: 6-digit transaction year-month YYYYMM (e.g. "202403")
num_of_rows: number of results (default 100, max 1000)

Prerequisites

Required user-side secret None. It works as long as there is an internet connection.

KSKILL_PROXY_BASE_URL (optional): when using a self-hosted proxy. If left blank, the default hosted https://k-skill-proxy.nomadamas.org is used.
Operator-side DATA_GO_KR_API_KEYis kept only in the proxy server environment.

Supported endpoints

Region code lookup

GET /v1/real-estate/region-code?q={지역명}

Actual transaction price/jeonse-monthly rent lookup

GET /v1/real-estate/:assetType/:dealType?lawd_cd={코드}&deal_ymd={년월}

assetType	dealType	Description
`apartment`	`trade`	Apartment sale
`apartment`	`rent`	Apartment jeonse/monthly rent
`officetel`	`trade`	Officetel sale
`officetel`	`rent`	Officetel jeonse/monthly rent
`villa`	`trade`	Row house/multi-family house sale
`villa`	`rent`	Row house/multi-family house jeonse/monthly rent
`single-house`	`trade`	Detached/multi-household house sale
`single-house`	`rent`	Detached/multi-household house jeonse/monthly rent
`commercial`	`trade`	Commercial/office sale

commercial/rentis not supported.

Examples

# 지역코드 조회
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/real-estate/region-code' \
  --data-urlencode 'q=강남구'

# 아파트 매매 실거래가
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/real-estate/apartment/trade' \
  --data-urlencode 'lawd_cd=11680' \
  --data-urlencode 'deal_ymd=202403'

# 오피스텔 전월세
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/real-estate/officetel/rent' \
  --data-urlencode 'lawd_cd=11680' \
  --data-urlencode 'deal_ymd=202403'

Response shape

Sale:

{
  "items": [
    {
      "name": "래미안 퍼스티지",
      "district": "반포동",
      "area_m2": 84.99,
      "floor": 12,
      "price_10k": 245000,
      "deal_date": "2024-03-15",
      "build_year": 2009,
      "deal_type": "중개거래"
    }
  ],
  "summary": {
    "median_price_10k": 230000,
    "min_price_10k": 180000,
    "max_price_10k": 310000,
    "sample_count": 42
  }
}

Jeonse/monthly rent has the same structure + deposit_10k, monthly_rent_10k, contract_type. Price unit is ten thousand won (245000 = 2.45 billion won).

Response policy

region-codeFirst check the administrative district code with
If the user has not provided enough of the dong/building name/year-month, first fill in the region, complex name, and reference month.
Do not mix actual transaction prices with asking prices. This skill uses Ministry of Land, Infrastructure and Transport report data.
Leave the source (Ministry of Land, Infrastructure and Transport actual transaction price report) at the end of the answer.

Compact response rules

Region name + asset type + transaction year-month
summary.sample_count
Median/min/max
Top 3-5 representative transactions (name, area, floor, price, date)
For jeonse/monthly rent, summarize deposit + monthly rent

Failure modes

lawd_cd or deal_ymd format error → 400
On the proxy server, DATA_GO_KR_API_KEY missing → 503
upstream MOLIT API error → 502 + molit_api_XXX
no data → empty items array

Related skill chaining

before: moai-analyst:data-public — Assists location analysis with population and household statistics
after: moai-consultant:consult-market — Market analysis based on price data
after: moai-accountant:finance-investor-relations → moai-officer:doc-pptx — Investment IR materials
after: moai-marketer:marketing-landing-page — Data entry for real estate marketing pages

Done when

Selected the endpoint matching the asset type.
If needed, region-codechecked the region code first with
Retrieved and summarized actual transaction price and jeonse/monthly rent results.
Recorded the source (Ministry of Land, Infrastructure and Transport actual transaction price report).