香港中原地產＋28Hse 爬蟲｜樓盤搜尋、物業詳情一鍵下載（免 API、免登入）

抓取香港中原地產（hk.centanet.com）及 28Hse（28hse.com）的公開物業資料，一個 Actor 涵蓋兩個最大港產放盤平台。支援關鍵字搜尋（買盤/租盤）與中原樓盤詳情兩種模式，全程走公開 JSON/HTML API，不需登入、不需帳號、不需 API token。

---

輸出欄位

欄位	類型	說明
property_id	string	物業唯一編號（中原 refNo 或 28Hse ID）
source_site	string	資料來源：centanet 或 28hse
title	string | null	樓盤標題（屋苑 + 大廈名）
district	string | null	地區（如：太古城、九龍城）
address	string | null	街道地址
estate_name	string | null	屋苑名稱
deal_type	string	buy（買盤）或 rent（租盤）
price	number | null	售價（港幣，買盤才有）
rent	number | null	月租（港幣，租盤才有）
currency	string	固定 HKD
area_sqft	number | null	建築面積（平方呎）
area_saleable	number | null	實用面積（平方呎）
price_per_sqft	number | null	呎價（港幣 / 平方呎）
room_layout	string | null	房間數，如 2 Bedrooms、Studio
floor	string | null	樓層描述，如 高層 F室
direction	string | null	朝向，如 西南
building_age	number | null	樓齡（年）
agent_name	string | null	代理姓名
agent_phone	string | null	代理電話
image_urls	string[]	物業圖片 URL 陣列
property_url	string	物業詳情頁面網址
source_mode	string	search 或 detail
source_query	string	搜尋關鍵字或物業 ID
scraped_at	string	抓取時間（ISO 8601）

---

模式

mode	說明	輸入	計費
search	關鍵字搜尋，同時查詢中原及 28Hse（可選擇單一來源）	keywords[] + dealType	$0.002 / 筆
detail	中原樓盤完整詳情（需要物業編號）	propertyIds[] 或 propertyUrls[]	$0.008 / 筆

注意：成交紀錄（transaction）模式為 v1.1，尚未實作。

---

輸入參數

參數	類型	預設	說明
mode	string	自動偵測	search 或 detail
keywords	string[]	—	搜尋關鍵字，如 ["太古城", "九龍城"]
dealType	string	buy	buy（買盤）或 rent（租盤）
source	string	both	centanet、28hse 或 both
propertyIds	string[]	—	中原物業編號，如 ["CLL467", "DAJ422"]
propertyUrls	string[]	—	中原物業詳情頁網址
bulkInput	string	—	一行一個關鍵字或 ID，自動合併
priceMin	number	—	最低價格（港幣）
priceMax	number	—	最高價格（港幣）
areaMin	number	—	最小面積（實用平方呎）
maxItems	number	50	最多筆數（上限 500）

---

使用範例

範例 1：太古城買盤搜尋（兩站合併）

{
    "mode": "search",
    "keywords": ["太古城"],
    "dealType": "buy",
    "source": "both",
    "maxItems": 50
}

範例 2：九龍城租盤搜尋（只抓中原）

{
    "mode": "search",
    "keywords": ["九龍城", "馬頭圍"],
    "dealType": "rent",
    "source": "centanet",
    "priceMin": 15000,
    "priceMax": 30000,
    "maxItems": 100
}

範例 3：按物業編號抓詳情

{
    "mode": "detail",
    "propertyIds": ["CLL467", "DAJ422", "DAR140"],
    "maxItems": 100
}

---

注意事項

• 只抓取公開資料，無需登入或帳號
• 中原地產及 28Hse 的公開 API 端點均以 POST 形式呼叫
• 因 Crawlee 爬蟲排程關係，同一搜尋字可能出現跨頁去重（property_id 層級）
• search 模式抓取兩站資料，property_id 格式不同（中原為英數字組合如 CLL467，28Hse 為純數字）
• detail 模式僅支援中原地產（28Hse 無公開詳情 API）
• 每次 Run 固定扣除 $0.005 啟動費，再依實際抓取筆數計費

---

FAQ

Q：可以同時搜尋買盤和租盤嗎？ A：目前每次 Run 只能選一種 dealType。如需兩者，請分開執行兩次。

Q：搜尋結果數量為什麼比預期少？ A：maxItems 上限為 500。若搜尋關鍵字太廣，系統會在連續 5 頁無新資料後自動停止，節省費用。

Q：detail 模式怎麼取得物業編號？ A：從中原地產網站物業頁面 URL 擷取（格式如 CLL467），或先用 search 模式取得 property_id 欄位後再使用 bulkInput 貼入。

Q：28Hse 有沒有呎價資料？ A：有，price_per_sqft 欄位對 28Hse 搜尋結果同樣有效（實用呎價）。

---

免責聲明

本 Actor 僅抓取各網站公開頁面資料，用於研究、分析及資料整合用途。使用者須遵守中原地產及 28Hse 的服務條款。資料準確性以原始網站為準，本 Actor 不對任何投資決策負責。

---

中原地產 爬蟲、28Hse 爬蟲、香港樓盤、CCL 中原城市指數、香港房價、物業數據、HK property scraper、Centaline scraper