Tw House Ops

tw-house-ops

台灣看房 AI 管線，建構於 Claude Code 之上。自動化物件發掘、評估與追蹤，涵蓋租屋與購屋市場的完整搜尋流程。

支援三種使用者類型：**租屋族**、**首購族**、**換屋族**。

Inspired by [santifer/career-ops](https://github.com/santifer/career-ops) — same ops-style approach, applied to 台灣租屋 & 購屋.


---

功能概覽

• 掃描 591、樂屋網、信義、永慶、東森、住商，搜尋符合條件的新物件
• 評估 每間物件：與市場行情（實價登錄）比較、通勤計算、五維度評分
• 追蹤 所有考慮過的物件，以結構化 Markdown 表格記錄
• 試算 可負擔房價（首購族）與換屋財務規劃（換屋族）
• 準備 根據評估報告產生看屋清單與議價策略

---

事前準備

掃描（`scan`）與物件上架驗證依賴 `agent-browser`，**使用前必須安裝**：

npm install -g agent-browser

確認安裝成功：

agent-browser --version

未安裝的情況下執行 `scan` 或貼上 URL，Claude 將無法爬取真實頁面內容，後續評估結果不可信。Claude Code 每次啟動時會自動偵測並提示。

---

快速開始

1. 安裝 agent-browser（見上方）
2. Clone 此 repo 並在 Claude Code 中開啟
3. Claude 會自動偵測缺少的設定檔，啟動初始設定流程（7 個步驟，約 5 分鐘）
4. 設定完成後，貼上任何物件 URL 即可評估——或輸入 scan 搜尋目標區域

---

用法

輸入	動作
貼上物件 URL	自動判斷租屋 / 買屋 → 評估 → 產生報告
scan	在目標區域掃描各平台的新物件
pipeline	批次處理 data/pipeline.md 中所有待評估 URL
compare 001, 003	並列比較兩間已評估物件
prepare visit for 001	產生報告 001 的看屋清單與議價策略
affordability	試算可負擔房價與區域適配（首購族）
upgrade plan	換屋財務規劃：賣舊屋 + 買新房時程與資金缺口分析（換屋族）
tracker	顯示所有追蹤物件的摘要

---

Demo

Pipeline 批次評估輸出

批次跑完後自動輸出摘要表 + 本輪最佳推薦，每筆附原始連結供人工覆核。


物件評估報告

每間物件產出完整報告：價格分析（含實價登錄比對）、通勤試算、五維度評分、疑點清單、看屋問題清單。




---

目錄結構

tw-house-ops/
├── CLAUDE.md                    # 入口：模式路由、初始設定、資料合約
├── config/
│   ├── profile.yml              # 個人設定（永遠不會被系統更新覆寫）
│   └── profile.example.yml      # 設定範本
├── portals.yml                  # 各平台 URL 與掃描設定
├── modes/
│   ├── _shared.md               # 評分維度、台灣市場知識
│   ├── _profile.md              # 個人情境（每次評估都會注入）
│   ├── _profile.template.md     # _profile.md 的初始範本
│   ├── scan.md