AI导哈

韩国房地产数据查询工具

通过MOLIT开放API提供韩国公寓、商业建筑等房地产交易和租赁数据查询服务，包含14+种查询工具。

  • by taewook486
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 taewook486/real-estate-mcp

使用说明

韩国房地产MCP

英语 | 韩语

向Claude询问韩国公寓价格-由MOLIT的开放式API提供支持。 提供14多种工具，用于查询公寓、办公楼、别墅、独栋房屋和商业贸易/租金数据、公寓订阅和公开拍卖。

支持的工具

  • [x] 公寓交易/租金(get_apartment_trades, get_apartment_rent)
  • [x] 办公楼交易/租赁(get_officetel_trades, get_officetel_rent)
  • [x] 别墅/多户住宅交易/租赁(get_villa_trades, get_villa_rent)
  • [x] 单户/多户交易/租赁(get_single_house_trades, get_single_house_rent)
  • [x] 商业建筑行业(get_commercial_trade)
  • [x] 公寓预订通知/结果(get_apt_subscription_info, get_apt_subscription_results)
  • [x] 公开竞价结果(get_public_auction_items)
  • [x] 在标项目查找(get_onbid_thing_info_list)
  • [x] 出价代码/地址查找(get_onbid_*_code_info, get_onbid_addr*_info)
  • [x] 区域代码查找(get_region_code)

新功能（v1.1.0）

网络可靠性

  • 指数回退重试：最多重试3次，初始1秒/最多延迟8秒
  • 断路器：连续5次失败时暂时停止呼叫（等待30秒）
  • 连接质量日志记录：响应超过10秒时自动记录

配置管理

  • 集中验证：基于Pydantic Settings的环境变量管理
  • 快速失败：在开始时验证所有必需的环境变量
  • 清除错误消息：提供有关变量名、说明和设置方法的详细错误信息

标准化错误处理

  • 6错误类型：configerror、invalid_input、network_error、api_error、parse_error、internal error
  • 用户友好建议：针对每种错误类型提供解决方案

性能优化

  • API响应缓存：5分钟TTL，最多100个项目的内存高速缓存
  • 输入验证：通过预验证本地代码/日期格式，减少不必要的API调用

先决条件

  • 紫外线
  • API密钥来自 公共数据门户 --申请以下服务：
    • 国土交通部_公寓交易室交易价资料
    • 国土交通部_公寓全月租资料
    • 国土交通部_写字楼买卖申报资料
    • 国土交通部_写字楼全月租资料
    • 国土交通部_联合多户交易室交易价资料
    • 国土交通部_联合多户全月租实际交易价资料
    • 国土交通部_单独/多户交易室交易价资料
    • 国土交通部_单独/多户全月租资料
    • 国土交通部_商业建筑（办公室）交易申报资料
    • 韩国资产管理公司_OnbidCamco卖空物品查询服务
    • 韩国资产管理公社_Onbid使用机关公卖物品查询服务
    • 韩国资产管理公司_Onbid代码查询服务
    • 订购主页APT公告（Applyhome InfoSvc、Applyhome StatSvc）

有关以hwp或docx格式解析API规范的信息，请参阅 常用工具指南

快速入门：克劳德桌面（stdio）

最快的入门方法是服务器作为Claude Desktop的子进程运行。

  1. 在本地克隆此存储库。

    git clone <repository_url>
cd real-estate-mcp

  2. 打开Claude Desktop配置文件。

    open "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

  3. 在下面添加条目 mcpServers.

    {
  "mcpServers": {
    "real-estate": {
      "command": "uv",
      "args": [
        "run",
        "--directory", "/path/to/real-estate-mcp",
        "python", "src/real_estate/mcp_server/server.py"
      ],
      "env": {
        "DATA_GO_KR_API_KEY": "your_api_key_here"
      }
    }
  }
}

  4. 重新启动克劳德桌面。 当您看到 real-estate 工具列表中的服务器。

  5. 为了获得更好的响应，请创建 项目 在Claude Desktop中粘贴 资源/自定义说明-ko.md 进入 项目说明 选项卡。

与其他客户建立联系

对于HTTP模式、其他客户端或每个服务API密钥配置，请参阅下面的文档。

客户 运输 指南
克劳德桌面 stdio/HTTP docs/setup-clude-desktop.md
Claude（网络） 仅限HTTP docs/setup-claude-web.md
Claude CLI 标准操作系统/HTTP docs/setup-claude-cli.md
Codex命令行界面 stdio/HTTP docs/setup-codex-cli.md
ChatGPT（网络） 仅限HTTP docs/setup-chatgpt-web.md
Docker（HTTP+Caddy） HTTP docs/setup-docker.md
OAuth（公共访问） -- docs/setup-oauth.md

相关 MCP