mcp-zillow-listing-details

Zillow 房源详情 MCP 服务

适用于 Apify 上 Mamba Labs Zillow Listing Details actor 的 MCP 服务。可通过 Zillow 房源 URL、ZPID、地址或 ZIP 代码读取房屋详情。

内容概览

• 功能介绍
• 快速开始
• 前提条件
• 提示词示例
• 工具
• 输入参数
• 定价
• Actor 完整文档
• 许可证

功能介绍

提供 Zillow 房屋 URL、ZPID、街道地址或 ZIP 代码，即可获得每套房屋一行的扁平数据，包含价格、Zestimate、房屋信息和状态；读取房屋页面时，还会返回房屋描述以及 MLS 房源上显示的挂牌经纪人。

所有工作都在 Apify 上运行。此软件包是一个轻量客户端，用于启动 actor 运行、等待运行结束，并返回数据集中的行。

快速开始

你需要 Node.js 18 或更高版本，以及一个带 API 令牌的 Apify 账户。

将以下内容添加到 Claude Desktop 配置（claude_desktop_config.json）、Cursor 或任何 MCP 客户端中：

{
  "mcpServers": {
    "mamba-zillow-listing-details": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-zillow-listing-details"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

重启客户端。随后会出现 read_zillow_listings 工具。

前提条件

• Node.js 18 或更高版本。
• 从 console.apify.com/account/integrations 获取 Apify API 令牌，并将其设置为 APIFY_TOKEN。没有令牌时，服务仍会列出工具；调用工具则需要令牌。

提示词示例

• “这套 Zillow 房屋的价格、Zestimate 和挂牌经纪人分别是什么？”
• “列出 ZIP 代码 78701 中待售的房屋及其信息。”
• “60614 中最近售出的房屋有哪些？售价是多少？”

工具

read_zillow_listings。仅此一个工具。参数示例：

{
  "listings": [
    "97531684"
  ]
}

输入参数

Actor 面向买家的所有输入参数。未提供的参数将采用 actor 自带的默认值。

输入参数	类型	必填	说明
listings	array	否	Zillow 房屋 URL、ZPID 或街道地址，每次运行最多 1,000 条。地址必须包含门牌号和城市或 ZIP 代码，且必须与 Zillow 返回的房屋匹配，否则会得到一条免费记录。
zip_codes	array	否	5 位美国 ZIP 代码。每个代码都会返回 Zillow 对应 ZIP 代码搜索页面中的房屋，最多返回 Maximum listings 条。
listing_status	string	否	for_sale（默认）、for_rent 或 recently_sold。仅用于 ZIP 代码。
read_details	boolean	否	false（默认）或 true。设为 false 时，每个 ZIP 代码会为每套房屋返回一条搜索记录，价格采用搜索记录费率。设为 true 时，actor 会按房源记录费率读取每套房屋的页面，并添加房屋描述和挂牌经纪人。
max_listings	number	否	本次运行最多返回的房屋数，按输入顺序处理所有输入，范围为 1 至 1,000。默认值为 100。可填写文本或数字。
max_charge_usd	string	否	可选。运行会在费用即将超过此金额之前停止。始终会返回汇总记录。

定价

在 Apify 上按事件付费，费用记入你的 Apify 账户。价格以 USD 计。

事件	免费方案	Bronze	Silver	Gold
listing-row，读取一个房屋页面	$0.006	$0.0057	$0.0054	$0.0051
search-row，从 ZIP 代码搜索中获取一套房屋	$0.002	$0.0019	$0.0018	$0.0017
apify-actor-start，每次启动运行	$0.007	$0.007	$0.007	$0.007

被拦截的房屋、缺失的房屋、无法读取的页面以及被拒绝的输入均不收费。Mamba Labs 承担运行的平台费用，包括 Apify 代理流量费用。

Actor 完整文档

apify.com/mambalabs/zillow-listing-details

许可证

MIT。参见 LICENSE。