tw-real-estate-mcp

MCP (Model Context Protocol) server for querying Taiwan real estate transaction data (實價登錄).

Provides AI assistants with access to Taiwan's official real estate price registration data, including property sales, pre-sales, and rental transactions.

Installation

Claude Desktop / Claude Code

Add to your MCP configuration:

{
  "mcpServers": {
    "tw-real-estate": {
      "command": "npx",
      "args": ["-y", "tw-real-estate-mcp"]
    }
  }
}

Manual

npm install -g tw-real-estate-mcp
tw-real-estate-mcp

Available Tools

| Tool | Description | |-----------------------|---------------------------------------------------| | list_cities | 列出所有可查詢的台灣縣市 | | list_towns | 列出指定縣市下的鄉鎮區 | | search_properties | 搜尋實價登錄交易紀錄 (支援價格、面積、類型等篩選) | | get_statistics | 取得區域統計 (均價、中位數、建物類型分布) | | list_available_data | 查詢可用的資料範圍 (區域、時段) | | get_price_trends | 取得跨季度價格趨勢 |

Data Types

| Type | Description | |------------|----------------------| | sale | 成屋買賣 (existing homes) | | pre_sale | 預售屋 (pre-sale) | | rent | 租賃 (rental) |

Example Queries

• "台北市信義區最近一季的房價行情"
• "新北市板橋區 2024 年 Q3 的公寓平均單價"
• "台中市近三年的房價趨勢"
• "高雄市鼓山區 1500 萬以下的物件"

Data Source

Data is sourced from Taiwan's Ministry of the Interior real estate price registration system (內政部實價登錄), processed and served from Cloudflare R2.

Cache

Query results are cached locally at ~/.tw-real-estate-mcp/cache/ with automatic TTL management. Cache can be cleared by deleting this directory.

License

MIT