Zillow MCP Server

Zillow MCP Server

一个托管的 Model Context Protocol（MCP）服务，为 Claude、Cursor、Windsurf 和其他 MCP 客户端提供两个只读的 Zillow 工具。通过丰富的筛选条件搜索待售、待租和已售房源，并以结构化 JSON 完整读取单个房产信息，无需自行托管。

该服务读取 Zillow.com 上未登录访客可以查看的公开房源页面。

每月 1,000 个免费额度，无需绑定银行卡，按基础费率可调用 Zillow 100 次。

https://mcp.hasdata.com/mcp?apis=zillow

• 提示词和资源

目录

• 所需条件
• 快速开始
• 提示词示例
• 工具
• 错误和失败情况
• 定价、免费套餐和限制
• 工具选择
• 比较
• 常见问题
• HasData 链接
• 开发
• 贡献
• 许可证

所需条件

一个 MCP 客户端，以及从控制面板获取的 HasData API 密钥。注册免费且无需绑定银行卡；免费套餐按每次调用 10 个额度计算，每月约可调用 100 次。这是一个远程服务，因此最简单的接入方式是使用 URL 和 x-api-key 请求头，无需运行容器。仅支持 stdio 的客户端可以通过一个轻量启动器连接该服务；启动器已发布到 npm，包名为 @hasdata/zillow-mcp，也发布到了 PyPI，包名为 hasdata-zillow-mcp，如下所示。

快速开始

所有客户端使用相同的服务 URL。我们会在 Claude Code 和 Claude Desktop 中手动运行。其他代码块遵循各客户端为远程服务规定的格式。

支持 OAuth 的客户端可以将相同的 URL 添加为连接器，并登录，而无需将密钥写入配置文件。

claude mcp add --transport http zillow "https://mcp.hasdata.com/mcp?apis=zillow" \
  --header "x-api-key: HASDATA_API_KEY"

