Korean Real Estate Transactions

韓国不動産取引 MCP

日本語 · 英語

リモート MCP サーバー：https://realestate-api.goyostudio.io/mcp（Streamable HTTP、認証不要）

このリポジトリにはドキュメントとレジストリのメタデータのみが含まれています。サーバーはgoyostudioが運営しており、ソースコードはここでは公開されていません。

---

日本語

できること

韓国の住所やマンション名を自然な言葉で尋ねると、国土交通部の実取引価格公開データ（data.go.kr）を返すリモート MCP サーバーです。売買・チョンセ・月払い家賃、期間統計（平均・最低・最高）、月別推移、専有面積の条件に対応しています。API キーは不要です。

エンドポイント

項目	値
URL	https://realestate-api.goyostudio.io/mcp
通信方式	Streamable HTTP（ステートレス、POSTのみ。GETは405）
認証	なし
ツール	get_korean_real_estate_transactions（1つ）

質問の例

• 「江南区大峙洞のウンマアパートの売買」
• 「麻浦区のマンションのチョンセの月別推移」→ groupBy: "month"
• 「松坡区のヘリオシティ、専有面積84」→ areaMin: 84, areaMax: 86

ツール呼び出しの例：

{
  "name": "get_korean_real_estate_transactions",
  "arguments": { "q": "강남구 대치동 은마 아파트 매매", "limit": 5 }
}

地域が曖昧な場合、HTTP 422とcandidates[]が返されるため、その候補を指定して再度呼び出します。推定内容はresolved_noteに、データが欠けている月はmissing_monthsに表示されます。詳しくはdocs/usage.mdをご覧ください。

クライアントの設定

Cursor（~/.cursor/mcp.jsonまたはプロジェクトの.cursor/mcp.json）：

{
  "mcpServers": {
    "korean-real-estate": {
      "url": "https://realestate-api.goyostudio.io/mcp"
    }
  }
}

Claude Desktop：設定 → コネクター → カスタムコネクターを追加から、URL https://realestate-api.goyostudio.io/mcpを入力します。リモートコネクターを利用できない環境では、claude_desktop_config.jsonでmcp-remoteを使用します。

{
  "mcpServers": {
    "korean-real-estate": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://realestate-api.goyostudio.io/mcp"]
    }
  }
}

Claude Code：claude mcp add --transport http korean-real-estate https://realestate-api.goyostudio.io/mcp

利用制限

IPあたり10秒間に50リクエストです。上限を超えると、HTTP 429とRetry-Afterヘッダーが返されます。指定された秒数だけ待ってから再試行してください。現在は無料です。将来的にx402プロトコルに基づく少額課金が導入される可能性があります（現在の状態：/openapi.jsonのx-pricing）。

データソースと免責事項

• データソース：国土交通部実取引価格公開システム、data.go.kr OpenAPI。すべての応答にsourceフィールドが含まれています。
• 政府の公式サービスではなく、国土交通部とは関係ありません。
• 無保証（AS-IS）。届出の訂正・取り消しにより、数値が変わることがあります。投資・法律・税務に関する助言ではありません。
• 利用規約：https://realestate-api.goyostudio.io/terms

---

英語

できること

韓国の住所やマンションについて自然な言葉で質問すると、国土交通部（MOLIT）が公開する公式の不動産取引記録（data.go.kr経由）を返すリモート MCP サーバーです。売買、チョンセ、月払い家賃、期間統計（平均・最小・最大）、月別推移、専有面積の条件に対応しています。API キーは不要です。

エンドポイント

項目	値
URL	https://realestate-api.goyostudio.io/mcp
通信方式	Streamable HTTP（ステートレス、POSTのみ。GETは405を返します）
認証	なし
ツール	get_korean_real_estate_transactions（ツール1つ）

例

{
  "name": "get_korean_real_estate_transactions",
  "arguments": { "q": "강남구 대치동 은마 아파트 매매", "limit": 5 }
}

クエリqには韓国語を指定します。場所が曖昧な場合は、HTTP 422とcandidates[]が返されるため、その候補のいずれかを指定して再度呼び出します。推定内容はresolved_noteに、データの欠落箇所はmissing_monthsに表示されます。docs/usage.mdをご覧ください。

クライアントの設定

Cursor（~/.cursor/mcp.jsonまたは.cursor/mcp.json）：

{
  "mcpServers": {
    "korean-real-estate": {
      "url": "https://realestate-api.goyostudio.io/mcp"
    }
  }
}

Claude Desktop：設定 → コネクター → カスタムコネクターを追加から、URL https://realestate-api.goyostudio.io/mcpを入力します。リモートコネクターを利用できない場合は、claude_desktop_config.jsonでmcp-remoteを使用します。

{
  "mcpServers": {
    "korean-real-estate": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://realestate-api.goyostudio.io/mcp"]
    }
  }
}

Claude Code：claude mcp add --transport http korean-real-estate https://realestate-api.goyostudio.io/mcp

リクエスト制限

**IPあたり10秒間に50リクエストです。**上限を超えると、HTTP 429とRetry-Afterヘッダーが返されます。指定された秒数だけ待ってから再試行してください。現在は無料です。将来的にx402プロトコルによるリクエストごとの少額課金が導入される可能性があります（現在の状態：/openapi.jsonのx-pricing）。

データソースと免責事項

• データソース：data.go.kr OpenAPI経由の国土交通部実取引価格公開システム（MOLIT）。すべての応答にsourceフィールドが含まれています。
• MOLITまたは政府機関との提携関係はなく、運営や推奨も受けていません。
• 現状有姿で提供され、保証はありません。公式の届出内容は、公開後に訂正または取り消される場合があります。投資・法律・税務に関する助言ではありません。
• 利用規約：https://realestate-api.goyostudio.io/terms

ライセンス

このリポジトリのドキュメントはMITライセンスです。サービスが返すデータには、利用規約および元の data.go.kr の利用規約が適用されます。