Korean Real Estate Transactions

韩国房地产交易 MCP

한국어 · English

远程 MCP 服务：https://realestate-api.goyostudio.io/mcp（Streamable HTTP，无需身份验证）

此仓库仅包含文档和注册表元数据。服务由 goyostudio 运营；其源代码未在此处发布。

---

한국어

功能介绍

这是一个远程 MCP 服务，可根据用户用自然语言询问的韩国地址或公寓小区名称，返回韩国国土交通部的实际交易价格公开数据（data.go.kr）。支持买卖、全租和月租、期间统计（平均值、最低值、最高值）、月度趋势和专有面积筛选。无需 API 密钥。

端点

项目	值
URL	https://realestate-api.goyostudio.io/mcp
传输方式	Streamable HTTP（无状态，仅支持 POST；GET 返回 405）
身份验证	无
工具	get_korean_real_estate_transactions（1 个）

示例问题

• “江南区大峙洞银马公寓买卖”
• “麻浦区公寓全租月度趋势” → groupBy: "month"
• “松坡区 Helio City 专有面积 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 字段。
• 本服务不是政府官方服务，与韩国国土交通部无关。
• 按“原样”提供，不作任何保证。申报内容更正或撤销后，数值可能发生变化。本服务不构成投资、法律或税务建议。
• 条款：https://realestate-api.goyostudio.io/terms

---

English

功能介绍

这是一个远程 MCP 服务，可根据用户用自然语言询问的韩国地址或公寓小区，返回韩国国土交通部（MOLIT，通过 data.go.kr 提供）的官方房地产交易记录。涵盖买卖、全租和月租、期间统计（平均值／最低值／最高值）、月度趋势和专有面积筛选。无需 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）。

数据来源与免责声明

• 来源：韩国国土交通部实际交易价格公开系统（MOLIT），通过 data.go.kr OpenAPI 提供。每个响应都包含 source 字段。
• 本服务与韩国国土交通部或任何政府机构无关，亦非由其运营或认可。
• 按“原样”提供，不作任何保证。官方申报记录可能在发布后更正或撤销。本服务不构成投资、法律或税务建议。
• 条款：https://realestate-api.goyostudio.io/terms

许可证

本仓库中的文档：MIT。服务返回的数据受条款和 data.go.kr 原始条款约束。