RealPing
REST API · MCP · 為 agent 而生

別再自己清實價登錄

跨期去重、去車位去公設、品質旗標、110/7 schema 改版——這些你本來得自己踩的坑，我們都做好了。RealPing 以 REST API 與 MCP 交付乾淨的實坪每坪成交層，方法公開可稽核。

拿免費金鑰 互動式 API 文件 ↗

線上 7 季約 58 萬筆，每月自動更新。獨立第三方，不收建商錢。

自己接實價登錄，要踩的坑

政府批次是原始 CSV，要能「算行情」之前，這些每一項都得自己做對——而且資料一變就重來。

你本來得自己做

  • 跨期批次去重（同一筆會在多季出現，要取最新版）
  • 110/7 起 schema 改版，主建物／附屬建物面積欄位前後不一致
  • 從建物總面積拆出車位、拆出公設，才算得到實坪
  • 判斷特殊交易／多物件／含車位無價，否則單價全被污染
  • 處理登錄打錯年的髒日期、英文表頭列、編碼
  • 每月政府出新批次，整套重跑一遍

RealPing 已經做好

  • 跨期去重（同 編號 取最新期），一列一成交
  • 去車位、去公設的實坪每坪單價（招牌指標）
  • 三層單價對照：原始／去車位／實坪，看清差在哪
  • 每筆帶品質旗標，預設只回「實坪可用」乾淨資料
  • 公式公開可稽核（METHODOLOGY，附可重現範例），可自己驗一筆
  • 每月自動更新 + 上游格式預警，壞掉不發布、保留 last-good

全台約 58 萬筆裡，只有 ~19% 是「實坪可用」——其餘過半不能直接拿來算行情。把這層清乾淨，就是我們的價值。

30 秒上手

兩條路，挑一條。給 AI agent 用 → MCP（最快）；寫在你後端 → REST。

🤖 給 agent / Claude / Cursor：接 MCP

// 貼進 MCP client 設定，傳結構化參數、不經 URL
{ "mcpServers": { "realping": {
    "type": "http",
    "url": "https://mcp.realping.tw/mcp",
    "headers": { "Authorization": "Bearer YOUR_KEY" }
}}}

7 個工具直接可用。agent 自己帶參數，不用組 URL、沒有編碼問題。

🖥 寫在後端：REST（curl 範例，貼上即通）

# 純英數參數，複製貼上就能跑
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.realping.tw/parking?limit=3"

# → 各縣市單一車位成交中位（萬元）
# 臺北 250 / 新北 210 / 高雄 185 …

查詢值是中文（如 縣市=臺北市）時，放進 URL 要 percent-encode——用 Python requests / JS fetch 會自動處理（見 下方範例），別手刻。

乾淨層長這樣：同一間大安區華廈，官方每坪 165 萬、實坪每坪 278 萬（公設比 41%）——這就是「不能直接比官方單價」的具體落差。每個回應都帶 source（內政部出處）。

端點一覽

查詢邏輯只寫一次，REST 與 MCP 共用同一核心。除 /health 外需金鑰；超量回 429。

  • GET /transactions — 成交明細（分頁、排序、三層單價＋旗標）
  • GET /listings — 進階篩選反向找物件（疊加實坪單價／公設比／屋齡／總價／房數）
  • GET /area-stats — 區域行情（實坪中位／P25／P75＋平均公設比）
  • GET /address — 門牌關鍵字查成交
  • GET /building — 單棟公設比信用分（對照區中位回偏高／偏低）
  • GET /value-check — 看屋值不值得（比同型態行情＋議價建議）
  • GET /parking — 車位行情榜（單車位中位／四分位）
  • GET /comps-estimate — 同棟實坪估值（近 12/24 月同棟中位＋區間、信心分層）Pro・免費試用 30 次/月
  • GET /usage — 查自己金鑰當月用量與配額

主要回傳：實坪單價_萬元坪、去車位單價_萬元坪、原始單價_萬元坪、公設比、實坪、品質旗標、來源期別。完整 schema 見 互動式文件。

在你的程式裡用

沒有要你裝 SDK——標準 HTTP，幾行就接上。把 YOUR_KEY 換成你的金鑰。

Python

import requests

