核心功能
compass-mcp 是一个非官方 MCP 服务器，通过浏览器扩展桥接技术，让 AI 助手能够以自然语言查询 Compass 房地产平台的房源数据。由于 Compass 未开放公共 API，该工具采用独特的技术方案：通过 fetchproxy 浏览器扩展，将请求路由到用户已登录的 Compass.com 标签页，从而绕过 AWS WAF 防护，提取服务器渲染的 React 应用内联脚本中的数据。
主要工具能力
搜索与查询：支持按地点、价格区间、卧室/浴室数量、房屋类型筛选搜索；通过自由文本地址解析获取房产详情；批量处理最多 200 个房产的并发查询。
深度数据提取：获取完整房源记录（地址、社区、面积、价格、学区等）、照片库（含原始图和缩略图 URL）、价格历史（上市/售出/待售/价格变动记录）、可比租赁房源。
本地计算工具：内置房贷计算器（PITI 完整拆解）和购房能力评估器（基于 28/36 DTI 规则），无需网络连接。
批量对比：支持最多 25 个房产的并排对比，可选生成汇总表格。
显著优点
1. 零 API 密钥配置：用户只需安装 npm 包和浏览器扩展，在 Chrome 中登录 Compass 即可使用，无需申请开发者权限
2. 数据完整性：直接提取 Compass 原生渲染的数据，包含 MLS 状态、月费、设施、学校信息等详细字段
3. WAF 规避机制：通过 omnisuggest 类型ahead 和 /listing/<sha>/view 重定向等技术手段，智能绕过 AWS WAF 挑战
4. 会话管理：支持多会话切换，健康检查工具可一键验证连接状态
5. 错误隔离：批量操作中每个目标独立报错，不会单点失败
局限性与风险
技术依赖风险
- 强制 Chrome 环境：必须安装
fetchproxy扩展并手动构建，对非技术用户门槛较高 - 登录状态脆弱性：依赖浏览器标签页的持续登录状态，Cookie 过期或 WAF 挑战需人工重新干预
- 无官方保障：数据提取依赖 DOM 结构和内联脚本变量名（如
global.uc.sharedReactAppProps），Compass 前端更新可能导致工具失效
功能边界
- 只读限制：无法保存房源、提交询价或访问个人收藏夹（明确标记为"尚未支持"）
- 无市场宏观数据：不提供区域房价趋势、Zestimate 历史等市场报告
- 租赁数据局限：可比租赁查询依赖同城搜索，可能返回空结果
合规考量
- 服务条款灰色地带：虽然通过用户自有浏览器访问，但程序化提取可能违反 Compass 用户协议
- 数据归属：提取的 MLS 数据受房地产经纪行业版权约束，商业用途需谨慎
适合人群
- 房地产投资者和研究人员：需要批量分析 Compass 房源数据的专业人士
- AI 工作流集成者：希望将房产查询自动化嵌入 Claude 等 AI 助手的工作流
- 技术能力较强的购房者：能够完成扩展安装和调试，追求数据透明度的买家
不适合：期望一键安装的非技术用户、需要写入操作（收藏/询价）的场景、依赖实时市场趋势数据的分析师。