zillow-mcp 0.2.0 → 0.2.2

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "MCP server for Zillow — search listings, fetch property details, Zestimate history, saved searches & homes, market reports. Routes through the user's signed-in zillow.com tab via the fetchproxy browser extension to dodge bot detection.",
-    "version": "0.2.0"
+    "version": "0.2.2"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "Zillow",
       "source": "./",
       "description": "MCP server for Zillow — search listings, get property details, Zestimate history, saved searches & homes, market reports",
-      "version": "0.2.0",
+      "version": "0.2.2",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "zillow-mcp",
   "displayName": "Zillow",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Zillow real-estate access for Claude — search listings, get property details, Zestimate history, your saved searches & homes, market reports",
   "author": {
     "name": "Chris Hall",

package/dist/bundle.js

@@ -36668,6 +36668,40 @@ function textResult(data) {
   };
 }
 
+// src/next-data.ts
+var ParseError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ParseError";
+  }
+};
+var OPEN_TAG_RE = /<script[^>]*id=["']__NEXT_DATA__["'][^>]*>/i;
+var CLOSE_TAG = "</script>";
+function extractNextData(html) {
+  const openMatch = OPEN_TAG_RE.exec(html);
+  if (!openMatch) {
+    throw new ParseError("__NEXT_DATA__ script tag not found in HTML");
+  }
+  const start = openMatch.index + openMatch[0].length;
+  const end = html.indexOf(CLOSE_TAG, start);
+  if (end < 0) {
+    throw new ParseError("__NEXT_DATA__ script tag has no closing </script>");
+  }
+  const json2 = html.slice(start, end).trim();
+  try {
+    return JSON.parse(json2);
+  } catch (err) {
+    throw new ParseError(
+      `Failed to parse __NEXT_DATA__ JSON: ${err.message}`
+    );
+  }
+}
+function getPageProps(nextData) {
+  const props = nextData.props;
+  const pageProps = props?.pageProps;
+  return pageProps ?? {};
+}
+
 // src/tools/search.ts
 var HOME_TYPE_FILTERS = {
   house: "isSingleFamily",
@@ -36703,7 +36737,7 @@ function formatListing(raw) {
     url: url2
   };
 }
-function buildSearchBody(input) {
+function buildSearchQueryState(input) {
   const filterState = {};
   switch (input.status ?? "for_sale") {
     case "for_rent":
@@ -36745,17 +36779,18 @@ function buildSearchBody(input) {
     }
   }
   return {
-    searchQueryState: {
-      usersSearchTerm: input.location,
-      filterState,
-      isMapVisible: false,
-      isListVisible: true
-    },
-    wants: { cat1: ["listResults"] },
-    requestId: 1,
-    isDebugRequest: false
+    usersSearchTerm: input.location,
+    filterState,
+    isListVisible: true,
+    isMapVisible: false
   };
 }
+function buildSearchPath(input) {
+  const sqs = buildSearchQueryState(input);
+  const slug = encodeURIComponent(input.location.trim());
+  const qs = encodeURIComponent(JSON.stringify(sqs));
+  return `/homes/${slug}_rb/?searchQueryState=${qs}`;
+}
 function registerSearchTools(server2, client2) {
   server2.registerTool(
     "zillow_search_properties",
@@ -36792,9 +36827,12 @@ function registerSearchTools(server2, client2) {
       }
     },
     async (input) => {
-      const body = buildSearchBody(input);
-      const data = await client2.fetchJson("/async-create-search-page-state/", { method: "POST", body });
-      const raw = data.cat1?.searchResults?.listResults ?? [];
+      const path = buildSearchPath(input);
+      const html = await client2.fetchHtml(path);
+      const nextData = extractNextData(html);
+      const pageProps = getPageProps(nextData);
+      const sps = pageProps.searchPageState;
+      const raw = sps?.cat1?.searchResults?.listResults ?? [];
       const limit = input.limit ?? 40;
       const formatted = raw.map(formatListing).filter((x) => x !== null).slice(0, limit);
       return textResult(formatted);
@@ -36802,40 +36840,6 @@ function registerSearchTools(server2, client2) {
   );
 }
 
-// src/next-data.ts
-var ParseError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "ParseError";
-  }
-};
-var OPEN_TAG_RE = /<script[^>]*id=["']__NEXT_DATA__["'][^>]*>/i;
-var CLOSE_TAG = "</script>";
-function extractNextData(html) {
-  const openMatch = OPEN_TAG_RE.exec(html);
-  if (!openMatch) {
-    throw new ParseError("__NEXT_DATA__ script tag not found in HTML");
-  }
-  const start = openMatch.index + openMatch[0].length;
-  const end = html.indexOf(CLOSE_TAG, start);
-  if (end < 0) {
-    throw new ParseError("__NEXT_DATA__ script tag has no closing </script>");
-  }
-  const json2 = html.slice(start, end).trim();
-  try {
-    return JSON.parse(json2);
-  } catch (err) {
-    throw new ParseError(
-      `Failed to parse __NEXT_DATA__ JSON: ${err.message}`
-    );
-  }
-}
-function getPageProps(nextData) {
-  const props = nextData.props;
-  const pageProps = props?.pageProps;
-  return pageProps ?? {};
-}
-
 // src/url.ts
 function urlToPath(input) {
   try {
@@ -37030,6 +37034,17 @@ function findSavedSearches(pageProps) {
   );
 }
 function findSavedHomes(pageProps) {
+  const collections = pageProps.collectionsResponse;
+  if (Array.isArray(collections)) {
+    const flat = [];
+    for (const c of collections) {
+      if (Array.isArray(c.homes)) flat.push(...c.homes);
+      else if (Array.isArray(c.properties)) flat.push(...c.properties);
+      else if (Array.isArray(c.items)) flat.push(...c.items);
+    }
+    if (flat.length > 0) return flat;
+    if (collections.length > 0) return [];
+  }
   return findArrayByShape(
     pageProps,
     SAVED_HOME_KEYS,
@@ -37080,7 +37095,7 @@ function registerSavedTools(server2, client2) {
       inputSchema: {}
     },
     async () => {
-      const html = await client2.fetchHtml("/user/savedSearches/");
+      const html = await client2.fetchHtml("/myzillow/SavedSearches");
       const nextData = extractNextData(html);
       const pageProps = getPageProps(nextData);
       const searches = findSavedSearches(pageProps);
@@ -37091,7 +37106,7 @@ function registerSavedTools(server2, client2) {
     "zillow_get_saved_homes",
     {
       title: "Get my saved (favorited) Zillow homes",
-      description: "The signed-in user's saved (favorited) homes on zillow.com. Returns address, price, Zestimate, status, and when each home was saved. Requires the user to be signed in. Read-only; safe to call repeatedly.",
+      description: "The signed-in user's saved (favorited) homes on zillow.com, flattened across all of the user's collections. Returns address, price, Zestimate, status, and when each home was saved. Requires the user to be signed in. Read-only; safe to call repeatedly.",
       annotations: {
         title: "Get my saved (favorited) Zillow homes",
         readOnlyHint: true,
@@ -37101,7 +37116,7 @@ function registerSavedTools(server2, client2) {
       inputSchema: {}
     },
     async () => {
-      const html = await client2.fetchHtml("/myzillow/favorites/");
+      const html = await client2.fetchHtml("/myzillow/favorites");
       const nextData = extractNextData(html);
       const pageProps = getPageProps(nextData);
       const homes = findSavedHomes(pageProps);
@@ -37111,35 +37126,34 @@ function registerSavedTools(server2, client2) {
 }
 
 // src/tools/market.ts
-function pickMarketInfo(pageProps) {
-  const candidates = [
-    pageProps.marketInfo,
-    pageProps.marketReport,
-    pageProps.regionInfo,
-    pageProps.componentProps?.marketInfo
-  ];
+function pickRegion(pageProps) {
+  const candidates = [pageProps.zhviRegion, pageProps.requestedRegion];
   for (const c of candidates) {
     if (c && typeof c === "object") return c;
   }
   return null;
 }
-function format2(raw) {
+function pickAnalytics(pageProps) {
+  const a = pageProps.odpMarketAnalytics;
+  if (a && typeof a === "object") return a;
+  return null;
+}
+function format2(region, analytics) {
+  const yoy = typeof analytics?.zhviLatest?.zhviYoY === "number" ? Math.round(analytics.zhviLatest.zhviYoY * 1e3) / 10 : void 0;
   return {
-    region_id: raw.regionId,
-    region_name: raw.regionName,
-    region_type: raw.regionType,
-    median_sale_price: raw.medianSalePrice,
-    median_list_price: raw.medianListPrice,
-    median_rent_price: raw.medianRentPrice,
-    median_days_on_market: raw.medianDaysOnMarket,
-    inventory_count: raw.inventoryCount,
-    new_listings: raw.newListings,
-    pending_sales: raw.pendingSales,
-    zhvi: raw.zhvi,
-    zhvi_yoy_percent: raw.zhviYoYPercent,
-    for_sale_by_category: raw.forSaleByCategory,
-    buyer_seller_index: raw.buyerSellerIndex,
-    as_of_date: raw.asOfDate
+    region_name: region?.name,
+    region_type: region?.regionTypeName,
+    parent_county: region?.parentCounty?.name,
+    parent_state: region?.parentState?.name,
+    median_sale_price: analytics?.mrktSaleLatest?.medianSalePrice,
+    median_list_price: analytics?.mrktListingLatest?.medianListPrice,
+    median_days_on_market: analytics?.mrktListingLatest?.medianDaysOnMarket,
+    days_to_pending: analytics?.mrktSaleLatest?.daysToPending,
+    new_listings: analytics?.mrktListingLatest?.newListings,
+    for_sale_inventory: analytics?.mrktListingLatest?.forSaleInventory,
+    zhvi: analytics?.zhviLatest?.zhvi,
+    zhvi_yoy_percent: yoy,
+    as_of_date: analytics?.zhviLatest?.asOfDate
   };
 }
 function pathFromInput(args) {
@@ -37157,7 +37171,7 @@ function registerMarketTools(server2, client2) {
     "zillow_get_market_report",
     {
       title: "Get Zillow market report for a region",
-      description: 'Market report for a Zillow region: median sale/list/rent prices, days on market, inventory, Zillow Home Value Index (ZHVI), year-over-year ZHVI change, and buyer/seller balance. Provide either a `region_path` (e.g. "/home-values/6181/brooklyn-ny/") or a full Zillow home-values URL. Read-only; safe to call repeatedly.',
+      description: 'Market report for a Zillow region: median sale/list prices, days on market, for-sale inventory, new listings, Zillow Home Value Index (ZHVI), and year-over-year ZHVI change. Provide either a `region_path` (e.g. "/home-values/6181/brooklyn-ny/") or a full Zillow home-values URL. Read-only; safe to call repeatedly.',
       annotations: {
         title: "Get Zillow market report for a region",
         readOnlyHint: true,
@@ -37176,13 +37190,14 @@ function registerMarketTools(server2, client2) {
       const html = await client2.fetchHtml(path);
       const nextData = extractNextData(html);
       const pageProps = getPageProps(nextData);
-      const market = pickMarketInfo(pageProps);
-      if (!market) {
+      const region = pickRegion(pageProps);
+      const analytics = pickAnalytics(pageProps);
+      if (!region && !analytics) {
         throw new Error(
-          `Could not locate marketInfo in __NEXT_DATA__ at ${path}.`
+          `Could not locate market data (zhviRegion + odpMarketAnalytics) in __NEXT_DATA__ at ${path}.`
         );
       }
-      return textResult(format2(market));
+      return textResult(format2(region, analytics));
     }
   );
 }
@@ -37266,7 +37281,7 @@ function registerMortgageTools(server2) {
 }
 
 // src/index.ts
-var VERSION = "0.2.0";
+var VERSION = "0.2.2";
 var port = process.env.ZILLOW_WS_PORT ? Number(process.env.ZILLOW_WS_PORT) : void 0;
 var transport = new FetchproxyTransport({ port, version: VERSION });
 var client = new ZillowClient({ transport });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zillow-mcp",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "mcpName": "io.github.chrischall/zillow-mcp",
   "description": "Zillow MCP server for Claude — developed and maintained by AI (Claude Code)",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",

package/server.json

@@ -1,17 +1,17 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.chrischall/zillow-mcp",
-  "description": "Zillow real-estate access for Claude — search listings, fetch property details, Zestimate history, saved searches & homes, market reports. Auth via the user's signed-in zillow.com browser tab through the fetchproxy extension.",
+  "description": "Zillow real-estate for Claude — search, property details, Zestimates, saved searches & homes",
   "repository": {
     "url": "https://github.com/chrischall/zillow-mcp",
     "source": "github"
   },
-  "version": "0.2.0",
+  "version": "0.2.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "zillow-mcp",
-      "version": "0.2.0",
+      "version": "0.2.2",
       "transport": {
         "type": "stdio"
       },