r = requests.get(
    "https://api.realping.tw/area-stats",
    params={"縣市": "臺北市", "區": "大安區"},
    headers={"X-API-Key": "YOUR_KEY"},
)
print(r.json())  # 實坪中位 / P25 / P75 + 平均公設比

JavaScript（Node / 瀏覽器）

const qs = new URLSearchParams({ 縣市: "臺北市", 區: "大安區" });
const r = await fetch(
  `https://api.realping.tw/area-stats?${qs}`,
  { headers: { "X-API-Key": "YOUR_KEY" } }
);
console.log(await r.json());

所有端點同一套：X-API-Key 標頭 + query 參數，回 JSON。完整參數見 互動式文件。

接 AI agent（MCP）

同一套查詢核心也以 MCP 提供 8 個工具，可直接掛進 Claude Desktop / Cursor，讓 agent 自己查台灣實坪行情。雲端模式用 bearer 金鑰（與 REST 同一把）。

// Claude Desktop / Cursor 設定
{
  "mcpServers": {
    "realping": {
      "url": "https://mcp.realping.tw/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

8 個工具

  • 查成交 · 進階篩選找物件 · 區域行情
  • 門牌查詢 · 單棟公設比信用分
  • 看屋值不值得 · 車位行情榜
  • 同棟實坪估值 Pro・免費試用 30 次/月

例：問 agent「台北大安區公設比低於 30%、實坪單價 250 萬以下的成交有哪些」，它會自己呼叫 進階篩選找物件。

誰在用 / 怎麼用

📊

估價 / proptech

省下自建清洗管線的數週工程，直接拿乾淨實坪行情當 AVM 前處理或比價基準。

🤖

AI agent / 工具

MCP 即插即用，讓你的 agent 具備「查台灣實坪行情、判斷值不值得」的能力。

🏢

研究 / 投顧

跨期去重、品質旗標、公開方法，可稽核——適合需要交代資料來源的分析。

🅿️

新角度資料

單棟公設比、車位行情、區落差排行——這些政府單筆試算器與一般網站給不了。

方案

先免費自助、用得上再洽談升級。以下為指示性起價，實際依用量／資料範圍微調。

🆓

Free（自助）

開發者試用、小工具

  • 自助即時發 key、零等待
  • 每月 1,000 次查詢（免費額度）
  • 全部 REST 端點 + MCP 工具
  • 同棟實坪估值試用 30 次/月
  • /usage 自己查用量
拿免費金鑰
🚀

Pro（API）

給穩定串接的產品

NT$1,500 / 月 起
  • 同棟實坪估值不限次數（免費層僅試用）
  • 含 30,000 次查詢 / 月（超量另計）
  • 多把金鑰，分專案計費
  • 開立收據、可簽約
  • 開發者直接對接支援
  • 更高用量依需求調整
升級洽詢 →
🏢

企業 / 資料授權

銀行估價・AVM・估價師・研究

年費 NT$10 萬 起
  • 批次全量交付（Parquet → GCS / 下載），不必逐筆 call
  • 可商用、可再散布給你的終端用戶（沿用內政部授權，標出處即可）
  • 方法公開可稽核，便於納入授信／估價流程
  • 客製欄位、專人對接
  • 依資料範圍與用途客製報價
來信洽談 →

資料為官方季更（非即時）。可用性採 best-effort 並承諾月更時程，暫不提供 uptime SLA。

為什麼可信

資料服務最怕「黑盒、會斷、過期」。這三點我們攤開講。

🔄

資料新鮮

每月 1/11/21 自動更新，含上游格式預警（canary）；壞掉不發布、保留 last-good。線上 7 季約 58 萬筆。

🔍

方法公開可稽核

每個數字怎麼算都寫在 METHODOLOGY，附可重現範例，你能自己驗一筆。不是黑盒。

⚖️

獨立第三方

不收建商 / 代銷錢，每個回應帶內政部出處。立場中立，只對「算得對」負責。

⚪

服務狀態

查詢中…

已經有金鑰？貼上查當月用量（資料不離開你的瀏覽器）

Early access · 免費

登入領免費金鑰

用 Google 或 GitHub 登入，立刻拿一把帶免費額度的金鑰，還能回來看用量、重發、撤銷。

企業 / 大量需求 → 來信洽談方案。獨立第三方、方法公開可稽核。資料來源：內政部不動產交易實價查詢服務網。