核心用法
AgentZero 是一款面向个人用户的房产列表追踪系统，通过本地 Rust/Axum 后端（localhost:8000）实现房产数据的私有化管理。核心功能分为三大工作流：
1. 手动添加房源
- 解析 Redfin 或 REW.ca 的房源 URL，自动提取价格、面积、卧室数等字段
- 需预先配置搜索画像（Search Profile），系统根据房源特征智能匹配最佳画像
- 若画像不匹配则拒绝入库，避免数据污染
- 支持冲突检测（409 CONFLICT），自动识别重复房源
2. 房源刷新
- 通过 PUT
/api/listings/:id/refresh更新房源状态与价格变动 - 适用于长期跟踪潜在目标房源的市场动态
3. 每日邮件扫描（Daily Email Scan）
- 通过 himalaya CLI 读取 Gmail 中 Redfin 房源提醒邮件
- 利用 openclaw 浏览器自动化点击邮件内房源链接，提取真实 URL
- 每日上限 3 封邮件，防止过度请求；已处理邮件打
agent_zero标签避免重复 - 仅采集邮件信封元数据（ID、主题），不存储邮件正文内容
显著优点
- 数据主权：完全本地部署，房源数据不落第三方云服务
- 自动化闭环：从邮件提醒→自动解析→入库→前端展示，无需手动复制粘贴
- 智能画像匹配：基于房源属性自动归类，支持多维度投资策略（如 East Van House 专属画像）
- 防重复机制：信封 ID 去重 + 数据库唯一约束双重保障
- 合规采集：明确限定
from:redfin.com发件人，仅处理用户主动订阅的邮件流
潜在缺点与局限性
- 平台覆盖有限：Zillow 与 Realtor.ca 仅保存 stub，核心解析能力依赖 Redfin/REW
- 基础设施依赖重：需同时维护 Rust 后端、himalaya 邮件客户端、openclaw 浏览器三个本地服务
- 邮箱权限门槛：Gmail IMAP 配置、应用密码/ OAuth 令牌管理对非技术用户有学习曲线
- 反爬风险：浏览器自动化访问 Gmail 可能触发 Google 安全风控，长期使用需关注账号健康度
- 单日处理上限：3 封邮件/日的保守限制，高频市场可能遗漏即时房源
适合人群
- 技术型房产投资者：具备 CLI 工具使用经验，愿意维护本地服务栈
- 隐私敏感用户：拒绝将房产偏好数据托管至云端 SaaS
- Redfin 生态依赖者：主要关注加拿大 BC 省、美国市场，且已订阅 Redfin 邮件提醒
常规风险
| 风险类型 | 说明 |
|---------|------|
| 邮件服务中断 | himalaya 配置失效或 Gmail IMAP 策略变更将导致扫描中断 |
| 浏览器自动化失效 | openclaw 或 Chrome 版本不匹配时，邮件解析链路断裂 |
| 数据结构漂移 | Redfin/REW 前端改版可能导致 XPath/选择器失效，需持续维护解析逻辑 |
| 本地数据丢失 | `agent_zero_logs/` 与 SQLite 数据库需纳入用户备份策略 |
| 账号封禁 | 高频浏览器操作可能触发 Google reCAPTCHA 或临时安全锁定 |
日志与审计
所有操作强制追加至 ~/.openclaw/workspace/agent_zero_logs/YYYY-MM-DD.md，包含时间戳、房源 URL、匹配画像、价格、状态及处理结果，支持完整的操作审计与事后复盘。