Zillow MCP Server

基本能力

产品定位

Zillow MCP Server 是一个提供实时房地产数据访问的服务，主要用于房产搜索、市场趋势分析和金融计算。

核心功能

• 🏠 房产搜索：根据位置、价格范围和房产特征搜索房产
• 💰 房产详情：获取特定房产的详细信息
• 📊 Zestimate：访问 Zillow 的专有房产估值数据
• 📈 市场趋势：查看任何位置的房地产市场趋势
• 🧮 抵押贷款计算器：根据各种输入计算抵押贷款支付
• 🔍 健康检查：验证 API 连接性和监控性能

适用场景

• 房产搜索平台
• 房地产投资分析工具
• 抵押贷款计算应用
• 房地产市场趋势分析

工具列表

1. Search Properties：根据各种标准搜索房产
2. Get Property Details：获取特定房产的详细信息
3. Get Zestimate：获取房产的 Zestimate 估值
4. Get Market Trends：获取特定位置的房地产市场趋势
5. Calculate Mortgage：计算抵押贷款支付和相关成本
6. Check Health：验证 Zillow API 连接性和获取服务器状态
7. Get Server Tools：获取服务器上所有可用工具的列表

常见问题解答

• Zillow 的 API 有使用限制（通常每天每个数据集 1000 次请求）
• Zillow 的服务条款禁止本地存储数据；所有请求必须是动态的
• 必须在用户界面中正确归属数据给 Zillow
• Bridge API 格式可能会更改；请参考 Zillow 的文档以获取更新

使用教程

使用依赖

• Python 3.8 或更高版本
• Zillow Bridge API 密钥（在 [email protected] 申请访问权限）

安装教程

1. 克隆仓库： git clone https://github.com/yourusername/zillow-mcp-server.git cd zillow-mcp-server

2. 安装依赖： pip install -r requirements.txt

3. 创建 .env 文件并添加 Zillow API 密钥： ZILLOW_API_KEY=your_zillow_api_key_here

运行服务器

# 标准 stdio 模式（用于 Claude Desktop）
python zillow_mcp_server.py

# HTTP 服务器模式（用于远程访问）
python zillow_mcp_server.py --http --port 8000

# 调试模式（更详细的日志记录）
python zillow_mcp_server.py --debug

Docker 部署

# 构建 Docker 镜像
docker build -t zillow-mcp-server .

# 运行并设置环境变量
docker run -p 8000:8000 -e ZILLOW_API_KEY=your_key_here zillow-mcp-server

# 或使用 env 文件
docker run -p 8000:8000 --env-file .env zillow-mcp-server

调试方式

• 使用 --debug 参数运行服务器以获取详细日志
• 使用 check_health() 工具验证 API 连接性
• 检查日志文件以获取错误信息

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。