Zillow MCP — Property Data, Zestimates & Listings for AI Agents

Zillow MCP 支持 Claude 桌面版和 Claude 网页版。

设置 → 连接器 → 添加自定义连接器 → 粘贴：

https://api.zillapi.com/mcp

Claude 会为你完成 OAuth 登录，无需 API 密钥。

想使用密钥或以无头模式运行？改为添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "zillapi": {
      "transport": "streamable-http",
      "url": "https://api.zillapi.com/mcp",
      "headers": {
        "Authorization": "Bearer zk_YOUR_KEY_HERE"
      }
    }
  }
}

Zillow MCP 适用于 Claude Code。

claude mcp add --transport http zillapi https://api.zillapi.com/mcp \
  --header "Authorization: Bearer zk_YOUR_KEY_HERE"

Zillow MCP 适用于 ChatGPT（开发者模式）。

1. 启用开发者模式：设置 → 应用和连接器 → 高级设置。
2. 前往设置 → 连接器 → 添加 MCP 服务（在连接器面板中创建）。
3. 粘贴服务 URL：

https://api.zillapi.com/mcp

4. 按提示完成 OAuth 登录，无需 API 密钥。

Zillow MCP 适用于 Hermes Agent。

在 ~/.hermes/config.yaml 的 mcp_servers 下添加，并使用 OAuth（无需处理密钥）：

mcp_servers:
  zillapi:
    url: "https://api.zillapi.com/mcp"
    auth: oauth

或使用 API 密钥：

mcp_servers:
  zillapi:
    url: "https://api.zillapi.com/mcp"
    headers:
      Authorization: "Bearer zk_YOUR_KEY_HERE"

使用 auth: oauth 时，Hermes 会自动运行 MCP OAuth 2.1 流程（元数据发现 + 动态客户端注册）；此服务开箱即支持该流程。

Zillow MCP 适用于 OpenClaw。

使用 OAuth（无需处理密钥）：

openclaw mcp add zillapi --url https://api.zillapi.com/mcp --transport streamable-http --auth oauth
openclaw mcp login zillapi

或使用 API 密钥：

openclaw mcp set zillapi '{"url":"https://api.zillapi.com/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer zk_YOUR_KEY"}}'

两种配置都会写入 ~/.openclaw/openclaw.json 的 mcp.servers 下：

{
  "mcp": {
    "servers": {
      "zillapi": {
        "url": "https://api.zillapi.com/mcp",
        "transport": "streamable-http",
        "auth": "oauth"
      }
    }
  }
}

更偏好使用技能而非 MCP？Zillapi 也提供可用于 OpenClaw 的 Agent 技能，可在 ZeroPointRepo/zillow-skills 获取。

也可以手动添加到 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）：

{
  "mcpServers": {
    "zillapi": {
      "url": "https://api.zillapi.com/mcp",
      "headers": {
        "Authorization": "Bearer zk_YOUR_KEY_HERE"
      }
    }
  }
}

或通过命令行安装：

code --add-mcp '{"name":"zillapi","type":"http","url":"https://api.zillapi.com/mcp","headers":{"Authorization":"Bearer zk_YOUR_KEY_HERE"}}'

{
  "mcpServers": {
    "zillapi": {
      "url": "https://api.zillapi.com/mcp",
      "type": "streamableHttp",
      "headers": {
        "Authorization": "Bearer zk_YOUR_KEY_HERE"
      }
    }
  }
}

添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "zillapi": {
      "serverUrl": "https://api.zillapi.com/mcp",
      "headers": {
        "Authorization": "Bearer zk_YOUR_KEY_HERE"
      }
    }
  }
}

在 Zed 的 settings.json 中：

{
  "context_servers": {
    "zillapi": {
      "source": "remote",
      "url": "https://api.zillapi.com/mcp",
      "headers": {
        "Authorization": "Bearer zk_YOUR_KEY_HERE"
      }
    }
  }
}

{
  "mcpServers": {
    "zillapi": {
      "type": "streamable-http",
      "url": "https://api.zillapi.com/mcp",
      "headers": {
        "Authorization": "Bearer zk_YOUR_KEY_HERE"
      }
    }
  }
}

在 mcp.json 中：

{
  "mcpServers": {
    "zillapi": {
      "url": "https://api.zillapi.com/mcp",
      "headers": {
        "Authorization": "Bearer zk_YOUR_KEY_HERE"
      }
    }
  }
}

在 ~/.gemini/settings.json 中：

{
  "mcpServers": {
    "zillapi": {
      "httpUrl": "https://api.zillapi.com/mcp",
      "headers": {
        "Authorization": "Bearer zk_YOUR_KEY_HERE"
      }
    }
  }
}

在设置 → 工具 → AI Assistant → MCP 中：

{
  "mcpServers": {
    "zillapi": {
      "url": "https://api.zillapi.com/mcp",
      "headers": {
        "Authorization": "Bearer zk_YOUR_KEY_HERE"
      }
    }
  }
}

将该服务作为托管 MCP 工具添加，URL 为 https://api.zillapi.com/mcp，并设置 Authorization: Bearer zk_YOUR_KEY_HERE 标头（也可以让最终用户通过 OAuth 登录）。任何支持可流式 HTTP MCP 的框架都可以采用相同方式接入。

• 确认 API 密钥以 zk_ 开头
• 复制密钥或端点 URL 时，检查是否包含多余空格
• 确认密钥尚未在 Zillapi 控制面板中撤销
• 如果使用 OAuth，请尝试移除并重新添加连接器，以重新授权

• 在 Zillapi 控制面板中检查积分余额
• 付费方案用户可购买充值包；免费方案用户可在 zillapi.com/pricing 升级
• 失败的调用绝不会收费；402 表示账户余额已空，而不是你已被扣费

• 查询地址时，请包含城市、州和 ZIP 邮编（例如 1600 Pennsylvania Ave NW, Washington DC 20500）
• 确认 zpid 是从 zillow.com/homedetails/..._zpid/ URL 中获取的数字 ID
• 某些地块（新建房产、未挂牌土地）可能尚无 Zillow 记录

• 遵循 Retry-After 标头，并采用指数退避策略
• error.code 是稳定的字符串（rate_limited），无需解析错误文本即可检测
• 触发速率限制的调用不会收费；升级方案可提高每分钟限制

• 清除浏览器 Cookie，然后重试连接器授权
• 确认弹出窗口拦截器没有阻止登录窗口
• OAuth 发现流程从服务的 401 响应开始；如果客户端无法连接，请确认其支持 MCP OAuth 2.1 / DCR，或改用 API 密钥