中原地產 API 點用？Claude 接 Apify MCP，直接問「太古城叫價同成交價差幾多」
一句話： 將 Apify 官方 MCP 接上 Claude，你可以直接問「太古城而家叫價同最近成交差幾遠」，Claude 會自己呼叫
centaline-scraper攞中原嘅成交同放盤，再計中位數。我哋今日實跑一次：33 宗成交呎價中位數 $17,512，40 個叫價中位數 $17,373，成條問題約 0.17 美元、每次呼叫十一二秒。
點解要叫 Claude 去問，而唔係自己開中原網站
想知一個屋苑「叫價」同「真正成交」差幾遠，平時要開兩個頁面：一邊睇放盤、一邊睇成交紀錄，逐個單位抄呎價，再自己計平均或者中位數。做一次尚可，每個星期睇幾個屋苑就好煩。
中原冇對外公開嘅官方 API，所以搜尋「中原地產 API」其實搵緊嘅，多數係一個可以程式化攞到中原公開資料嘅方法。centaline-scraper 就係做呢樣嘢：將中原（同埋 28Hse）網站上公開顯示嘅放盤、成交紀錄整理成固定欄位嘅 JSON。再加上 Apify 官方 MCP，Claude 就可以當呢隻 actor 係自己一個 tool，你用廣東話問，佢自己決定要用邊個模式、填咩屋苑名。
如果你想睇欄位同模式嘅完整說明，可以先睇香港樓盤資料主題頁；呢篇專講「接上 Claude 之後實際點用、會撞到咩位」。
你需要咩
- 一個 Apify 帳號（免月費、按筆計費，免費額度可以先試）
- Claude Code，或者 Claude Desktop／claude.ai（任何支援 MCP 嘅 client 都得）
- 大約 5 分鐘
Step 1 — 接上 Apify 官方 MCP（hosted 版）
之前嘅做法係喺本機用 npx 開一個 stdio server（見巴哈姆特 × Claude Code 嗰篇）。而家 Apify 有 hosted 版，位於 https://mcp.apify.com，唔使裝任何嘢。
Claude Code 一行指令搞掂：
claude mcp add --transport http apify \
"https://mcp.apify.com/?tools=claude_code_reviewer/centaline-scraper,claude_code_reviewer/midland-scraper" \
--header "Authorization: Bearer $APIFY_TOKEN"$APIFY_TOKEN 係你喺 Apify Console 嘅 Settings → API & Integrations 攞到嘅 token。
後面嗰段 ?tools= 好重要：佢將 Claude 可以用嘅 actor 限制喺中原同美聯兩隻。唔加嘅話，預設會開放 search-actors、call-actor 等動態搜尋工具，Claude 可以自己喺 Store 搵任何 actor 去跑，方便但你就控制唔到佢會用邊隻、花幾多錢。限定之後，Claude 見到嘅 tool 只有呢幾個：centaline-scraper、midland-scraper，加上讀結果用嘅 get-dataset-items、get-actor-run 等。
Claude Desktop 或 claude.ai：Settings 入面加一個 custom connector，網址填 https://mcp.apify.com，按畫面用 OAuth 登入 Apify 帳號即可，唔使貼 token。
Step 2 — 直接問
接好之後，貼低面呢段 prompt（可以將太古城換成其他屋苑）：
你有 Apify 嘅 centaline-scraper 同 get-dataset-items 兩個 tool。請幫我比較「太古城」嘅現時叫價同近期成交價：
1. 用 centaline-scraper 嘅 transactions 模式，keywords 填「太古城」，dealType 為 buy，maxItems 40。
2. 再用 search 模式，source 填 centanet，keywords 填「太古城」，dealType 為 buy，maxItems 40。
3. 兩次 run 完之後，用 get-dataset-items 讀返 dataset。只讀你需要嘅欄位，唔好一次過攞晒所有欄位。
4. 成交紀錄入面有車位（building 係「車位」，面積同呎價係 null），計之前先篩走 net_unit_price 係 null 嘅紀錄。
5. 計出：成交呎價（實用面積）中位數、叫價呎價中位數，以及按 2 房／3 房分開嘅中位數。
6. 結果用一個細表格列出，列明成交日期範圍同樣本數目。
7. 最後補一段限制說明：樣本有幾多、涵蓋幾耐、邊啲位唔可以下結論。唔好預測樓價走勢。Claude 會先呼叫 tool、再讀 dataset、最後計數。你可以隨時追問，例如「3 房邊幾宗成交價最低？」
實測：太古城，33 宗成交 vs 40 個叫價
以下係 2026 年 10 月 12 日我哋真係跑過嘅一次（同一個 MCP、同一套 input）：
| 成交（transactions） | 叫價（search） | |
|---|---|---|
| 樣本 | 33 宗住宅成交（另有 7 筆車位已剔除） | 40 個現時放盤 |
| 日期範圍 | 2026 年 8 月 3 日至 10 月 6 日 | 2026 年 10 月 12 日快照 |
| 呎價中位數（實用面積） | $17,512 | $17,373 |
| 最低至最高 | $14,493 至 $22,237 | $14,716 至 $24,630 |
| 2 房中位數 | $17,032（19 宗） | $17,081（20 個） |
| 3 房中位數 | $19,786.5（14 宗） | $18,358（20 個） |
整體叫價中位數比近期成交中位數低約 0.8%；2 房兩邊大致持平（叫價高約 0.3%）；3 房叫價就比近期成交低約 7%。即係話，睇呢一批樣本，太古城依家放出嚟嘅 3 房，叫價呎價冇高過最近成交過嘅 3 房。
但呢個唔係市場走勢結論。 要老老實實講清楚限制：
- 叫價只係網站預設排序嘅頭 40 個，唔係全部放盤；
- 成交只有 33 宗、約兩個月，3 房得 14 宗，中位數好易被幾宗特別高或特別低嘅成交拉動；
- 只有太古城一個屋苑；
- 叫價中位數低過成交中位數，可以係叫價真係偏低，亦可以係放盤單位嘅樓層、座向同成交單位唔同，呢個樣本分辨唔到。
所以呢個結果最適合當「睇樓前快速對一對」，唔好當成升跌訊號。想睇趨勢，要將同一個問題用排程重複跑，儲夠幾個月先有意思；大盤指數同屋苑之間嘅落差，可以睇CCL 指數升 12%，沙田第一城照蝕讓嗰篇。
Agent 實際會撞到嘅三個位
呢次跑嘅時候，有三樣嘢如果 prompt 冇寫清楚，Claude 好容易行錯路。
1. 成交紀錄入面混咗車位。 40 筆成交裡面有 7 筆係車位，面積同所有呎價欄位都係 null。冇叫佢篩走嘅話，中位數會被拉歪，甚至因為 null 計算出錯。上面 prompt 第 4 點就係為咗呢樣。
2. 美聯唔可以用屋苑名搜。 midland-scraper 只接受 regions（港島、九龍、新界）、bedrooms、bathrooms、schoolNet 等地區級篩選，官方接口對屋苑名或關鍵字係靜默忽略（唔會報錯，只係當冇呢個參數）。想用美聯資料對某個屋苑，要叫 Claude 先攞成個地區，再用輸出入面嘅 estate 欄位自己篩。所以如果你要問「某個屋苑」，首選 centaline-scraper。想知三個代理邊個做到咩，可以睇中原／美聯／28Hse 核實放盤真偽嗰篇嘅對照表。
3. tool 回覆嘅係摘要，唔係資料。 呼叫 actor 之後，Claude 收到嘅係：run ID、狀態、一句摘要、dataset ID，同一句提示「用 get-dataset-items 去讀 items」。真正嘅紀錄要由 Claude 再呼叫 get-dataset-items 先讀到，而且可以用 fields 只揀需要嘅欄位。好處係唔會一次將幾十筆、每筆二十幾個欄位全部塞入對話；壞處係你 prompt 如果冇提，agent 有機會淨係睇咗摘要就作答，變成「有答案但冇數據」。所以 prompt 第 3 點明確要求讀 dataset。
實際要花多少
呢個 MCP 本身唔額外收費，你付嘅就係 actor 平時嘅 PPE 價錢：
| 項目 | 數量 | 單價 | 小計 |
|---|---|---|---|
成交紀錄（search-listing 事件） | 40 | $0.002 | $0.08 |
現時叫價（search-listing 事件） | 40 | $0.002 | $0.08 |
| 兩次 run 嘅啟動費（Apify 平台自動收） | 2 | $0.005 | $0.01 |
| 合計 | 約 $0.17 |
時間方面，兩次 tool call 由發出到收到回覆分別係 11 秒同 12 秒（actor 本身運行約 5.5 及 6.6 秒）。以上係付費用戶嘅實際開支；免費額度內嘅話，可以免費試。若然你每個星期都想睇十個屋苑，按上面單價推算（唔係實測），大約每個星期 1.7 美元。
進階：由問一次變成每週追蹤
單次問答只係快照。如果你有幾個長期關注嘅屋苑，可以喺 Apify 設排程，每個星期固定跑同一組 input（transactions 模式用 dateFrom 只攞新增成交），結果疊落同一個 dataset；之後叫 Claude 用 get-dataset-items 讀返成條時間軸，問「呢三個月叫價同成交差距有冇收窄」，先至有走勢可言。
三條路，挑一條開始
從最省事到最自由
FAQ
中原地產有冇官方 API？ 中原冇對外公開嘅官方 API。centaline-scraper 係第三方 Apify actor，讀嘅係中原網站上公開顯示嘅放盤同成交紀錄，再整理成固定欄位嘅 JSON；Claude 透過 Apify 官方 MCP 呼叫呢隻 actor，就等於有咗一個可以用自然語言問嘅「樓價 API」。
用 MCP 問一次太古城要幾多錢？ 今次實測，成交 40 筆加叫價 40 筆共 80 筆，每筆 $0.002（search-listing 事件），加上兩次 run 各 $0.005 嘅啟動費（Apify 平台自動收），合共約 $0.17。MCP 本身唔額外收費，費用同你喺 Console 手動跑一樣。每次 tool call 由發出到回覆大約 11 至 12 秒。
點解 Claude 話有幾筆成交冇呎價？ 因為 transactions 模式回傳嘅紀錄包括車位成交。今次 40 筆入面有 7 筆 building 係「車位」，面積同呎價欄位全部係 null。叫 Claude 先篩走 net_unit_price 係 null 嘅紀錄再計中位數，否則會混入車位價錢。
可以用美聯 midland-scraper 問某個屋苑嘛？ 唔可以直接用屋苑名搜。美聯官方接口只接受地區級篩選（例如港島、九龍、新界），屋苑名或關鍵字會被靜默忽略。你可以叫 Claude 先攞成個地區嘅資料，再自己用輸出入面嘅 estate 欄位篩出目標屋苑；要直接按屋苑名搜，用 centaline-scraper。
呢個結果可以當成樓價走勢嘅證據嗎？ 唔可以。今次係 2026 年 10 月 12 日嘅一個快照：一個屋苑、約兩個月內嘅 33 宗成交，加上網站預設排序頭 40 個叫價，唔係全部放盤。佢可以話你知依家呢個屋苑叫價同近期成交大概差幾遠，但唔代表升市或者跌市，更加唔係投資建議。
延伸閱讀
- 中原地產放盤係真定假？用原始樓盤資料核實代理話術：同一個屋苑，點樣用
deal_type、刊登時間同成交價去核實一個放盤。 - CCL 指數話全年樓價升 12%，沙田第一城照樣蝕 100 萬沽：大盤指數同單一屋苑之間嘅落差。
- 香港樓盤資料主題頁：所有香港樓盤 actor 同教學嘅入口。
作者 Chad 實際經營 30 多隻上架 Apify actor（含本文用到嘅 centaline-scraper、midland-scraper）。文中太古城數字來自 2026 年 10 月 12 日經 Apify 官方 MCP 實跑嘅 run，成本同時間都係該次記錄；只有「每星期十個屋苑」嗰句係按單價推算。