AI导哈

不动产实价查询服务

提供台湾（新北市为主）不动产实价登录资料查询功能，支持多维度筛选与统计分析。

  • by MackinHung
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 MackinHung/mcp-taiwan-realestate

使用说明

MCP Taiwan Realestate

MCP Server：台灣不動產實價登錄資料查詢

提供台灣（新北市為主）不動產實價登錄資料查詢功能，支援多維度篩選與統計分析。

工具清單

工具名稱 說明
search_transactions_by_area 依行政區查詢新北市不動產實價登錄成交案件
search_transactions_by_date 依日期範圍查詢不動產成交案件，可加價格篩選
get_area_price_statistics 取得區域房價統計：均價、中位數、最高最低、交易量
get_recent_transactions 取得最新一期不動產成交案件，依日期排序
get_price_trend 分析區域房價趨勢，提供月度或季度平均價與漲跌幅

安全徽章

  • 資料敏感度: public
  • 權限: readonly
  • 外部 API: data.ntpc.gov.tw
  • 開源: 是

安裝

npm install

使用方式

Cloudflare Workers 部署

npx wrangler deploy

MCP 協定

標準 MCP 協定流程：

  1. initialize → 取得 server 資訊與能力宣告
  2. tools/list → 列出所有可用工具
  3. tools/call → 呼叫指定工具

工具參數範例

search_transactions_by_area

{
  "district": "中和區",
  "limit": 20
}

search_transactions_by_date

{
  "start_date": "202501",
  "end_date": "202503",
  "city": "板橋區",
  "min_price": 5000000,
  "max_price": 15000000
}

get_area_price_statistics

{
  "district": "中和區",
  "property_type": "住家"
}

get_recent_transactions

{
  "district": "中和區",
  "limit": 20
}

get_price_trend

{
  "district": "中和區",
  "period": "monthly",
  "months_back": 12
}

技術棧

  • 框架: Hono + Cloudflare Workers
  • 語言: TypeScript (strict mode)
  • 測試: Vitest (95 tests, 100% pass rate)
  • 協定: MCP 2024-11-05

開發

本地測試

npm test

型別檢查

npx tsc --noEmit

本地開發

npm run dev

License

MIT

相关 MCP