核心功能
compass-mcp 是一款通过 MCP（Model Context Protocol）协议提供 Compass 房产平台数据访问的第三方工具。它并非基于官方公开 API，而是通过浏览器扩展 fetchproxy 桥接用户已登录的 compass.com 会话，调用 Compass 网页应用内部使用的 /stingray/... 私有端点。
主要能力
公开数据工具：
- 房源搜索 (
compass_search_properties)：按地理位置、价格区间、卧室/浴室数量、房屋类型筛选，返回价格、面积、建造年份、地址及 Compass 房源链接 - 房源详情 (
compass_get_property)：通过 URL 或房源 ID 获取完整房产信息，包括价格状态、上市天数、主图等 - 市场报告 (
compass_get_market_report)：获取特定区域的中位售价、每平方英尺价格、上市天数、同比变化等关键指标 - 抵押贷款计算 (
compass_calculate_mortgage)：本地 PITI 计算器，支持首付比例、利率、税费、保险、HOA 及 PMI 等参数
个人数据工具（需登录）：
- 收藏房源 (
compass_get_saved_homes)：跨所有收藏夹聚合的已保存房源 - 保存的搜索 (
compass_get_saved_searches)：用户创建的搜索条件及区域 URL
显著优点
1. 零配置成本：无需 API 密钥、环境变量或付费订阅，仅需浏览器登录状态
2. 个人数据访问：区别于付费爬虫工具，可读取用户私有的收藏房源和保存搜索，这是官方未公开的差异化能力
3. 实时数据：直接源自 Compass 生产环境，避免第三方数据延迟
4. WAF 规避：通过真实浏览器会话绕过 AWS WAF / DataDome 防护
局限性与风险
| 维度 | 说明 |
|------|------|
| **架构脆弱性** | 依赖非官方私有端点， Compass 随时可能更改或封禁 |
| **功能限制** | v0.1 仅支持 `for_sale` 状态，租赁/已售房源 URL 结构不同且未覆盖 |
| **无写入能力** | 收藏房源、提交联系表单等操作均未实现 |
| **会话依赖** | 个人数据工具完全依赖浏览器登录状态，会话过期或 WAF 挑战会导致失败 |
| **法律灰区** | 明确声明"Use at your own discretion"，可能违反 Compass ToS |
| **单点故障** | fetchproxy 扩展为共享依赖，任何 MCP 的更新都可能影响稳定性 |
适合人群
- 已活跃使用 Compass 平台的房产从业者或购房者
- 需要整合个人收藏与市场分析工作流的技术用户
- 对 Zillow/Redfin 替代数据源有需求，且能接受逆向工程风险的场景
常规风险
- 服务中断：私有 API 变更可能导致工具突然失效
- 账户安全：需保持 compass.com 登录状态，建议专用浏览器配置文件
- 数据准确性：依赖 Compass 内部数据质量，Compass Estimate 仅提供当前值无历史序列
- 合规风险：企业用户应评估违反平台服务条款的潜在后果