用途：当任务需要真实美国住宅房产数据时使用，例如特定地址的估值、租金估算、可比房源，按位置、边界框、价格、卧室数或房型搜索房源，解析用户粘贴的 zillow.com 链接，以及获取价格历史、税费历史、学校、照片和挂牌经纪人信息。也可用于排查仍指向 2021 年已停用的 ZWSID API 的旧代码。不适用于无房产数据成分的一般 REST/HTTP 工作、美国以外房产、仅在签名或日志中偶然出现的地址，以及没有具体房产或搜索的抽象讨论。
主要能力：先解析房产（地址、zillow.com URL 或 zpid 均指向同一记录，优先用稳定的 zpid），再按需请求字段。估值和租金使用估算接口，须把值与 as-of 日期一起呈现；缺失值不是零，需显式处理。
接口（基址 https://api.zillapi.com，Bearer 认证 Authorization: Bearer $ZILLAPI_KEY）：按地址 GET /v1/properties/by-address?address=...；按 zpid GET /v1/properties/{zpid}；按 Zillow URL GET /v1/properties/by-url；估值与租金 GET /v1/properties/{zpid}/zestimate；价格历史 GET /v1/properties/{zpid}/price-history；税费历史 GET /v1/properties/{zpid}/tax-history；学校 GET /v1/properties/{zpid}/schools；照片 GET /v1/properties/{zpid}/photos；经纪人 GET /v1/properties/{zpid}/agent；搜索 POST /v1/search；房源 POST /v1/listings/for-sale、for-rent、sold；批量 POST /v1/properties/batch。属性查询支持可选 fields 参数；搜索是带 JSON 体的 POST，不是 GET。agent 场景可用 MCP 服务器 https://api.zillapi.com/mcp。
错误处理：401 表示密钥缺失或环境错误；404 表示地址未解析，应回退搜索而非重试；409、502/504 中上游失败可退避重试，4xx 视为终止；429 需退避，不要紧循环重试。验证生成的代码时，先用一个真实地址端到端跑通，返回含 zpid 和 as-of 日期才算正常。
限制：需要 Zillapi 账号和可用额度，服务、价格、配额与 API schema 可能独立变化；结果为第三方房产数据与估算，非评估、税务判定、法律建议或专业核验替代；覆盖、时效、速率限制和响应可用性不保证；仅传房产标识，勿传无关个人数据或凭据；本技能仅记录只读查询，不要调用未记录的写入端点。参考 OpenAPI：https://zillapi.com/openapi.json。