在 ChatGPT、Claude 裡直接問房價
設定一次之後,在 AI 對話裡問「這間開價合理嗎」「我家大概值多少」「這個社區最近成交多少」,AI 會查 ToEstate 的實價登錄與統計來回答你, 而且附上資料來源——不是網路上的二手資訊。免費、不用註冊。
- ・需要:一個支援「自訂連接器」的 AI(ChatGPT 需開啟開發者模式;Claude 需支援此功能的方案)。
- ・設定:複製下面這一行網址,照下方步驟貼到 AI 的設定裡,約 3 分鐘。
https://toestate.tw/mcp
技術資訊:MCP(Model Context Protocol)遠端伺服器,Streamable HTTP,免金鑰。
三分鐘接上
選你用的 AI(多數人用 ChatGPT 或 Claude),照步驟貼上連線網址即可。
- 打開 ChatGPT 的「設定」,找到「連接器」或「應用程式與連接器」,在進階設定中開啟「開發者模式(Developer mode)」。找不到這個選項,代表你目前的 ChatGPT 方案還不支援自訂連接器。
- 新增連接器:名稱填 ToEstate,伺服器網址貼上下方連線網址,驗證方式選「無」(不需要帳號密碼)。
- 開新對話,在工具選單選用 ToEstate,然後直接用中文問,例如「新北市新莊區中正路500號,屋齡25年、30坪,開價1500萬合理嗎?」(附上屋齡,結論會更明確)
https://toestate.tw/mcp
選單名稱會隨 ChatGPT 更新而變動,以 ChatGPT 最新介面為準。
可以這樣問
直接用中文描述需求,AI 會自己挑工具、組合查詢(下方灰字是給好奇的人看的工具名稱,不用記)。
「我家在新北市永和區竹林路 100 號 4 樓,老公寓大約 30 坪,現在大概能賣多少?(記得門牌;只有路名時 AI 會改查這條路的成交)」
analyze_property/search_transactions「台中「心之所向」這個社區最近成交多少?」
search → get_community「新竹縣竹北市北新一街 19 號,30 坪、開價 1,500 萬,跟附近成交比起來如何?」
analyze_property「我在台北市大安區看到一間 10 坪的獨立套房,月租 18,000,跟附近比貴嗎?」
check_rent「新北市各區整層 2 房、3 房現在大概租多少?哪一區最便宜?」
get_rent_statistics「台北市 3,000 萬以內、屋齡 15 年內、離捷運 500 公尺的社區有哪些?近一年行情如何?」
search_by_conditions「比較桃園市中壢區和新竹縣竹北市近五年的房價、成交量與租金報酬。」
compare_areas「列出臺中市三週內開拍、住宅會點交、底價比市價低的法拍,並分析最划算的一件。」
get_foreclosures → analyze_foreclosure「這件法拍(貼上案號或地址)的法院公告怎麼寫?部分點交是哪部分不點交?」
analyze_foreclosure「哪些行政區成交量回溫、但價格還沒漲?投資機會雷達的評分有預測力嗎?」
get_investment_radar + get_signal_backtest「某建商近幾年的預售案溢價多少?交屋後中古行情比預售價高還是低?」
get_developer「台北市中山區吉林段三小段 575 地號,公告現值幾倍?能蓋多少、土地殘值大概多少?」
get_land + estimate_land_development給開發者:工具一覽(55 個)
一般使用者不需要看;AI 會自己挑工具。完整說明與參數直接讀取 MCP 伺服器,與實際提供的工具同步。
展開工具清單 ▾
給開發者:工具一覽(55 個)
一般使用者不需要看;AI 會自己挑工具。完整說明與參數直接讀取 MCP 伺服器,與實際提供的工具同步。
找東西(先用這個)
社區、地址、建案、行政區、地標一次搜尋;查無門牌會明講search【先用這個】全站搜尋:輸入使用者說的任何東西——社區名、建案名、地址(可省略縣市)、行政區(「板橋」「台南東區」)、 生活圈/地標(「美術館」「七期」「青埔」「公館」)。
詳細
search【先用這個】全站搜尋:輸入使用者說的任何東西——社區名、建案名、地址(可省略縣市)、行政區(「板橋」「台南東區」)、 生活圈/地標(「美術館」「七期」「青埔」「公館」)。
【先用這個】全站搜尋:輸入使用者說的任何東西——社區名、建案名、地址(可省略縣市)、行政區(「板橋」「台南東區」)、 生活圈/地標(「美術館」「七期」「青埔」「公館」)。回傳 items(kind: community/project/address/area/zone/nodata, 每筆有 title、sub、href;社區 href 為 /community/{community_id}、建案 /project/{project_id}),以及 analyze(用附近成交估這個地址)。 kind=nodata 代表「這個門牌在實價登錄沒有成交紀錄」——此時相近地址(sub 開頭「相近地址,不是您輸入的門牌」)不是使用者那棟, 請明白告知,改用 analyze_property 以附近成交推算行情。取得 id 後再用 get_community/get_project/get_area_statistics 等工具查細節。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
query | string | 是 | — |
limit | integer | 10 |
search_properties用地址找棟(building)與戶(property)。
詳細
search_properties用地址找棟(building)與戶(property)。
用地址找棟(building)與戶(property)。回傳精確或模糊符合的建築,含社區名、樓層、完工日、成交筆數。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
address | string | 是 | — |
county | string | — | |
limit | integer | 20 |
search_communities用社區/建案名稱或地址關鍵字找社區,回傳 community_id 與摘要統計。
詳細
search_communities用社區/建案名稱或地址關鍵字找社區,回傳 community_id 與摘要統計。
用社區/建案名稱或地址關鍵字找社區,回傳 community_id 與摘要統計。回答「XX社區房價走勢」先用這個找 id。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
name | string | — | |
county | string | — | |
town | string | — | |
limit | integer | 20 |
開價分析與行情比較
開價落在附近成交的哪裡、比較案例、各種推算方法analyze_property「這間開價 X 合理嗎」:比較案例 → 參考單價區間 → 與開價比較(偏高/合理/偏低),附同棟成交、社區與行政區統計、周邊 POI 與環境風險。
詳細
analyze_property「這間開價 X 合理嗎」:比較案例 → 參考單價區間 → 與開價比較(偏高/合理/偏低),附同棟成交、社區與行政區統計、周邊 POI 與環境風險。
「這間開價 X 合理嗎」:比較案例 → 參考單價區間 → 與開價比較(偏高/合理/偏低),附同棟成交、社區與行政區統計、周邊 POI 與環境風險。 價格請用 offer:reference_total(相似成交換算這一戶的參考總價)、range_total(相似成交中間一半換算的區間),並轉述 offer.basis 的算法根據。 不要替使用者下「建議出價/建議開價/這間值多少」的結論:本工具是相似成交的統計換算,不是不動產估價(不動產估價師法第 14 條);需要估價請建議洽不動產估價師。 asking_price 為元;area_ping 為坪;若開價的坪數含車位,設 area_includes_parking=true(會扣除推估車位坪數與車位價)。 回答前務必看 input_warnings(屋齡、型態與登記不符等)。building_type 不要自行改寫:與登記不同時結論只是假設。 價格請只用 offer(reference_total/range_total);estimate 是比較案例的原始統計(未含車位),不要另外轉述。非估價報告。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
address | string | 是 | — |
county | string | — | |
area_ping | number | — | |
floor | integer | — | |
age_years | number | — | |
rooms | integer | — | |
has_parking | boolean | — | |
asking_price | integer | — | |
building_type | string | — | |
area_includes_parking | boolean | false |
get_comparable_transactions比較案例引擎:輸入標的(地址或座標、坪數、樓層、屋齡、房數、車位、型態),回傳依 comparable_score 排序的相似成交與各分項分數。
詳細
get_comparable_transactions比較案例引擎:輸入標的(地址或座標、坪數、樓層、屋齡、房數、車位、型態),回傳依 comparable_score 排序的相似成交與各分項分數。
比較案例引擎:輸入標的(地址或座標、坪數、樓層、屋齡、房數、車位、型態),回傳依 comparable_score 排序的相似成交與各分項分數。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
address | string | — | |
lat | number | — | |
lng | number | — | |
county | string | — | |
area_ping | number | — | |
floor | integer | — | |
age_years | number | — | |
rooms | integer | — | |
has_parking | boolean | — | |
building_type | string | — | |
radius_m | integer | 1000 | |
years | integer | 5 | |
limit | integer | 20 |
get_valuation_methods行情模型/指數方法說明與公開回測:各縣市 hedonic 模型的測試集 MdAPE、±10% 命中率、樣本數。
詳細
get_valuation_methods行情模型/指數方法說明與公開回測:各縣市 hedonic 模型的測試集 MdAPE、±10% 命中率、樣本數。
行情模型/指數方法說明與公開回測:各縣市 hedonic 模型的測試集 MdAPE、±10% 命中率、樣本數。
get_holding_analysis社區持有分析:同一戶前後兩次成交 → 中位持有年、中位總報酬、年化報酬、賠售比例、兩年內轉手比例、近期轉手案例。
詳細
get_holding_analysis社區持有分析:同一戶前後兩次成交 → 中位持有年、中位總報酬、年化報酬、賠售比例、兩年內轉手比例、近期轉手案例。
社區持有分析:同一戶前後兩次成交 → 中位持有年、中位總報酬、年化報酬、賠售比例、兩年內轉手比例、近期轉手案例。 所有報酬、比例皆為小數(0.25=25%)。報酬以「扣車位後的單價」計算(不是總價),不含稅費與仲介費; 買進日為第一次成交日(預售屋是簽約日,不是交屋日),所以總報酬含「預售到交屋」的漲幅; 要回答「交屋後漲了還是跌了」請用 post_completion(只算完工後才買進的轉手:筆數、中位總報酬、中位持有年、中位年化、賠售比例)。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
community_id | integer | 是 | — |
法拍
全台法院與行政執行署法拍、折價、同棟比較、法院公告全文與點交明細get_foreclosures法拍標的(全台地方法院+行政執行署)。
詳細
get_foreclosures法拍標的(全台地方法院+行政執行署)。
法拍標的(全台地方法院+行政執行署)。status: selling 待拍(含應買公告)/sold 拍定(法院近三個月起每日累積、行政執行署回溯到 108 年)/lapsed 流標或停拍/assumed 債權人承受。 kind: house 房屋/land 純土地/all。sort: upcoming 拍賣日近→遠 | discount 相對附近市價折價最深 | sb_discount 相對同棟成交折價最深(只列有同棟成交的標的)| recent 最新 | price 價格低→高。 featured=true:精選(三週內開拍、住宅點交、非第三人占用或出租、底價比市價低 15~50%)。hide_suspect=true 隱藏比市價低五成以上(多有公告外瑕疵)的標的。 篩選:q 案號(「147113」「114司執147113」)或地址片段;min_price/max_price(元;小於 10 萬視為萬元);deliverable=true 只看住宅會點交、非第三人占用且非持分(持分得標也拿不到整戶); rounds 拍次("1,2,3,4,5+,應買");exclude_share 排除持分;min_ping/max_ping 換算坪數;date_from/date_to 拍賣日區間(YYYY-MM-DD,例:兩週內=今天到 14 天後); min_market_confidence 市價信心下限(0~1;建議 0.6:信心低代表附近相似成交型態、屋齡差很多,折價不可靠)。total 為符合總數,offset 分頁(預設 20 筆)。 discount 為負=比市價便宜、為正=比市價貴;sort=discount 只列 discount<0 的標的(total 會變少);market_confidence 為市價估計的信心(0~1)。 delivery.flags 會標出:海砂屋、輻射屋、非自然死亡、漏水、火災、增建、占用、未保存登記、坐落他人土地、共有物變賣(共有人可優先承買)。 每筆有 lot_key、法院、案號、拍賣日、拍次(應買公告另有 apply_until 可聲明承買截止日)、地址、底價、拍定價、點交碼 check_label、delivery(法院公告解析:label 如「住宅點交・車位不點交」「不點交・第三人占用」、occupant、lease、mgmt_arrears、flags、summary 現況摘要)、 land_share 是「土地底價占總底價的比例」(不是土地持分;持分看 is_full 與公告)。photo_url(法院照片頁)、discount((拍定或底價)÷換算坪數÷附近相似成交市價−1;只對單一房屋、非持分、含土地標的計算)、 sb_discount(相對同一棟、坪數相近(±40%)的近 5 年買賣中位單價 sb_ping 的差距,sb_n 為筆數;同棟比較最直接,附近市價可能被較新或較舊的房子影響)、not_comparable_reason(沒有折價的原因)。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | — | |
town | string | — | |
status | string | selling | |
sort | string | upcoming | |
kind | string | house | |
featured | boolean | false | |
hide_suspect | boolean | true | |
comparable_only | boolean | false | |
q | string | — | |
min_price | integer | — | |
max_price | integer | — | |
deliverable | boolean | false | |
rounds | string | — | |
exclude_share | boolean | false | |
min_ping | number | — | |
max_ping | number | — | |
limit | integer | 20 | |
offset | integer | 0 | |
date_from | string | — | |
date_to | string | — | |
min_market_confidence | number | — |
analyze_foreclosure一次取得分析單一法拍標的所需的全部資料:標的(法院、案號、拍次、底價、坪數換算、點交碼、公告解析的點交明細與現況摘要、保證金、投標時間)、 同一案同一標別的歷次拍賣 history(底價與上一拍相比 vs_prev_floor)、 折價 discount 與市價,以及算出市價所用…
詳細
analyze_foreclosure一次取得分析單一法拍標的所需的全部資料:標的(法院、案號、拍次、底價、坪數換算、點交碼、公告解析的點交明細與現況摘要、保證金、投標時間)、 同一案同一標別的歷次拍賣 history(底價與上一拍相比 vs_prev_floor)、 折價 discount 與市價,以及算出市價所用…
一次取得分析單一法拍標的所需的全部資料:標的(法院、案號、拍次、底價、坪數換算、點交碼、公告解析的點交明細與現況摘要、保證金、投標時間)、 同一案同一標別的歷次拍賣 history(底價與上一拍相比 vs_prev_floor)、 折價 discount 與市價,以及算出市價所用的 20 筆相似成交明細(可檢查比較對象是否合理),加上法院公告的點交情形/使用情形/備註與公告全文 (full_text=false 可省略全文)、本站存檔與法院原檔 PDF 連結、解讀須知。lot_key 取自 get_foreclosures。 另附:unit_history(這一戶過去的實價登錄買賣,用門牌樓層「之幾」對到同一戶)、 trend(社區或同棟坪數相近的買賣、每年中位數;price_level=每年中位數最後一次低於底價每坪單價的年份,可說「底價回到某年的價位」)、 sold_ratio(該縣市近 180 天整戶法拍的拍定價÷底價分位數,不足 30 件用全台;估「通常要加幾成才標得到」)、 rent(社區近一年租約,est_monthly=每坪租金中位數×本件坪數)、remarks(社區實價登錄備註有無提到凶宅、漏水等)、 checklist(風險檢查表:點交、現況、公告對非自然死亡/火災/海砂屋/輻射屋/地震/漏水的調查結果與消息來源、增建、管理費、車位、瑕疵擔保; status=ok 公告寫明沒問題、warn 要注意、bad 明顯風險、unknown 公告寫無從得知、none 公告沒提)。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
lot_key | string | 是 | — |
full_text | boolean | true |
get_foreclosure_notice單一法拍標的的法院拍賣公告:本標別的「點交情形/使用情形/備註」原文、解析後的點交明細(delivery),以及公告 PDF 連結 (archive_url 為本站存檔,法院下架後仍可下載;pdf_url 為法院網站原檔)。
詳細
get_foreclosure_notice單一法拍標的的法院拍賣公告:本標別的「點交情形/使用情形/備註」原文、解析後的點交明細(delivery),以及公告 PDF 連結 (archive_url 為本站存檔,法院下架後仍可下載;pdf_url 為法院網站原檔)。
單一法拍標的的法院拍賣公告:本標別的「點交情形/使用情形/備註」原文、解析後的點交明細(delivery),以及公告 PDF 連結 (archive_url 為本站存檔,法院下架後仍可下載;pdf_url 為法院網站原檔)。full_text=true 另回公告全文(數千字)。lot_key 取自 get_foreclosures。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
lot_key | string | 是 | — |
full_text | boolean | false |
get_foreclosure_stats法拍統計(可限縣市):目前待拍件數與各拍次底價相對市價、拍定價相對市價、點交與否的價差、各縣市件數與中位折價。
詳細
get_foreclosure_stats法拍統計(可限縣市):目前待拍件數與各拍次底價相對市價、拍定價相對市價、點交與否的價差、各縣市件數與中位折價。
法拍統計(可限縣市):目前待拍件數與各拍次底價相對市價、拍定價相對市價、點交與否的價差、各縣市件數與中位折價。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | — |
租金行情
附近同類租約租多少、你的租金比幾成貴;各縣市、各區套房與 2、3 房租金check_rent租金行情查詢(租屋族問「這個租金貴不貴/附近租多少」用這個):附近 3 公里內同型態、坪數相近(±35%)的一般租約最近 30 筆(近 24 個月), 回傳租金第 25/50/75 百分位(元/月)、每坪租金中位、比較範圍 scope(nearby/town/county);給 …
詳細
check_rent租金行情查詢(租屋族問「這個租金貴不貴/附近租多少」用這個):附近 3 公里內同型態、坪數相近(±35%)的一般租約最近 30 筆(近 24 個月), 回傳租金第 25/50/75 百分位(元/月)、每坪租金中位、比較範圍 scope(nearby/town/county);給 …
租金行情查詢(租屋族問「這個租金貴不貴/附近租多少」用這個):附近 3 公里內同型態、坪數相近(±35%)的一般租約最近 30 筆(近 24 個月), 回傳租金第 25/50/75 百分位(元/月)、每坪租金中位、比較範圍 scope(nearby/town/county);給 rent(元/月)時 position 說明它比幾 % 的同類租約貴 (pct_rank)、與中位差幾 %(vs_median_pct)、落在中間一半之外或之內(band low/mid/high)。 rent_type:whole(整層住家,搭配 rooms 1~4,4=4 房以上)/studio(獨立套房)/shared(分租套房)/room(雅房)。area_ping 為坪數(不含車位)。 一般租約=排除社會住宅包租代管(同條件每坪約低兩成,social 另列)。實價登錄只收仲介成交與包租業轉租的租約,房東自租不必申報,請一併說明; backtest 是這個方法的回測誤差。這是統計比較,不是租金估價。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
address | string | — | |
county | string | — | |
town | string | — | |
rent_type | string | whole | |
rooms | integer | — | |
area_ping | number | — | |
rent | number | — |
get_rent_statistics各縣市(不給 county)或某縣市各行政區的租金統計:一般租約近一年(以資料完整月為終點)依型態分組(whole1~whole4 整層住家 1~4 房以上、 studio 獨立套房、shared 分租套房、room 雅房)的租金第 25/50/75 百分位(元/月)、坪數中位、…
詳細
get_rent_statistics各縣市(不給 county)或某縣市各行政區的租金統計:一般租約近一年(以資料完整月為終點)依型態分組(whole1~whole4 整層住家 1~4 房以上、 studio 獨立套房、shared 分租套房、room 雅房)的租金第 25/50/75 百分位(元/月)、坪數中位、…
各縣市(不給 county)或某縣市各行政區的租金統計:一般租約近一年(以資料完整月為終點)依型態分組(whole1~whole4 整層住家 1~4 房以上、 studio 獨立套房、shared 分租套房、room 雅房)的租金第 25/50/75 百分位(元/月)、坪數中位、每坪租金中位與一年變化 yoy(小數), 以及社會住宅包租代管的筆數與租金中位(另列,不混入一般租約)。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | — |
成交查詢
實價登錄買賣、預售、租賃search_transactions搜尋實價登錄成交。
詳細
search_transactions搜尋實價登錄成交。
搜尋實價登錄成交。address 可只寫路名或路段(「永和區竹林路」),會回該路段的成交;沒有門牌時可用它代替 analyze_property。 txn_kind: sale 買賣 / presale 預售 / rent 租賃。日期 YYYY-MM-DD;價格為元;area_ping 為建物移轉面積扣除車位(含公設,不是室內坪);unit_price_ping 為元/坪(已扣車位)。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | — | |
town | string | — | |
address | string | — | |
community_id | integer | — | |
building_id | integer | — | |
txn_kind | string | sale | |
date_from | string | — | |
date_to | string | — | |
min_price | integer | — | |
max_price | integer | — | |
min_ping | number | — | |
max_ping | number | — | |
building_type | string | — | |
include_special | boolean | false | |
limit | integer | 50 | |
offset | integer | 0 |
get_nearby_transactions找座標附近的成交,依距離排序。
詳細
get_nearby_transactions找座標附近的成交,依距離排序。
找座標附近的成交,依距離排序。「附近 500 公尺最接近的 10 筆成交」直接用這個。target=land 改找純土地成交(土地元/坪、持分、倍數)。 residential_only=true 只看住宅(排除 1 樓、透天、店面/廠辦/商辦與商業、工業用):問「附近住宅行情」時用這個。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
lat | number | 是 | — |
lng | number | 是 | — |
radius_m | integer | 500 | |
limit | integer | 10 | |
txn_kind | string | sale | |
years | integer | 3 | |
target | string | building | |
residential_only | boolean | false |
get_transactions_in_area地圖框選:經緯度範圍內近 months 個月的成交點(單價、總價、日期、社區)。
詳細
get_transactions_in_area地圖框選:經緯度範圍內近 months 個月的成交點(單價、總價、日期、社區)。
地圖框選:經緯度範圍內近 months 個月的成交點(單價、總價、日期、社區)。target=land 回傳純土地交易。範圍太大時回傳抽樣,建議小於約 3 公里見方。價格為元。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
min_lat | number | 是 | — |
min_lng | number | 是 | — |
max_lat | number | 是 | — |
max_lng | number | 是 | — |
txn_kind | string | sale | |
months | integer | 12 | |
min_price | integer | — | |
max_price | integer | — | |
max_age_years | number | — | |
building_type | string | — | |
target | string | building | |
limit | integer | 500 |
get_property取得單一戶/樓層的資料與其歷次交易。
詳細
get_property取得單一戶/樓層的資料與其歷次交易。
取得單一戶/樓層的資料與其歷次交易。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
property_id | integer | 是 | — |
get_building取得單棟建築:屬性、統計(近 1/3 年中位單價、成交量)、戶別清單、最近交易。
詳細
get_building取得單棟建築:屬性、統計(近 1/3 年中位單價、成交量)、戶別清單、最近交易。
取得單棟建築:屬性、統計(近 1/3 年中位單價、成交量)、戶別清單、最近交易。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
building_id | integer | 是 | — |
社區與篩選
社區行情、條件篩選、低估成交、成交備註提到凶宅與瑕疵的紀錄get_community取得社區:名稱、棟數、完工日、近 1/3 年單價與成交量、年增率、租金與租售比、各棟清單(最多 12 棟,另附總數)、附近社區與附近新建案、 remark_summary(實價登錄成交備註重點:提到凶宅、漏水、海砂屋等的成交與同期比價,增建、裝潢等筆數),以及 summary 行…
詳細
get_community取得社區:名稱、棟數、完工日、近 1/3 年單價與成交量、年增率、租金與租售比、各棟清單(最多 12 棟,另附總數)、附近社區與附近新建案、 remark_summary(實價登錄成交備註重點:提到凶宅、漏水、海砂屋等的成交與同期比價,增建、裝潢等筆數),以及 summary 行…
取得社區:名稱、棟數、完工日、近 1/3 年單價與成交量、年增率、租金與租售比、各棟清單(最多 12 棟,另附總數)、附近社區與附近新建案、 remark_summary(實價登錄成交備註重點:提到凶宅、漏水、海砂屋等的成交與同期比價,增建、裝潢等筆數),以及 summary 行情摘要: by_year(每年筆數與單價/總價中位)、by_floor_5y(樓層帶)、by_size_5y(坪數帶)、by_rooms_5y(房型)、recent_sales(最近 10 筆完工後買賣,不含預售)、 rent_2y(近兩年租金依出租型態與房數)。回答「這個社區多少錢、各樓層/幾房多少、這幾年漲跌、租金多少」直接用 summary,不必再用 search_transactions 逐頁翻成交; 只有要列出特定條件的逐筆成交時才用 search_transactions(community_id=…)。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
community_id | integer | 是 | — |
search_by_conditions社區條件搜尋。
詳細
search_by_conditions社區條件搜尋。
社區條件搜尋。例:台北市 3000 萬以下、屋齡 15 年內、近捷運 500m → county=台北市, max_total_price=30000000, max_age_years=15, near_poi_type=mrt, near_poi_m=500。 「近半年成交量明顯增加但價格沒明顯上漲」→ volume_hoh_min=0.5, price_hoh_max=0.03, sort=volume_hoh。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | — | |
town | string | — | |
max_total_price | integer | — | |
min_total_price | integer | — | |
max_age_years | number | — | |
min_ping | number | — | |
max_ping | number | — | |
near_poi_type | string | — | |
near_poi_m | integer | — | |
building_types | array | — | |
min_txn_1y | integer | 1 | |
volume_hoh_min | number | — | |
price_hoh_max | number | — | |
sort | string | n_1y | |
limit | integer | 30 |
screen_communities社區篩選器(房地產版 Finviz)。
詳細
screen_communities社區篩選器(房地產版 Finviz)。
社區篩選器(房地產版 Finviz)。可組合:縣市/行政區、總價(元,配 area_ping 坪數換算)、單價區間(元/坪)、屋齡、型態、捷運距離(m)、 租金殖利率下限、一年量增下限、一年價漲上限、半年量增/價漲、相對 1km 內新案折價上限(-0.25 = 便宜 25%+)、持有年化報酬下限、賠售比例上限。 比例皆小數。例:「桃園 1500 萬以下、屋齡 10 年內、捷運 800m、量增、比新案便宜 25%」→ county=桃園市, max_total_price=15000000, max_age_years=10, max_mrt_m=800, min_volume_yoy=0.2, max_gap_vs_new=-0.25 sort: n_1y | price_asc | price_desc | volume_yoy | volume_hoh | price_yoy | price_yoy_asc | yield | gap | return | mrt
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | — | |
town | string | — | |
towns | array | — | |
max_total_price | integer | — | |
min_total_price | integer | — | |
area_ping | number | — | |
min_ping | number | — | |
max_ping | number | — | |
max_age_years | number | — | |
min_age_years | number | — | |
building_types | array | — | |
max_mrt_m | integer | — | |
max_school_m | integer | — | |
min_yield | number | — | |
min_volume_yoy | number | — | |
max_price_yoy | number | — | |
min_price_yoy | number | — | |
min_volume_hoh | number | — | |
max_price_hoh | number | — | |
max_gap_vs_new | number | — | |
min_annual_return | number | — | |
max_loss_share | number | — | |
min_txn_1y | integer | 3 | |
sort | string | n_1y | |
limit | integer | 40 |
get_deals低估掃描:近 N 月成交單價低於同社區近一年中位 ≥10%(max_discount=-0.10)的案例,附可能原因(低樓層/頂樓/小坪/老屋/備註異常)。
詳細
get_deals低估掃描:近 N 月成交單價低於同社區近一年中位 ≥10%(max_discount=-0.10)的案例,附可能原因(低樓層/頂樓/小坪/老屋/備註異常)。
低估掃描:近 N 月成交單價低於同社區近一年中位 ≥10%(max_discount=-0.10)的案例,附可能原因(低樓層/頂樓/小坪/老屋/備註異常)。 exclude_reasons=True 只留沒有明顯原因的。sort: recent | discount | price
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | — | |
town | string | — | |
community_id | integer | — | |
max_discount | number | -0.1 | |
exclude_reasons | boolean | true | |
months | integer | 12 | |
sort | string | recent | |
limit | integer | 40 |
get_deal_summary低估成交摘要:近 12 個月比同社區中位便宜的成交件數、中位折價、無明顯原因比例、各行政區分布。
詳細
get_deal_summary低估成交摘要:近 12 個月比同社區中位便宜的成交件數、中位折價、無明顯原因比例、各行政區分布。
低估成交摘要:近 12 個月比同社區中位便宜的成交件數、中位折價、無明顯原因比例、各行政區分布。細項用 get_deals。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | — |
get_remark_flags實價登錄成交備註提到非自然死亡(凶宅)、海砂屋、輻射屋、火災的買賣與預售成交(「台中有哪些凶宅紀錄」)。
詳細
get_remark_flags實價登錄成交備註提到非自然死亡(凶宅)、海砂屋、輻射屋、火災的買賣與預售成交(「台中有哪些凶宅紀錄」)。
實價登錄成交備註提到非自然死亡(凶宅)、海砂屋、輻射屋、火災的買賣與預售成交(「台中有哪些凶宅紀錄」)。 每筆附日期、地址、樓層、價格、備註原文(含個資者不顯示)與 vs_peers(單價比同社區前後兩年其他成交的中位數,-0.3=低 30%)。 只有申報時寫進備註的才會出現,沒有出現不代表沒有發生;請以備註原文為準。單一社區請用 get_community 的 remark_summary。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | — | |
limit | integer | 100 |
行政區、指數與市場
區域統計、三種房價指數、投資雷達與回測、人口、交屋潮get_county_overview全台各縣市近一年成交筆數、中位單價與年增率,以及各縣市統計重算時間(refreshed_at)。
詳細
get_county_overview全台各縣市近一年成交筆數、中位單價與年增率,以及各縣市統計重算時間(refreshed_at)。
全台各縣市近一年成交筆數、中位單價與年增率,以及各縣市統計重算時間(refreshed_at)。 資料完整月(報告要寫的資料日期)請用 get_market_pulse 的 data_complete_month。
get_market_pulse市場脈動:全台加權中位單價與年變化、近一年成交量與年變化、資料完整月、行情模型誤差中位數。
詳細
get_market_pulse市場脈動:全台加權中位單價與年變化、近一年成交量與年變化、資料完整月、行情模型誤差中位數。
市場脈動:全台加權中位單價與年變化、近一年成交量與年變化、資料完整月、行情模型誤差中位數。
get_area_statistics行政區統計:近 1/3 年成交量與中位單價、年增率、租金。
詳細
get_area_statistics行政區統計:近 1/3 年成交量與中位單價、年增率、租金。
行政區統計:近 1/3 年成交量與中位單價、年增率、租金。不給 town 時回傳全縣市各區。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | 是 | — |
town | string | — |
compare_areas比較多個行政區(一次最多 12 個):areas 例 ["桃園市中壢區","新竹縣竹北市"] 或 ["桃園市|中壢區"](兩種寫法都可)。
詳細
compare_areas比較多個行政區(一次最多 12 個):areas 例 ["桃園市中壢區","新竹縣竹北市"] 或 ["桃園市|中壢區"](兩種寫法都可)。
比較多個行政區(一次最多 12 個):areas 例 ["桃園市中壢區","新竹縣竹北市"] 或 ["桃園市|中壢區"](兩種寫法都可)。 回傳每區近一年統計、動能、新案供給、重複交易季指數 rs_index(preliminary=true=當季配對 <20,不要據以講漲跌)、 yearly 每年成交筆數與加權單價(complete=false=不完整年度)。months 為回溯月數(預設 60=近五年)。 include_monthly=true 才附月序列(12 區 × 5 年約 5 萬字,需要逐月資料時才開)。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
areas | array | 是 | — |
months | integer | 60 | |
include_monthly | boolean | false |
get_price_history月度價格序列(中位/平均單價、成交量)。
詳細
get_price_history月度價格序列(中位/平均單價、成交量)。
月度價格序列(中位/平均單價、成交量)。給 community_id、building_id 或 county(+town) 其一。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
community_id | integer | — | |
building_id | integer | — | |
county | string | — | |
town | string | — | |
txn_kind | string | sale | |
months | integer | 36 |
get_price_index房價指數(基期 2016-01=100):中位數(median_index,月)、重複交易指數(repeat_sales_index,同一戶前後成交;granularity 標示月或季)、 Hedonic(hedonic_index,控制坪數屋齡樓層後的純時間效應;只有部分縣市層…
詳細
get_price_index房價指數(基期 2016-01=100):中位數(median_index,月)、重複交易指數(repeat_sales_index,同一戶前後成交;granularity 標示月或季)、 Hedonic(hedonic_index,控制坪數屋齡樓層後的純時間效應;只有部分縣市層…
房價指數(基期 2016-01=100):中位數(median_index,月)、重複交易指數(repeat_sales_index,同一戶前後成交;granularity 標示月或季)、 Hedonic(hedonic_index,控制坪數屋齡樓層後的純時間效應;只有部分縣市層級有,行政區與社區通常為空)。給 community_id 或 county(+town)。 中位數最近幾個月受申報延遲影響、樣本少(preliminary=true);重複交易當季配對少於 20 對時標 preliminary=true。判讀請避開初步值。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
community_id | integer | — | |
county | string | — | |
town | string | — | |
months | integer | 120 |
get_index_overview各縣市重複交易房價指數(同一戶前後兩次成交,2016-01=100)的月序列與一年變化、距歷史高點。
詳細
get_index_overview各縣市重複交易房價指數(同一戶前後兩次成交,2016-01=100)的月序列與一年變化、距歷史高點。
各縣市重複交易房價指數(同一戶前後兩次成交,2016-01=100)的月序列與一年變化、距歷史高點。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
months | integer | 120 |
get_index_towns指定縣市內各行政區的重複交易季指數:最新值、一年/三年變化、最新一季配對數與是否初步值,及近 years 年的季序列 (series 為 [季, 指數];預設 5 年,最多 20)。
詳細
get_index_towns指定縣市內各行政區的重複交易季指數:最新值、一年/三年變化、最新一季配對數與是否初步值,及近 years 年的季序列 (series 為 [季, 指數];預設 5 年,最多 20)。
指定縣市內各行政區的重複交易季指數:最新值、一年/三年變化、最新一季配對數與是否初步值,及近 years 年的季序列 (series 為 [季, 指數];預設 5 年,最多 20)。要各區成交量或逐年筆數,請改用 compare_areas(一次最多 12 區,含 yearly)。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | 是 | — |
years | integer | 5 |
get_nowcast近月成交量預估(申報延遲校正):實價登錄申報有 1–3 個月延遲,最近幾個月筆數不全。
詳細
get_nowcast近月成交量預估(申報延遲校正):實價登錄申報有 1–3 個月延遲,最近幾個月筆數不全。
近月成交量預估(申報延遲校正):實價登錄申報有 1–3 個月延遲,最近幾個月筆數不全。回傳各月已申報筆數、該月齡的歷史申報比例、預估最終筆數與區間、初步中位單價(標示 final / preliminary / insufficient)。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | — | |
months | integer | 8 |
get_investment_radar投資機會雷達(行政區層):近一年價格漲跌、成交量增減、租金殖利率、相對新案價差、供給比(兩年新案戶數/年成交量)、持有年化報酬, 合成 0–100 分(v3,相對排名:殖利率 45%、價格動能 35%、一年量增 10%、比新案便宜 10%;權重依指標回測決定,見 get_sign…
詳細
get_investment_radar投資機會雷達(行政區層):近一年價格漲跌、成交量增減、租金殖利率、相對新案價差、供給比(兩年新案戶數/年成交量)、持有年化報酬, 合成 0–100 分(v3,相對排名:殖利率 45%、價格動能 35%、一年量增 10%、比新案便宜 10%;權重依指標回測決定,見 get_sign…
投資機會雷達(行政區層):近一年價格漲跌、成交量增減、租金殖利率、相對新案價差、供給比(兩年新案戶數/年成交量)、持有年化報酬, 合成 0–100 分(v3,相對排名:殖利率 45%、價格動能 35%、一年量增 10%、比新案便宜 10%;權重依指標回測決定,見 get_signal_backtest)。另回傳獨立的指數動能 idx_score(重複交易指數距高點+四季動能,0–100;回測三個時期皆有效,2022 年後評分本身預測力接近零,兩者應一起看)與 idx_drawdown、idx_mom_4q。sort: score | index | volume | price | price_asc | yield | gap | momentum | return
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | — | |
sort | string | score | |
limit | integer | 40 |
get_signal_backtest指標領先性回測:投資機會雷達各科(殖利率、價格動能、一年量增、比新案便宜,以及已停用的近 3 月量能、價格平穩、供給少)與候選指標(指數動能、距高點回檔、一年漲幅原值、雷達總分)在過去每一季能否預測該行政區之後 4/8 季重複交易指數變化。
詳細
get_signal_backtest指標領先性回測:投資機會雷達各科(殖利率、價格動能、一年量增、比新案便宜,以及已停用的近 3 月量能、價格平穩、供給少)與候選指標(指數動能、距高點回檔、一年漲幅原值、雷達總分)在過去每一季能否預測該行政區之後 4/8 季重複交易指數變化。
指標領先性回測:投資機會雷達各科(殖利率、價格動能、一年量增、比新案便宜,以及已停用的近 3 月量能、價格平穩、供給少)與候選指標(指數動能、距高點回檔、一年漲幅原值、雷達總分)在過去每一季能否預測該行政區之後 4/8 季重複交易指數變化。回傳每個指標的平均 IC(Spearman)、t 值、命中率、五等分未來報酬、Q5−Q1 分位差、verdict(strong/weak/none)與方向;include_series=true 另附各季 IC 序列(約 5 萬字,預設不附)。用來回答「雷達評分有沒有預測力」「哪個指標最有用」。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
lag_q | integer | 1 | |
include_series | boolean | false |
get_demographics鄉鎮市區人口基本面(戶政司月資料):戶數、人口、出生死亡、遷入遷出、戶數年增、人口年增、12 個月淨遷入率。
詳細
get_demographics鄉鎮市區人口基本面(戶政司月資料):戶數、人口、出生死亡、遷入遷出、戶數年增、人口年增、12 個月淨遷入率。
鄉鎮市區人口基本面(戶政司月資料):戶數、人口、出生死亡、遷入遷出、戶數年增、人口年增、12 個月淨遷入率。給 town 回序列;不給回該縣市各區最新值(依戶數年增排序)。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | 是 | — |
town | string | — | |
months | integer | 36 |
get_handover交屋潮(預售屋交屋供給):預售屋簽約時申報實價、交屋過戶時不再申報,所以內政部「建物買賣移轉棟數」=中古買賣+預售交屋。
詳細
get_handover交屋潮(預售屋交屋供給):預售屋簽約時申報實價、交屋過戶時不再申報,所以內政部「建物買賣移轉棟數」=中古買賣+預售交屋。
交屋潮(預售屋交屋供給):預售屋簽約時申報實價、交屋過戶時不再申報,所以內政部「建物買賣移轉棟數」=中古買賣+預售交屋。回傳 (1) 縣市各季登記移轉棟數、第一次登記棟數、實價中古筆數/棟數與差額(≈交屋量);(2) 未來各季推估交屋時程(約 3 年前簽約的預售戶數,2024Q3 起可信);(3) 未來一年交屋量 ÷ 近一年中古成交量(交屋壓力)。注意:此指標回測只在 2013–18 對房價有負向預測力,2019 後無,僅作供給背景。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | 是 | — |
town | string | — | |
quarters_ahead | integer | 12 |
新建案與建商
預售建案、溢價、建商紀錄search_projects新建案(預售備查建案)搜尋:建案名/建商、戶數、建照、預售成交筆數與中位單價、相對同區中古溢價(premium_vs_area)、交屋後中古 vs 預售(resale_vs_presale)。
詳細
search_projects新建案(預售備查建案)搜尋:建案名/建商、戶數、建照、預售成交筆數與中位單價、相對同區中古溢價(premium_vs_area)、交屋後中古 vs 預售(resale_vs_presale)。
新建案(預售備查建案)搜尋:建案名/建商、戶數、建照、預售成交筆數與中位單價、相對同區中古溢價(premium_vs_area)、交屋後中古 vs 預售(resale_vs_presale)。 sort: recent | n | price_desc | price_asc | premium | premium_asc | households
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | — | |
town | string | — | |
name | string | — | |
sort | string | recent | |
limit | integer | 40 |
get_project建案頁:預售成交月序列、最近成交(txn_limit 筆,預設 15;transactions_total 為總筆數)、基地地號與現值、對應社區(交屋後)中古行情、附近 1.5 公里其他建案(前 8)。
詳細
get_project建案頁:預售成交月序列、最近成交(txn_limit 筆,預設 15;transactions_total 為總筆數)、基地地號與現值、對應社區(交屋後)中古行情、附近 1.5 公里其他建案(前 8)。
建案頁:預售成交月序列、最近成交(txn_limit 筆,預設 15;transactions_total 為總筆數)、基地地號與現值、對應社區(交屋後)中古行情、附近 1.5 公里其他建案(前 8)。 ref=參考單價(元/坪,不含車位):依附近 5 公里內新建案近期成交、用距離與成交時間加權並做時間調整的自動估算,附 low/high 區間、confidence、比較案 comps; ref_backtest 是這個方法的回測準確度(mdape 誤差中位 %、w10 誤差 10% 內比例)。問「這個建案大概多少錢一坪」用 ref 回答並附準確度; 它不是建商售價,也不具不動產估價師法規定的估價效力。建案自己已有成交時,以 presale_median_ping 為準,ref 用來比較它與附近新案的高低。 town_ref(同區預售單價分位與房型常見坪數/總價)、town_projects、developer_projects、stats(本案申報筆數、解約、單價/總價分位、房型、樓層)同樣可引用。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
project_id | integer | 是 | — |
txn_limit | integer | 15 |
get_project_overview新建案(預售)總覽:各行政區近 24 個月預售成交數、中位單價、相對同區中古的溢價。
詳細
get_project_overview新建案(預售)總覽:各行政區近 24 個月預售成交數、中位單價、相對同區中古的溢價。
新建案(預售)總覽:各行政區近 24 個月預售成交數、中位單價、相對同區中古的溢價。個別建案用 search_projects / get_project。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | — |
list_developers建商彙總:推案數、戶數、預售成交、中位單價、相對區域中古溢價、交屋後中古 vs 預售、去化速度(戶/月)。
詳細
list_developers建商彙總:推案數、戶數、預售成交、中位單價、相對區域中古溢價、交屋後中古 vs 預售、去化速度(戶/月)。
建商彙總:推案數、戶數、預售成交、中位單價、相對區域中古溢價、交屋後中古 vs 預售、去化速度(戶/月)。sort: presale_n | projects | households | premium | premium_asc | resale | velocity | recent
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | — | |
name | string | — | |
sort | string | presale_n | |
limit | integer | 40 |
get_developer單一建商:各縣市彙總 by_county、歷年預售成交與單價 yearly、交屋後表現 track、建案清單 projects(最多 20,精簡欄位)。
詳細
get_developer單一建商:各縣市彙總 by_county、歷年預售成交與單價 yearly、交屋後表現 track、建案清單 projects(最多 20,精簡欄位)。
單一建商:各縣市彙總 by_county、歷年預售成交與單價 yearly、交屋後表現 track、建案清單 projects(最多 20,精簡欄位)。 name 可用簡稱(「興富發」),會比對到預售量最大的同名建商並註明。 「交屋後表現」請看 track(逐案:預售中位價 vs 交屋後近 24 個月中古中位價)。資料來源為內政部預售屋備查,只涵蓋約 2021 年起申報的建案;更早完工的社區不在追蹤內。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
name | string | 是 | — |
土地
地號、地段、公告現值倍數、分區、建照、開發試算get_land地號頁:面積、分區/建蔽容積、歷年公告現值、歷次交易(標示全筆/持分)、成交倍數、同段鄰號近 5 年成交、上方建物與社區。
詳細
get_land地號頁:面積、分區/建蔽容積、歷年公告現值、歷次交易(標示全筆/持分)、成交倍數、同段鄰號近 5 年成交、上方建物與社區。
地號頁:面積、分區/建蔽容積、歷年公告現值、歷次交易(標示全筆/持分)、成交倍數、同段鄰號近 5 年成交、上方建物與社區。 可用 land_key(台|區|段|小段|主-子)或 county+town+section(如「仁愛段三小段」)+land_no(如「88-28」)。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
land_key | string | — | |
county | string | — | |
town | string | — | |
section | string | — | |
land_no | string | — |
search_lands找地號:依縣市/區/段名(可只給前綴)/地號,回傳 land_key、面積、分區、最新成交與公告現值。
詳細
search_lands找地號:依縣市/區/段名(可只給前綴)/地號,回傳 land_key、面積、分區、最新成交與公告現值。
找地號:依縣市/區/段名(可只給前綴)/地號,回傳 land_key、面積、分區、最新成交與公告現值。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | — | |
town | string | — | |
section | string | — | |
land_no | string | — | |
limit | integer | 50 |
get_land_section地段:給 section_key 回傳整段統計、段內地號清單(前 limit 個,依近期成交排序)、近期土地成交;只給 county(+town) 則列出該區各地段排行(sort: n_1y|price|yoy|multiple)。
詳細
get_land_section地段:給 section_key 回傳整段統計、段內地號清單(前 limit 個,依近期成交排序)、近期土地成交;只給 county(+town) 則列出該區各地段排行(sort: n_1y|price|yoy|multiple)。
地段:給 section_key 回傳整段統計、段內地號清單(前 limit 個,依近期成交排序)、近期土地成交;只給 county(+town) 則列出該區各地段排行(sort: n_1y|price|yoy|multiple)。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
section_key | string | — | |
county | string | — | |
town | string | — | |
sort | string | n_1y | |
limit | integer | 30 |
list_land_sections地段排行:各段(段小段)近一年土地成交筆數、單價、漲跌、公告現值倍數。
詳細
list_land_sections地段排行:各段(段小段)近一年土地成交筆數、單價、漲跌、公告現值倍數。
地段排行:各段(段小段)近一年土地成交筆數、單價、漲跌、公告現值倍數。sort: n_1y 成交量 | price 單價 | yoy 漲幅 | multiple 現值倍數。 數字是每段「主要分區」(非公設地優先,見 zoning_label)的統計,或指定 zoning_category(residential、agricultural、public…)只看那一種地。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | 是 | — |
town | string | — | |
sort | string | n_1y | |
limit | integer | 100 | |
zoning_category | string | — |
get_land_statistics土地行情統計:行政區 × 分區類別(住/商/工/農/公設/非都市…)的近 1/3 年成交量、中位元/坪、年增率、公告現值倍數;附各縣市總覽。
詳細
get_land_statistics土地行情統計:行政區 × 分區類別(住/商/工/農/公設/非都市…)的近 1/3 年成交量、中位元/坪、年增率、公告現值倍數;附各縣市總覽。
土地行情統計:行政區 × 分區類別(住/商/工/農/公設/非都市…)的近 1/3 年成交量、中位元/坪、年增率、公告現值倍數;附各縣市總覽。只計全筆移轉。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | — | |
town | string | — | |
zoning_category | string | — |
get_land_rankings地段榜:sort = n_1y 熱門 | yoy 漲最多 | yoy_asc 跌最多 | multiple 現值倍數最高 | price 單價最高。
詳細
get_land_rankings地段榜:sort = n_1y 熱門 | yoy 漲最多 | yoy_asc 跌最多 | multiple 現值倍數最高 | price 單價最高。
地段榜:sort = n_1y 熱門 | yoy 漲最多 | yoy_asc 跌最多 | multiple 現值倍數最高 | price 單價最高。 min_n 為地段近一年土地成交最少筆數(預設 5);臺北市等土地交易稀少的縣市請調低到 1~2,否則可能沒有結果。 每段的數字是「主要分區」(非公設地優先、近三年筆數最多,見 zoning_label)的統計;要比同一種地請指定 zoning_category (residential 住宅區、commercial 商業區、industrial 工業區、agricultural 農業區、public 公設/道路、nonurban_building 非都市建築用地、nonurban_farm 非都市農牧用地)。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | — | |
sort | string | n_1y | |
limit | integer | 20 | |
min_n | integer | 5 | |
zoning_category | string | — |
get_land_price_history土地成交單價月序列(全筆移轉、非特殊交易),可依都市計畫使用分區類別(住宅區、商業區、工業區、農業區…)過濾。
詳細
get_land_price_history土地成交單價月序列(全筆移轉、非特殊交易),可依都市計畫使用分區類別(住宅區、商業區、工業區、農業區…)過濾。
土地成交單價月序列(全筆移轉、非特殊交易),可依都市計畫使用分區類別(住宅區、商業區、工業區、農業區…)過濾。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
county | string | 是 | — |
town | string | — | |
zoning_category | string | — | |
months | integer | 60 |
estimate_land_development土地開發試算(回推土地可負擔成本,非土地估價):V = S ÷ (1+R) ÷ (1+i) − (C+M);S 總銷、R 利潤率、i 資本利息綜合利率、C 營建費用、M 規劃設計與銷售管理費用。
詳細
estimate_land_development土地開發試算(回推土地可負擔成本,非土地估價):V = S ÷ (1+R) ÷ (1+i) − (C+M);S 總銷、R 利潤率、i 資本利息綜合利率、C 營建費用、M 規劃設計與銷售管理費用。
土地開發試算(回推土地可負擔成本,非土地估價):V = S ÷ (1+R) ÷ (1+i) − (C+M);S 總銷、R 利潤率、i 資本利息綜合利率、C 營建費用、M 規劃設計與銷售管理費用。 S=可售坪 × 新案單價+車位收入;可售坪=基地 × 法定容積 ×(1+bonus_pct%)× 銷坪係數;C=地上+地下室營建;M=設計(C 的 3%)+銷管稅費(S 的 indirect)。 容積自動取得順序:地號分區(臺北市)→ 分區圖落點(臺北市)→ 非都市用地法定值(甲乙 240%、丙 120%、丁 300%)→ 分區類別常見值(會在 warnings 提醒)。 product:tower 大樓(地下室停車、車位另計收入)/townhouse 透天低層(無地下室)/auto(容積 ≤150% 或基地 <200 m² 視為透天)。 整合開發:extra_keys 帶其他地號(最多 19 筆),面積加總、容積依面積加權,回傳 lots 逐筆明細。 地號缺面積時回 need="area_ping",請帶 area_ping(坪)重試;公設或不可建築用地會回 error。回傳 steps(每一步金額)、sensitivity(單價與營建 ±10% 的每坪殘值)、與公告現值及最近成交倍數。 單價參數為「元/坪」(price_ping=650000 即 65 萬/坪);比例參數為小數(profit=0.18 即 18%),bonus_pct 為百分比(20 即容積增加 20%)。 land_key 格式「縣市|行政區|段名|小段|主號-子號」,例「台北市|大安區|大安|一|217-0」(段名與小段分開、不含「段」「小段」字);可由 search_lands 取得。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
land_key | string | 是 | — |
area_ping | number | — | |
far_pct | number | — | |
bonus_pct | number | 0 | |
price_ping | number | — | |
build_cost_ping | number | — | |
sale_ratio | number | 1.35 | |
basement_levels | integer | — | |
parking_price | number | — | |
profit | number | 0.18 | |
interest | number | 0.04 | |
indirect | number | 0.08 | |
margin | number | — | |
product | string | auto | |
extra_keys | array | — |
get_zoning座標或地號 → 都市計畫使用分區、建蔽率、容積率(參考值)。
詳細
get_zoning座標或地號 → 都市計畫使用分區、建蔽率、容積率(參考值)。
座標或地號 → 都市計畫使用分區、建蔽率、容積率(參考值)。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
lat | number | — | |
lng | number | — | |
land_key | string | — |
get_building_permits建照/使照查詢(起造人、戶數、樓層、構造、面積)。
詳細
get_building_permits建照/使照查詢(起造人、戶數、樓層、構造、面積)。
建照/使照查詢(起造人、戶數、樓層、構造、面積)。目前只收錄新北市建管開放資料(約 1.4 萬件);其他縣市會回 coverage 說明而非 0 筆。 預售建案的建照字號可用 get_project(build_permit_nos)。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
address | string | — | |
land_key | string | — | |
building_id | integer | — | |
county | string | — |
周邊與物件
生活機能、環境風險、待售物件get_nearby_poi附近 POI(mrt/tra/hsr/school/hospital/park/…)與該點的環境風險(液化/淹水/斷層敏感區)。
詳細
get_nearby_poi附近 POI(mrt/tra/hsr/school/hospital/park/…)與該點的環境風險(液化/淹水/斷層敏感區)。
附近 POI(mrt/tra/hsr/school/hospital/park/…)與該點的環境風險(液化/淹水/斷層敏感區)。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
lat | number | 是 | — |
lng | number | 是 | — |
radius_m | integer | 1000 | |
poi_types | array | — | |
limit | integer | 50 |
search_listings本站使用者刊登的待售/待租物件(kind: sale | rent),每筆附與同社區實價的比較。
詳細
search_listings本站使用者刊登的待售/待租物件(kind: sale | rent),每筆附與同社區實價的比較。
本站使用者刊登的待售/待租物件(kind: sale | rent),每筆附與同社區實價的比較。不含聯絡方式,請引導使用者到 toestate.tw/listing/{id} 查看。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
kind | string | sale | |
county | string | — | |
town | string | — | |
community_id | integer | — | |
min_price | integer | — | |
max_price | integer | — | |
min_ping | number | — | |
max_ping | number | — | |
rooms | integer | — | |
building_type | string | — | |
sort | string | new | |
limit | integer | 40 |
其他
find_affordable_areas自住/首購:「我的預算能在哪裡買到房子」。
詳細
find_affordable_areas自住/首購:「我的預算能在哪裡買到房子」。
自住/首購:「我的預算能在哪裡買到房子」。給 budget(總價上限,元),或給 down_payment(自備款,元)+ monthly_payment(每月可付,元)自動換算 (受限於貸款成數 ltv 或月付兩者較小者,回傳 binding 說明)。回傳各行政區近一年同條件成交中「在預算內的比例」share_ok、預算能買幾坪 ping_at_budget、 中位總價,與預算內有成交的社區。building_type:any/tower(大樓華廈)/apartment(公寓)/house(透天);rooms=4 代表 4 房以上;parking:any/yes/no。 town 可限定單一行政區(「板橋 3 房 1,500 萬買得到嗎」:county=新北市、town=板橋區、rooms=3、budget=15000000)。金額單位一律為元(1500 萬=15000000)。 rate 預設 0.0232=中央銀行公布 115 年 8 月五大銀行新承做購屋貸款利率 2.321%;回答時請說明這是預設值,可依銀行核貸利率調整。
| 參數 | 型別 | 必填 | 預設 |
|---|---|---|---|
down_payment | number | — | |
monthly_payment | number | — | |
budget | number | — | |
county | string | — | |
town | string | — | |
rooms | integer | — | |
min_ping | number | — | |
max_ping | number | — | |
building_type | string | any | |
max_age | number | — | |
parking | string | any | |
rate | number | 0.0232 | |
years | integer | 30 | |
ltv | number | 0.8 |
資料與限制
- 資料來自內政部實價登錄、預售屋備查、各縣市門牌與地政資料、司法院與行政執行署法拍公告等政府開放資料,每日更新。
- AI 拿到的單價為「元/坪」且已扣除車位(網站上顯示為萬/坪);統計預設排除親友交易、僅車位等特殊案件。實價登錄申報約有 1–3 個月延遲。
- 所有數字為參考區間與統計,不是不動產估價報告,也不是投資建議。法拍點交請以法院公告原文為準。
- 請 AI 回答時引用工具回傳的 sources 與官方連結,方便查證。