用途:这是一个单一用途的房产估值技能,仅在用户明确提出估值需求时触发。若意图不明确,应先与用户确认,因为调用会消耗积分。若用户还需要照片、学校、经纪人联系方式或价格历史,应改用 zillow-full。
主要能力:提供 get_zestimate 工具(消耗 1 积分)。可传入 zpid(优先,费用更低且可走缓存)或 address;仅传地址时,处理程序会先解析出 zpid。返回 data 字段,包含 zestimate(估值)、rent_zestimate(租金估值)、tax_assessed_value(税务评估价)、last_sold_price(最近成交价)与 currency(如 USD)。
使用方式:需将环境变量 ZILLAPI_KEY 设为 zillapi 的 API 密钥,格式为 zk_...,例如 export ZILLAPI_KEY="zk_..."。可在 https://zillapi.com/signup 获取免费密钥,含 100 积分、无需绑卡;价格方案见 https://zillapi.com/pricing/。调用失败不扣费。
错误处理:处理程序返回字典而非抛出异常。error 为 auth 表示密钥缺失或无效;HTTP 404 表示未找到该房产;HTTP 429 表示触发限流,应退避后重试;network 表示 DNS 或连接失败。
参考:OpenAPI 规范见 https://zillapi.com/openapi.json,REST 文档见 https://zillapi.com/api/properties/。另有托管 MCP 服务器 https://api.zillapi.com/mcp 可作为本技能的替代方案。
限制:zillapi 是独立服务,与 Zillow Group, Inc. 无隶属、认可或赞助关系;Zillow 与 Zestimate 是 Zillow Group, Inc. 的注册商标。具体价格、配额与响应字段以官方站点为准,本资料未提供更多细节。