核心功能概述
compass-mcp 是一个基于 MCP（Model Context Protocol）的房产数据代理服务，允许用户通过自然语言指令查询 Compass 房产平台的实时数据。该工具通过创新的浏览器扩展架构，解决了 Compass 无公开 API 的核心难题。
显著优点
1. 无 API 密钥设计
无需注册开发者账号或管理 API 密钥，仅需在浏览器登录 compass.com 即可使用，极大降低了接入门槛。
2. 创新的反爬虫绕过机制
通过 fetchproxy 浏览器扩展，将请求路由至用户已登录的浏览器标签页，使 AWS WAF 识别为真实浏览器会话而非自动化脚本，有效规避了 Compass 的反爬防护。
3. 丰富的数据维度
覆盖搜索、详情、照片、价格历史、可比租金、代理房源等 10+ 种工具，支持批量地址解析和房产对比（最多25个并行）。
4. 本地计算工具
内置房贷计算器（PITI）和购房能力评估（28/36 DTI 规则），无需网络即可使用。
5. 健壮的错误处理
地址解析失败时返回结构化错误而非错误链接，批量操作支持 per-row 错误隔离。
潜在局限与风险
1. 架构脆弱性
依赖 Compass 服务端渲染的 React 应用内部状态（window.__INITIAL_DATA__），若 Compass 更新前端架构或变量命名，工具将立即失效。
2. 浏览器扩展依赖
必须安装并维护 fetchproxy Chrome 扩展，跨设备使用需重复配置；WebSocket 连接稳定性直接影响服务可用性。
3. 法律与合规灰色地带
虽通过用户自有浏览器会话访问，但实质规避了平台的服务条款限制，存在账号封禁风险。
4. 功能不完整
收藏房源、保存搜索等需 GraphQL 鉴权的功能尚不支持；无区域市场报告或房价估算历史数据。
5. 会话管理复杂性
多会话切换需手动管理，易因登录状态过期导致 SessionNotAuthenticatedError。
适合人群
- 房产经纪人需要快速批量查询房源信息
- 购房者进行多房源对比分析
- 数据分析师研究特定区域房产价格历史
- 已熟悉 MCP 生态的技术用户
常规风险提示
- 账号安全：建议使用独立 Compass 账号，避免主账号因异常活动被封
- 数据时效：依赖页面缓存，极端情况下可能读取数小时前的数据
- 隐私注意：所有查询通过本地浏览器执行，但扩展代码需审计确认无数据外传
- WAF 挑战：首次使用或长期未用后可能需人工完成验证码挑战
技术实现评价
该项目展现了精巧的逆向工程能力，将无 API 平台的 SSR 页面转化为结构化数据源。然而，这种"页面抓取"模式的长期可维护性存疑，适合作为临时解决方案而非生产级基础设施。