用途:这是一套基于 zillapi REST API 的 Zillow 房产数据查询工具,共九个工具,用于查询美国具体房产或进行挂牌搜索。每次调用都会消耗积分,因此仅在实际涉及具体房产或挂牌搜索时调用;意图不明确时应先与用户确认。
主要能力:lookup_property_by_address(按美国地址查完整记录,地址可为较宽松的字符串,6 个字符以上)、lookup_property_by_url(按粘贴的 zillow.com/homedetails/... 链接查完整记录)、lookup_property_by_zpid(已知 zpid 时查完整记录,数据新鲜时由缓存提供)各消耗 1 积分;get_zestimate(仅返回 Zestimate、租金 Zestimate、税务评估价、上次成交价);search_listings(按位置或 bbox 加筛选条件查在售、待租或已售挂牌,每个结果消耗 1 积分);get_price_history(挂牌价变动、成交价、撤牌);get_property_photos(照片库,返回响应式图片 URL);get_property_schools(分配学校及 GreatSchools 评分);get_listing_agent(在售挂牌的挂牌经纪人与经纪公司联系方式)。应选用最窄的工具:估值问题用 get_zestimate,比拉取完整记录更合适;完整记录会返回 250 多个字段,用户只要某一维度时应优先使用子资源工具。
使用方式:设置环境变量 ZILLAPI_KEY 为你的 Zillapi API 密钥(格式 zk_...),例如 export ZILLAPI_KEY="zk_..."。免费密钥可在 https://zillapi.com/signup 获取,含 100 积分且无需信用卡;套餐与当前价格见 https://zillapi.com/pricing/。参数细节与响应字段说明见 reference.md;OpenAPI 规范见 https://zillapi.com/openapi.json;REST 文档见 https://zillapi.com/api/properties/;也可使用托管 MCP 服务器 https://api.zillapi.com/mcp 作为该技能的替代方案。
限制:所有函数返回 Python dict,不会抛出异常,错误以 error 字段返回,如 auth(密钥缺失或无效)、HTTP 404(未找到房产)、HTTP 422(参数值错误)、HTTP 429(限流,需退避重试)、network(DNS 或连接失败)。部分参数细节、响应字段说明、各套餐实际价格与配额等资料未完整提供。zillapi 为独立服务,与 Zillow Group, Inc. 无隶属、背书或赞助关系;“Zillow”和“Zestimate”是 Zillow Group, Inc. 的注册商标。