{
  "mcpServers": {
    "zillow": {
      "command": "npx",
      "args": ["-y", "@hasdata/zillow-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "zillow": {
      "command": "uvx",
      "args": ["hasdata-zillow-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "zillow": {
      "url": "https://mcp.hasdata.com/mcp?apis=zillow",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "zillow": {
      "serverUrl": "https://mcp.hasdata.com/mcp?apis=zillow",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "servers": {
    "zillow": {
      "type": "http",
      "url": "https://mcp.hasdata.com/mcp?apis=zillow",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

示例提示词

用提示词，不用代码。粘贴一条提示词，Agent 就会自行选择工具。每条提示词都标注了所需的调用次数，因为每次成功调用需花费 10 个积分。

搜索德克萨斯州奥斯汀待售的房屋，至少有 3 间卧室，价格低于 60 万美元，按最新发布排序，并列出最近的 10 套房屋及其价格和挂牌天数。

一次调用，10 个积分。搜索结果会返回价格、卧室数、面积和挂牌天数。

获取排名第一的结果的完整详情：价格历史、税费历史、价格估值和所属学校。

一次调用，10 个积分。这些信息位于房产页面，详情工具会通过 URL 读取。

查找奥斯汀允许养猫的待租公寓，然后获取最便宜的 3 套房屋的租金估值。

4 次调用，40 个积分。先搜索一次，然后分别调用 3 次房产工具。

对于这个房产 URL，提供挂牌价、价格估值，以及价格历史中最近 3 次的出售记录。

一次调用，10 个积分。

搜索结果足以用于排序和初步筛选。价格历史、税费历史、估值、学校和经纪人信息来自房产调用，因此，先筛选再查看 3 套房屋的提示词会产生 1 次搜索调用和 3 次房产调用。

工具

这两个工具均为只读。以下示例摘录自真实调用，并经过删减；数值会随市场变化。请将它们视为数据结构示例。每个工具名称都链接到其端点参考，其中包含完整字段列表。

这些示例仅展示载荷，并非完整响应。tools/call 结果包含一个文本块，该文本块本身是含有 url、status、text 和 json 的 JSON，抓取的数据位于 json 中。对于原始 JSON-RPC 响应，路径为 result.content[0].text，解析后再读取 .json。聊天客户端会为你解包，而直接与端点交互的代码则不会。

获取 Zillow 房产挂牌信息

hasdata_zillow_listing_getRealEstateListings

按位置关键词筛选挂牌信息。

参考文档还介绍了建筑面积、地块面积、建成年份和 HOA 范围，以及 otherAmenities__、views__、pets__、listingType、propertyStatus__、listingPublishOptions__ 等参数。

返回包含 totalResults 的 searchInformation、properties 数组，以及 pagination；其中 nextPage 是下一页的 URL。每个房产包含 id、url、homeType、status、price、currency、租金估值 rentZestimate、daysOnZillow、以平方英尺为单位的 area、addressRaw 和结构化的 address、latitude、longitude、beds、baths、listingDetails、mediaDetails 和 photos。

{
  "id": "60134551",
  "url": "https://www.zillow.com/homedetails/6116-Speyside-Dr-Austin-TX-78754/60134551_zpid/",
  "homeType": "SINGLE_FAMILY",
  "status": "FOR_SALE",
  "price": 320000,
  "currency": "$",
  "rentZestimate": 2286,
  "daysOnZillow": 0,
  "area": 2277,
  "address": { "street": "6116 Speyside Dr", "city": "Austin", "state": "TX", "zipcode": "78754" },
  "beds": 4,
  "baths": 3
}

获取 Zillow 房产详情

hasdata_zillow_property_getPropertyDetails

通过房产 URL 获取单处房产的完整信息。

返回完整页面信息：price、currency、fees、beds、baths、area、yearBuilt、homeType、mlsId、结构化的 address 和 geo、description 和 highlights、photos、schools、daysOnZillow、views、saves、agentInfo 信息块，以及 priceHistory、taxHistory 和 mortgage 数组。Zillow 自有的价格估值以 zestimate 对象返回，其中包含 zestimate、estimatedSaleRange 和 rentZestimate。请将其视为估值，而非已确认的价格。

此处的 area 是一个对象 { livingArea, livingAreaUnits }，而不是搜索工具返回的扁平数值。读取房产页面的平方英尺数时，请使用 area.livingArea；如果将其与 area > 2000 这样的数值进行比较，比较会针对对象进行，因此会静默失败。

{
  "id": 60134551,
  "status": "FOR_SALE",
  "price": 320000,
  "currency": "USD",
  "yearBuilt": 2002,
  "beds": 4,
  "baths": 3,
  "area": { "livingArea": 2277, "livingAreaUnits": "Square Feet" },
  "fees": { "monthlyHoaFee": "$500 annually" },
  "zestimate": { "zestimate": 318100, "estimatedSaleRange": "$302K - $334K", "rentZestimate": 2286 },
  "address": { "street": "6116 Speyside Dr", "county": "Travis County" },
  "agentInfo": { "agentName": "Marie Coleman", "brokerName": "eXp Realty" },
  "priceHistory": [{ "date": "2026-08-24", "price": 320000, "event": "listedForSale" }],
  "schools": { "elementarySchool": { "name": "Bluebonnet Trail", "district": "Manor ISD" } }
}

提示词和资源

该服务提供 2 个提示词，即客户端可直接提供给用户的现成工作流，无需用户自行编写工具调用。

此外，该服务还公开 11 个资源，每个资源对应一个可接受值为固定列表的参数。读取资源比从被拒绝的调用中了解参数词汇更省事，而且不消耗额度。每个 URI 的格式均为 hasdata://zillow/<parameter>。

两个列表均无需 API 密钥即可获取，因此客户端可以在用户注册前读取它们。

错误和失败情况

客户端几乎不会从工具调用中看到 HTTP 错误代码。MCP 层会返回 200，并将失败信息放在结果中，设置 isError 为 true，并以文本形式提供原因。Agent 会读取错误消息，而不是你可能预期的状态行。

密钥错误会显示为工具输出，而不是连接失败。 tools/list 接受任何非空密钥，并返回两个工具，因此客户端可以完成握手并显示绿色状态。随后首次工具调用会返回 isError: true，文本为 HasData API error: 401 Unauthorized。请留意此字符串，因为流程中此前不会报告问题。

缺少密钥是唯一真正的 HTTP 错误。 授权会在调用任何工具前执行，连接本身会以 401 失败。响应中包含 CORS 标头，浏览器客户端会读取状态，而不会只收到不透明的网络错误。

违反工具架构的参数会在发起抓取前被拒绝。 服务会返回 isError: true，文本为 MCP error -32602: Input validation error，并指出有问题的字段。不会获取任何数据，也不会扣费。

搜索没有匹配项时，会返回成功结果，其中 properties 数组为空，而不是报错。即使某个位置和筛选条件下没有房源，返回结果中的 requestMetadata.status 仍会设为 ok。迭代数组前请先检查数组长度。

已下架的房产会返回 400，且 requestMetadata.status 会设为 error。旧搜索中的 URL 可能指向已经下架的房源。

包含数据的结果也会带有 requestMetadata.id，在联系支持时值得提供。

定价、免费套餐和限制

每次成功调用 Zillow 工具需 10 个点数。启用 extractAgentEmails 会让房产调用额外增加 5 个点数，变为 15 个，而不是 10 个；除非需要邮箱，否则请保持关闭。响应大小不会改变价格。

免费套餐每月提供 1,000 个点数，无需绑定银行卡，按基础费率可调用 Zillow 100 次。点数会随计费周期续期，因此低调用量的经纪人可以一直使用免费套餐。

付费套餐起价为每月 $59，包含 200,000 个点数，也就是 20,000 次调用。随着用量增加，单价会降低：入门套餐每 1,000 次调用为 $1.48，Basic 套餐为 $0.60，Growth 各套餐为 $0.41。最新价格请查看定价页面。

套餐还决定并发数。免费套餐允许同时发起 1 个请求，Startup 为 5 个，Basic 为 15 个，Growth 各套餐为 50 到 500 个。在任何无人值守的任务中，都应妥善处理超出并发限制的情况。

返回非 200 状态码的请求不收费。成功调用但未找到结果，仍会计为一次调用。

工具选择

apis 查询参数决定 Agent 能看到哪些工具。工具越少，工具定义占用的上下文就越少，模型选错工具的机会也越少。

?apis=zillow                     the two tools in this repo
?apis=zillow,redfin              add Redfin real estate
?apis=zillow,google_maps         add Google Maps places

该参数接受 zillow 这样的服务提供方名称，也接受 zillow_listing 这样的单个 API 名称。拼写错误的名称会被忽略。如果所有名称都无效，请求会失败并返回 400，响应正文会列出无法识别的名称和所有有效值。移除该参数后，同一端点会公开全部 57 个 HasData 工具。

对比

Zillow 自有 API 项目面向会员和合作伙伴，用于处理自有房源，例如 Bridge Interactive 和 Mortgage API，并非一种可自助使用的方式来读取公开市场。要搜索房源并查看任意房产信息，可以抓取公开页面；本服务会在幕后完成这项工作，并提供稳定的架构。

本服务不提供的功能。 不支持发布信息、提交潜在客户信息或读取账户数据。它只读取未登录访客在 Zillow.com 上可以看到的内容。

常见问题

Zillow 有官方的 MCP 服务吗？

Zillow 没有发布官方 MCP 服务。这个服务由 HasData 维护，读取 Zillow.com 的公开页面。

什么是 Zillow MCP 服务？

它是一种将 Zillow 房源数据作为工具提供给 AI 客户端调用的服务。客户端通过模型上下文协议发送工具调用，服务获取数据并返回结构化 JSON，模型再处理结果。本服务提供两个工具，并在远程运行。

我需要 Zillow 账户或 API 密钥吗？

不需要。唯一需要的凭据是 HasData 密钥。这些工具读取 Zillow.com 的公开页面。

为什么搜索结果没有显示价格历史或学校信息？

因为 Zillow 不会在搜索卡片上显示这些信息。它们位于房产页面中，详情工具会通过 URL 读取该页面。先搜索并筛选房源，再调用房产工具获取详细信息。

价格估值代表什么？

zestimate 对象包含 Zillow 自己的估值、估值范围以及租金估算。这是模型的输出，并非评估价或确认的成交价。请将其视为估算值。

我可以将它与其他 HasData API 一起使用吗？

可以。apis 参数接受一个列表，?apis=zillow,redfin 会让 Agent 同时使用 Zillow 和 Redfin。移除此参数即可获取所有工具。

HasData 与 Zillow 有关联吗？

没有。HasData 是一项独立服务，与 Zillow Group, Inc. 无关联，也未获其认可或赞助。Zillow 是其各自所有者的商标。

合规与个人数据

HasData 仅访问公开数据。平台的条款可能会限制自动化访问，您需自行负责遵守相关规定。如果您收集的数据包含个人信息，例如房源经纪人的联系方式，请确保您依据 GDPR、CCPA 或您所在司法管辖区的同等法规拥有合法依据。

HasData 链接

开发

此代码库包含远程服务的配置和文档。无需构建，也无需容器化。

test/ 中的测试用于验证工具契约，这是可能在没有提交到此处的改动时发生变化的部分。测试会检查 ?apis=zillow 是否恰好返回两个工具、每个工具是否仍声明其必需参数、名称是否未变，以及实际使用的密钥是否确实有效。最后一项检查会实际调用工具并花费 10 个积分，这是一次可能因合理原因而失败的探测检查所需的成本。

# macOS and Linux
HASDATA_API_KEY=your_key_here npm test

# Windows PowerShell
$env:HASDATA_API_KEY="your_key_here"; npm test

同一套测试会在每次推送时于 CI 中运行，并按计划每周运行一次，因为上游工具列表可能在无人修改此代码库的情况下发生变化。测试失败意味着工具列表发生了变动、密钥停止工作或端点无法访问，断言消息会指出具体原因。

贡献

修正工具表格和响应示例是最有价值的贡献，因为这些内容最容易过时。请附上您执行的调用和收到的响应。来自分支的拉取请求会在不使用密钥的情况下运行测试套件，实时检查会跳过，而不会导致测试失败。

许可证

MIT。请参阅 LICENSE。