@opentabs-dev/opentabs-plugin-zillow 0.0.74

package/dist/tools/search-new-construction.d.ts

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+export declare const searchNewConstruction: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    region_id: z.ZodOptional<z.ZodNumber>;
+    region_type: z.ZodOptional<z.ZodString>;
+    map_bounds: z.ZodOptional<z.ZodObject<{
+        west: z.ZodNumber;
+        east: z.ZodNumber;
+        south: z.ZodNumber;
+        north: z.ZodNumber;
+    }, z.core.$strip>>;
+    min_price: z.ZodOptional<z.ZodNumber>;
+    max_price: z.ZodOptional<z.ZodNumber>;
+    min_beds: z.ZodOptional<z.ZodNumber>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        globalrelevanceex: "globalrelevanceex";
+        days: "days";
+        pricea: "pricea";
+        priced: "priced";
+        size: "size";
+    }>>;
+    page: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    total: z.ZodNumber;
+    listings: z.ZodArray<z.ZodObject<{
+        zpid: z.ZodString;
+        address: z.ZodString;
+        street: z.ZodString;
+        city: z.ZodString;
+        state: z.ZodString;
+        zipcode: z.ZodString;
+        price: z.ZodString;
+        price_raw: z.ZodNumber;
+        beds: z.ZodNumber;
+        baths: z.ZodNumber;
+        sqft: z.ZodNumber;
+        status: z.ZodString;
+        status_text: z.ZodString;
+        home_type: z.ZodString;
+        days_on_zillow: z.ZodNumber;
+        zestimate: z.ZodNumber;
+        rent_zestimate: z.ZodNumber;
+        tax_assessed_value: z.ZodNumber;
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        image_url: z.ZodString;
+        detail_url: z.ZodString;
+        is_saved: z.ZodBoolean;
+        has_3d_model: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=search-new-construction.d.ts.map

package/dist/tools/search-new-construction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-new-construction.d.ts","sourceRoot":"","sources":["../../src/tools/search-new-construction.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA8EhC,CAAC"}

package/dist/tools/search-new-construction.js

@@ -0,0 +1,78 @@
+import { defineTool, ToolError } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { search, REGION_TYPE_MAP } from '../zillow-api.js';
+import { listingSchema, mapListing } from './schemas.js';
+export const searchNewConstruction = defineTool({
+    name: 'search_new_construction',
+    displayName: 'Search New Construction',
+    description: 'Search for new construction properties on Zillow. Requires either a region_id (from search_locations) or map_bounds. Filters to new construction homes including those coming soon.',
+    summary: 'Find new construction homes',
+    icon: 'hammer',
+    group: 'Search',
+    input: z.object({
+        region_id: z
+            .number()
+            .int()
+            .optional()
+            .describe('Zillow region ID (from search_locations). Required if map_bounds is not provided.'),
+        region_type: z
+            .string()
+            .optional()
+            .describe('Region type: "city", "county", "zipcode", "neighborhood" (default "city")'),
+        map_bounds: z
+            .object({
+            west: z.number().describe('Western longitude'),
+            east: z.number().describe('Eastern longitude'),
+            south: z.number().describe('Southern latitude'),
+            north: z.number().describe('Northern latitude'),
+        })
+            .optional()
+            .describe('Map bounding box. Required if region_id is not provided.'),
+        min_price: z.number().optional().describe('Minimum price in dollars'),
+        max_price: z.number().optional().describe('Maximum price in dollars'),
+        min_beds: z.number().int().optional().describe('Minimum bedrooms'),
+        sort: z
+            .enum(['globalrelevanceex', 'days', 'pricea', 'priced', 'size'])
+            .optional()
+            .describe('Sort order (default "globalrelevanceex")'),
+        page: z.number().int().min(1).optional().describe('Page number (default 1)'),
+    }),
+    output: z.object({
+        total: z.number().describe('Total new construction listings'),
+        listings: z.array(listingSchema).describe('New construction listings'),
+    }),
+    handle: async (params) => {
+        if (!params.region_id && !params.map_bounds) {
+            throw ToolError.validation('Either region_id or map_bounds is required.');
+        }
+        const filterState = {
+            isNewConstruction: { value: true },
+            isForSaleByAgent: { value: false },
+            isForSaleByOwner: { value: false },
+            isComingSoon: { value: false },
+            isAuction: { value: false },
+            isForSaleForeclosure: { value: false },
+        };
+        if (params.sort)
+            filterState.sortSelection = { value: params.sort };
+        if (params.min_price || params.max_price)
+            filterState.price = { min: params.min_price, max: params.max_price };
+        if (params.min_beds)
+            filterState.beds = { min: params.min_beds };
+        const bounds = params.map_bounds ?? { west: -122.5, east: -122.3, south: 37.7, north: 37.8 };
+        const data = await search({
+            pagination: params.page && params.page > 1 ? { currentPage: params.page } : undefined,
+            mapBounds: bounds,
+            regionSelection: params.region_id
+                ? [{ regionId: params.region_id, regionType: REGION_TYPE_MAP[params.region_type ?? 'city'] ?? 6 }]
+                : undefined,
+            filterState,
+            isMapVisible: true,
+        }, { cat1: ['listResults', 'total'] });
+        return {
+            total: data.categoryTotals?.cat1?.totalResultCount ?? data.cat1?.searchResults?.listResults?.length ?? 0,
+            listings: (data.cat1?.searchResults?.listResults ?? []).map(mapListing),
+        };
+    },
+});
+//# sourceMappingURL=search-new-construction.js.map

package/dist/tools/search-new-construction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-new-construction.js","sourceRoot":"","sources":["../../src/tools/search-new-construction.ts"],"names":[],"mappings":"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"}

package/dist/tools/search-open-houses.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+export declare const searchOpenHouses: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    region_id: z.ZodOptional<z.ZodNumber>;
+    region_type: z.ZodOptional<z.ZodString>;
+    map_bounds: z.ZodOptional<z.ZodObject<{
+        west: z.ZodNumber;
+        east: z.ZodNumber;
+        south: z.ZodNumber;
+        north: z.ZodNumber;
+    }, z.core.$strip>>;
+    page: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    total: z.ZodNumber;
+    listings: z.ZodArray<z.ZodObject<{
+        zpid: z.ZodString;
+        address: z.ZodString;
+        street: z.ZodString;
+        city: z.ZodString;
+        state: z.ZodString;
+        zipcode: z.ZodString;
+        price: z.ZodString;
+        price_raw: z.ZodNumber;
+        beds: z.ZodNumber;
+        baths: z.ZodNumber;
+        sqft: z.ZodNumber;
+        status: z.ZodString;
+        status_text: z.ZodString;
+        home_type: z.ZodString;
+        days_on_zillow: z.ZodNumber;
+        zestimate: z.ZodNumber;
+        rent_zestimate: z.ZodNumber;
+        tax_assessed_value: z.ZodNumber;
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        image_url: z.ZodString;
+        detail_url: z.ZodString;
+        is_saved: z.ZodBoolean;
+        has_3d_model: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=search-open-houses.d.ts.map

package/dist/tools/search-open-houses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-open-houses.d.ts","sourceRoot":"","sources":["../../src/tools/search-open-houses.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA4D3B,CAAC"}

package/dist/tools/search-open-houses.js

@@ -0,0 +1,59 @@
+import { defineTool, ToolError } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { search, REGION_TYPE_MAP } from '../zillow-api.js';
+import { listingSchema, mapListing } from './schemas.js';
+export const searchOpenHouses = defineTool({
+    name: 'search_open_houses',
+    displayName: 'Search Open Houses',
+    description: 'Search for properties with upcoming open houses in a given area. Requires either a region_id (from search_locations) or map_bounds.',
+    summary: 'Find properties with open houses',
+    icon: 'door-open',
+    group: 'Search',
+    input: z.object({
+        region_id: z
+            .number()
+            .int()
+            .optional()
+            .describe('Zillow region ID (from search_locations). Required if map_bounds is not provided.'),
+        region_type: z
+            .string()
+            .optional()
+            .describe('Region type: "city", "county", "zipcode", "neighborhood" (default "city")'),
+        map_bounds: z
+            .object({
+            west: z.number().describe('Western longitude'),
+            east: z.number().describe('Eastern longitude'),
+            south: z.number().describe('Southern latitude'),
+            north: z.number().describe('Northern latitude'),
+        })
+            .optional()
+            .describe('Map bounding box. Required if region_id is not provided.'),
+        page: z.number().int().min(1).optional().describe('Page number (default 1)'),
+    }),
+    output: z.object({
+        total: z.number().describe('Total listings with open houses'),
+        listings: z.array(listingSchema).describe('Properties with open houses'),
+    }),
+    handle: async (params) => {
+        if (!params.region_id && !params.map_bounds) {
+            throw ToolError.validation('Either region_id or map_bounds is required.');
+        }
+        const bounds = params.map_bounds ?? { west: -122.5, east: -122.3, south: 37.7, north: 37.8 };
+        const data = await search({
+            pagination: params.page && params.page > 1 ? { currentPage: params.page } : undefined,
+            mapBounds: bounds,
+            regionSelection: params.region_id
+                ? [{ regionId: params.region_id, regionType: REGION_TYPE_MAP[params.region_type ?? 'city'] ?? 6 }]
+                : undefined,
+            filterState: {
+                isOpenHousesOnly: { value: true },
+            },
+            isMapVisible: true,
+        }, { cat1: ['listResults', 'total'] });
+        return {
+            total: data.categoryTotals?.cat1?.totalResultCount ?? data.cat1?.searchResults?.listResults?.length ?? 0,
+            listings: (data.cat1?.searchResults?.listResults ?? []).map(mapListing),
+        };
+    },
+});
+//# sourceMappingURL=search-open-houses.js.map

package/dist/tools/search-open-houses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-open-houses.js","sourceRoot":"","sources":["../../src/tools/search-open-houses.ts"],"names":[],"mappings":"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"}

package/dist/tools/search-recently-sold.d.ts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+export declare const searchRecentlySold: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    region_id: z.ZodOptional<z.ZodNumber>;
+    region_type: z.ZodOptional<z.ZodString>;
+    map_bounds: z.ZodOptional<z.ZodObject<{
+        west: z.ZodNumber;
+        east: z.ZodNumber;
+        south: z.ZodNumber;
+        north: z.ZodNumber;
+    }, z.core.$strip>>;
+    min_price: z.ZodOptional<z.ZodNumber>;
+    max_price: z.ZodOptional<z.ZodNumber>;
+    min_beds: z.ZodOptional<z.ZodNumber>;
+    min_baths: z.ZodOptional<z.ZodNumber>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        globalrelevanceex: "globalrelevanceex";
+        days: "days";
+        pricea: "pricea";
+        priced: "priced";
+        size: "size";
+    }>>;
+    page: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    total: z.ZodNumber;
+    listings: z.ZodArray<z.ZodObject<{
+        zpid: z.ZodString;
+        address: z.ZodString;
+        street: z.ZodString;
+        city: z.ZodString;
+        state: z.ZodString;
+        zipcode: z.ZodString;
+        price: z.ZodString;
+        price_raw: z.ZodNumber;
+        beds: z.ZodNumber;
+        baths: z.ZodNumber;
+        sqft: z.ZodNumber;
+        status: z.ZodString;
+        status_text: z.ZodString;
+        home_type: z.ZodString;
+        days_on_zillow: z.ZodNumber;
+        zestimate: z.ZodNumber;
+        rent_zestimate: z.ZodNumber;
+        tax_assessed_value: z.ZodNumber;
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        image_url: z.ZodString;
+        detail_url: z.ZodString;
+        is_saved: z.ZodBoolean;
+        has_3d_model: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=search-recently-sold.d.ts.map

package/dist/tools/search-recently-sold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-recently-sold.d.ts","sourceRoot":"","sources":["../../src/tools/search-recently-sold.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmF7B,CAAC"}

package/dist/tools/search-recently-sold.js

@@ -0,0 +1,82 @@
+import { defineTool, ToolError } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { search, REGION_TYPE_MAP } from '../zillow-api.js';
+import { listingSchema, mapListing } from './schemas.js';
+export const searchRecentlySold = defineTool({
+    name: 'search_recently_sold',
+    displayName: 'Search Recently Sold',
+    description: 'Search for recently sold properties on Zillow. Useful for market research and comp analysis. Requires either a region_id (from search_locations) or map_bounds. Returns sale prices, dates, and property details.',
+    summary: 'Search recently sold properties',
+    icon: 'badge-check',
+    group: 'Search',
+    input: z.object({
+        region_id: z
+            .number()
+            .int()
+            .optional()
+            .describe('Zillow region ID (from search_locations). Required if map_bounds is not provided.'),
+        region_type: z
+            .string()
+            .optional()
+            .describe('Region type: "city", "county", "zipcode", "neighborhood" (default "city")'),
+        map_bounds: z
+            .object({
+            west: z.number().describe('Western longitude'),
+            east: z.number().describe('Eastern longitude'),
+            south: z.number().describe('Southern latitude'),
+            north: z.number().describe('Northern latitude'),
+        })
+            .optional()
+            .describe('Map bounding box. Required if region_id is not provided.'),
+        min_price: z.number().optional().describe('Minimum sale price in dollars'),
+        max_price: z.number().optional().describe('Maximum sale price in dollars'),
+        min_beds: z.number().int().optional().describe('Minimum bedrooms'),
+        min_baths: z.number().int().optional().describe('Minimum bathrooms'),
+        sort: z
+            .enum(['globalrelevanceex', 'days', 'pricea', 'priced', 'size'])
+            .optional()
+            .describe('Sort order (default "globalrelevanceex"). "days"=Most recent, "pricea"=Price low-high, "priced"=Price high-low'),
+        page: z.number().int().min(1).optional().describe('Page number (default 1)'),
+    }),
+    output: z.object({
+        total: z.number().describe('Total number of recently sold properties'),
+        listings: z.array(listingSchema).describe('Recently sold listings'),
+    }),
+    handle: async (params) => {
+        if (!params.region_id && !params.map_bounds) {
+            throw ToolError.validation('Either region_id or map_bounds is required.');
+        }
+        const filterState = {
+            isRecentlySold: { value: true },
+            isForSaleByAgent: { value: false },
+            isForSaleByOwner: { value: false },
+            isNewConstruction: { value: false },
+            isComingSoon: { value: false },
+            isAuction: { value: false },
+            isForSaleForeclosure: { value: false },
+        };
+        if (params.sort)
+            filterState.sortSelection = { value: params.sort };
+        if (params.min_price || params.max_price)
+            filterState.price = { min: params.min_price, max: params.max_price };
+        if (params.min_beds)
+            filterState.beds = { min: params.min_beds };
+        if (params.min_baths)
+            filterState.baths = { min: params.min_baths };
+        const bounds = params.map_bounds ?? { west: -122.5, east: -122.3, south: 37.7, north: 37.8 };
+        const data = await search({
+            pagination: params.page && params.page > 1 ? { currentPage: params.page } : undefined,
+            mapBounds: bounds,
+            regionSelection: params.region_id
+                ? [{ regionId: params.region_id, regionType: REGION_TYPE_MAP[params.region_type ?? 'city'] ?? 6 }]
+                : undefined,
+            filterState,
+            isMapVisible: true,
+        }, { cat1: ['listResults', 'total'] });
+        return {
+            total: data.categoryTotals?.cat1?.totalResultCount ?? data.cat1?.searchResults?.listResults?.length ?? 0,
+            listings: (data.cat1?.searchResults?.listResults ?? []).map(mapListing),
+        };
+    },
+});
+//# sourceMappingURL=search-recently-sold.js.map

package/dist/tools/search-recently-sold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-recently-sold.js","sourceRoot":"","sources":["../../src/tools/search-recently-sold.ts"],"names":[],"mappings":"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"}