Skill: nikhonit/zillow-full (version 1.0.1)

--- name: zillow-full version: 1.0.1 description: Complete Zillow property data toolkit via Zillapi.com. Nine tools — address/URL/zpid lookup, Zestimate, listings search, photos, schools, price history, agent contact. license: MIT-0 author: Zillapi homepage: https://zillapi.com repository: https://github.com/nikhonit/zillow-skills tags: - zillow - real-estate - property-data - zestimate - listings - api - mcp metadata: openclaw: primaryEnv: ZILLAPI_KEY homepage: https://zillapi.com requires: env: - ZILLAPI_KEY --- # zillow-full Complete Zillow property data toolkit via Zillapi.com. Use when the user **explicitly asks** about a U.S. property, its value, listings to buy or rent, or related real-estate data. ## When to use this skill Each tool call consumes Zillapi credits, so this skill activates only when the user's request is genuinely about real-estate data — not when an address or Zillow link merely appears in passing. **DO use when the user:** - Asks about a Zestimate, property value, rent estimate, or tax-assessed value → `get_zestimate` - Pastes a Zillow URL and asks about that property → `lookup_property_by_url` - Gives an address and asks about the property, schools, photos, or agent → `lookup_property_by_address` - Asks to find homes matching criteria (location, price range, beds, baths) → `search_listings` - Asks for the price history, last sale, or ownership timeline of a known property → `get_price_history` - Asks for the listing agent or broker contact → `get_listing_agent` - Asks what schools serve a property → `get_property_schools` - Asks to see photos of a property → `get_property_photos` **Do NOT use when:** - An address appears incidentally in context (email signatures, news articles, copy-pasted unrelated content) - The user is discussing real estate abstractly without asking for data on a specific property or listing search - The user has not signaled they want a property lookup When the intent is ambiguous, ask the user to confirm before calling a tool. These tools cost credits and return large records the user may not want. ## Tools ### `lookup_property_by_address` — 1 credit Look up a single property by U.S. address. Returns the full property record: price, beds, baths, sqft, year built, lot size, Zestimate, rent Zestimate, tax assessed value, price history, photos, schools, agent contact, lat/lon, home type, home status, and 250+ additional fields. Use this when the user gives an address. Address strings as loose as `123 Main St, Austin TX` work — the API tolerates partial addresses ≥6 characters. ### `lookup_property_by_url` — 1 credit Same as above but takes a Zillow.com URL. Use this when the user pastes a `zillow.com/homedetails/...` link. ### `lookup_property_by_zpid` — 1 credit (cache-served when fresh) Look up a property by Zillow zpid. Use this when you already have the zpid from a previous call. Cheaper because the response can be served from cache. ### `get_zestimate` — 1 credit Get just the Zestimate, rent Zestimate, tax-assessed value, and last-sold price for a property. Use this when you only need the valuation, not the full record. ### `search_listings` — 1 credit per result, up to 50 Search active for-sale, for-rent, or sold listings. Filter by location (city/state/ZIP) or bounding box, price, beds, baths, sqft, year built, home type, and days on Zillow. ### `get_price_history` — 1 credit Get the price and listing-status history for a property (list price changes, sale prices, withdrawals). ### `get_property_photos` — 1 credit Get the photo gallery for a property (responsive image URLs at multiple resolutions). ### `get_property_schools` — 1 credit Get the assigned elementary, middle, and high schools for a property with GreatSchools ratings. ### `get_listing_agent` — 1 credit Get the listing agent and broker contact (name, email, phone, license number) for an active listing. ## Authentication Set `ZILLAPI_KEY` to your Zillapi API key. Keys are `zk_...` strings. ```bash export ZILLAPI_KEY="zk_..." ``` Get a free key with 100 credits at <https://zillapi.com/signup> — no card required. ## Pricing | Plan | Price | Credits | Rate limit | Top-ups | |---|---|---|---|---| | Free | $0 | 100 (one-time) | 20/min | not available | | Monthly | $5/mo | 1,000/month | 200/min | $4 per 1,000 | | Annual | $54/yr | 12,000 upfront | 300/min | $3 per 1,000 | One credit equals one property record returned. Failed calls do not consume credits. Top-ups are available on Monthly and Annual plans only. ## Errors All functions return a Python dict. On success the dict contains the API response. On failure the dict contains an `error` key: - `{"error": "auth", ...}` — `ZILLAPI_KEY` is missing or invalid - `{"error": "HTTP 404", ...}` — property not found - `{"error": "HTTP 429", ...}` — rate-limited; back off and retry - `{"error": "network", ...}` — DNS/connection failure ## API reference - OpenAPI spec: <https://zillapi.com/openapi.json> - REST docs: <https://zillapi.com/api/properties/> - Hosted MCP server (alternative to this skill): <https://api.zillapi.com/mcp> ## Trademark Zillapi is an independent service and is not affiliated with, endorsed by, or sponsored by Zillow Group, Inc. "Zillow" and "Zestimate" are registered trademarks of Zillow Group, Inc.


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)