韓国不動産検索

このスキルがすること

基本的に https://k-skill-proxy.nomadamas.org/v1/real-estate/... にリクエストして、韓国の不動産実取引価格/賃借料データを照会します。国土交通部(MOLIT)の実取引価格申告データに基づいています。

使用場面

• 「蚕室 リセンツ 2024年売買実取引価格を探して」
• 「麻浦区 アパート チョンセ実取引価格を見せて」
• 「城水洞 オフィステル 月賃 実取引データを見たい」
• 「江南区 連立多世帯 売買実取引価格」
• 「龍山区 商業業務用 建物 取引内訳」

使用しない場面

• 海外不動産時価/取引照会
• 実取引価格ではなく民間呼値/売り物比較が必要な場合のみ
• 税金/登記/仲介 法律相談のような判断が必要な場合
• 青約ホーム分譲/当選照会 (未対応)

入力値

• q: 地域名 (region-code endpoint、例: "ソウル 江南区"、"麻浦区")
• lawd_cd: 5桁の法定洞コード (transaction endpoint、例: "11680")
• deal_ymd: 6桁の取引年月 YYYYMM (例: "202403")
• num_of_rows: 照会件数 (デフォルト 100、最大 1000)

前提条件

なし。ユーザーが別途 API キーを準備する必要はありません。upstream キーはプロキシサーバーでのみ注入されます。

デフォルトパス

追加クライアント API レイヤーは不要です。単にプロキシサーバーに HTTP リクエストを送るだけです。

KSKILL_PROXY_BASE_URL 環境変数があればその値を使用し、なければデフォルトパス https://k-skill-proxy.nomadamas.org を使用します。

サポートされるエンドポイント

地域コード照会

GET /v1/real-estate/region-code?q={地域名}

実取引価格/賃借料照会

GET /v1/real-estate/:assetType/:dealType?lawd_cd={コード}&deal_ymd={年月}

assetType	dealType	説明
apartment	trade	アパート売買
apartment	rent	アパート チョンセ/月賃
officetel	trade	オフィステル売買
officetel	rent	オフィステル チョンセ/月賃
villa	trade	連立多世帯売買
villa	rent	連立多世帯 チョンセ/月賃
single-house	trade	単独/多家族売買
single-house	rent	単独/多家族 チョンセ/月賃
commercial	trade	商業業務用売買

commercial/rent はサポートされていません。

リクエスト例

地域コード照会:

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'

レスポンス形式

地域コード応答

{
  "results": [
    { "lawd_cd": "11680", "name": "ソウル特別市 江南区" }
  ],
  "query": "江南区",
  "proxy": { "name": "k-skill-proxy", "cache": { "hit": false, "ttl_ms": 300000 } }
}

売買実取引価格応答

{
  "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
  },
  "query": { "asset_type": "apartment", "deal_type": "trade", "lawd_cd": "11680", "deal_ymd": "202403" },
  "proxy": { "name": "k-skill-proxy", "cache": { "hit": false, "ttl_ms": 300000 } }
}

チョンセ/月賃応答

売買と同じ構造ですが、アイテムに deposit_10k、monthly_rent_10k、contract_type が含まれ、summary に median_deposit_10k、monthly_rent_avg_10k などが入ります。

レスポンスポリシー

• 実取引価格/賃借料リクエストの場合、region-code エンドポイントで行政区域コードを先に確認した後、資産タイプ別エンドポイントで照会します。
• アパート売買は apartment/trade、アパート チョンセ/月賃は apartment/rent を優先使用します。
• オフィステル/ビラ/単独住宅/商業業務用は資産タイプに合致するエンドポイントにルーティングします。
• ユーザーが洞/建物名/年月を不十分に提供した場合は、地域、団地名、基準月を先に補強します。
• 実取引価格と呼値を混同しません。このスキルは国土交通部ベースの実取引/チョンセ月賃申告データを扱います。

回答をコンパクトに保つ

• 地域名 + 資産タイプ + 取引年月
• 取引件数 (summary.sample_count)
• 価格要約: 中央値、最小、最大
• 上位 3～5件の代表的な取引 (名前、面積、階数、価格、日付)
• チョンセ/月賃の場合、保証金 + 月賃要約も含める

障害モード

• lawd_cd または deal_ymd 形式が間違っている場合、400 レスポンス
• プロキシサーバーに DATA_GO_KR_API_KEY がない場合、503 レスポンス
• upstream MOLIT API エラーの場合、502 + molit_api_XXX エラーコード
• 該当地域/期間にデータがない場合、空の items 配列を返却

完了条件

• リクエスト資産タイプに合致するエンドポイントを選択した。
• 必要に応じて region-code で地域コードを先に確認した。
• 実取引価格/チョンセ月賃結果を照会して要約した。
• 元データ出典(国土交通部実取引価格申告)を記載した。

注記

• 参考元: https://github.com/tae0y/real-estate-mcp/tree/main
• 公式データ出典: 公共データポータル (https://www.data.go.kr)
• 価格単位: price_10k、deposit_10k = 万ウォン単位 (例: 245000 = 24億 5千万ウォン)
• キャンセル取引はサーバーで自動フィルタリングされます。