核心用法
compass-mcp 是一套针对 Compass 房产平台的 MCP（Model Context Protocol）服务，通过创新的浏览器代理架构解决数据获取难题。由于 Compass 未公开消费者 API，该工具采用 fetchproxy 浏览器扩展将请求路由至用户已登录的 compass.com 标签页，使 AWS WAF 识别为真实浏览器会话而非自动化脚本。
主要功能模块
搜索与详情获取
compass_search_properties：支持地点+筛选条件（价格区间、卧室/浴室数量、房屋类型）的房产搜索compass_get_property：通过 URL 或房源 ID 获取完整记录，包括地址、社区、面积、价格、MLS状态、学区等compass_get_property_photos：提取完整照片库，含原始图与缩略图URL及尺寸compass_get_price_history：获取房源历史事件（挂牌/售出/待售/价格变更/撤牌）
批量处理与对比
compass_resolve_addresses：批量将自由文本地址解析为标准Compass URLcompass_bulk_get：单次最多获取200个房源的详细信息compass_compare_properties：并排对比最多25个房源，可选生成汇总表格
本地计算工具
compass_calculate_mortgage：PITI贷款计算器，支持首付、税费、保险、HOA、PMI等参数compass_calculate_affordability：基于28/36 DTI规则的购买力评估
会话管理
- 支持多会话切换与健康检查，确保WebSocket桥接和扩展连接状态
显著优点
1. 零API密钥架构：完全依赖用户现有Compass登录会话，无需申请开发者权限
2. WAF绕过机制：通过浏览器代理和结构化建议路由（omnisuggest）规避AWS WAF挑战
3. 数据完整性：从服务端渲染的React应用内联脚本提取完整状态，非公开API的替代方案
4. 批量效率：支持并发地址解析和大批量房源获取
5. 本地计算安全：贷款与 affordability 计算完全离线，无网络风险
潜在缺点与局限性
- 登录依赖：核心功能要求用户保持compass.com登录状态，否则抛出
SessionNotAuthenticatedError - 架构复杂度高：需额外安装fetchproxy浏览器扩展并手动构建Chrome扩展包
- 只读限制：无法保存房源、提交联系表单或访问GraphQL端点（如收藏夹、保存搜索）
- 无市场报告：不支持区域级市场数据或历史估价序列（无Zestimate等效功能）
- WAF偶发拦截：新鲜会话或特定自由文本路径仍可能触发403错误
- 维护风险：依赖Compass前端渲染结构，若其架构变更可能导致工具失效
适合人群
- 房产经纪人需批量查询Compass房源信息
- 购房者进行多房源对比和贷款计算
- 数据分析师研究特定区域房产价格历史
- 开发者构建房产相关的AI助手或自动化工作流
常规风险
- 服务稳定性风险：非官方支持方案，Compass可能随时调整前端架构阻断数据提取
- 账户安全风险：工具要求持续登录状态，理论上扩展可访问完整浏览器会话
- 合规灰色地带：绕过WAF和数据抓取可能违反Compass服务条款
- 隐私泄露风险：多会话管理功能若配置不当可能交叉暴露不同用户数据
- 依赖链风险：fetchproxy扩展的维护状态直接影响整个工具可用性