hotelzero 1.2.0 → 1.3.0

package/dist/browser.d.ts

@@ -22,6 +22,8 @@ export interface HotelSearchParams {
     rooms: number;
     currency?: string;
     sortBy?: "popularity" | "price_lowest" | "price_highest" | "rating" | "distance";
+    limit?: number;
+    offset?: number;
 }
 export interface HotelFilters {
     minRating?: number;

package/dist/browser.js

@@ -251,7 +251,7 @@ export class HotelBrowser {
         }
     }
     buildBookingUrl(params, filters) {
-        const { destination, checkIn, checkOut, guests, rooms, currency, sortBy } = params;
+        const { destination, checkIn, checkOut, guests, rooms, currency, sortBy, offset } = params;
         const url = new URL("https://www.booking.com/searchresults.html");
         url.searchParams.set("ss", destination);
         url.searchParams.set("checkin", checkIn);
@@ -259,6 +259,10 @@ export class HotelBrowser {
         url.searchParams.set("group_adults", guests.toString());
         url.searchParams.set("no_rooms", rooms.toString());
         url.searchParams.set("selected_currency", currency || "USD");
+        // Pagination offset
+        if (offset && offset > 0) {
+            url.searchParams.set("offset", offset.toString());
+        }
         // Sort order
         if (sortBy) {
             const sortMap = {
@@ -576,10 +580,15 @@ export class HotelBrowser {
             await this.checkForNoResults();
             // Close any popups/modals
             await this.dismissPopups();
-            // Scroll to load more results
-            await this.scrollToLoadMore();
+            // Scroll to load more results (pass limit to control how many to load)
+            const targetResults = params.limit || 25;
+            await this.scrollToLoadMore(targetResults);
             // Extract detailed hotel info
-            const hotels = await this.extractHotelDetails();
+            let hotels = await this.extractHotelDetails();
+            // Apply limit to cap results
+            if (params.limit && params.limit > 0) {
+                hotels = hotels.slice(0, params.limit);
+            }
             // Apply client-side filtering and scoring if we have preferences
             if (filters) {
                 return this.scoreAndFilterHotels(hotels, filters);
@@ -613,15 +622,31 @@ export class HotelBrowser {
             }
         }
     }
-    async scrollToLoadMore() {
+    async scrollToLoadMore(targetResults = 25) {
         if (!this.page)
             return;
-        // Scroll down a few times to load more results
-        for (let i = 0; i < 3; i++) {
+        // Calculate how many scroll iterations needed
+        // Each scroll typically loads ~15-25 more results
+        // We start with ~25, so to get to targetResults we need (targetResults - 25) / 20 more scrolls
+        const scrollsNeeded = Math.max(1, Math.ceil((targetResults - 25) / 20));
+        const maxScrolls = Math.min(scrollsNeeded, 5); // Cap at 5 scrolls to avoid excessive loading
+        // Scroll down to load more results
+        for (let i = 0; i < maxScrolls; i++) {
             await this.page.evaluate(() => {
                 window.scrollBy(0, window.innerHeight);
             });
             await this.page.waitForTimeout(1000);
+            // Check if "Load more" button exists and click it
+            try {
+                const loadMoreBtn = await this.page.$('button[data-testid="load-more-results"]');
+                if (loadMoreBtn) {
+                    await loadMoreBtn.click();
+                    await this.page.waitForTimeout(1500);
+                }
+            }
+            catch {
+                // Ignore if button not found
+            }
         }
         // Scroll back to top
         await this.page.evaluate(() => {

package/dist/index.js

@@ -40,6 +40,9 @@ const FindHotelsSchema = z.object({
     // Currency & Sorting
     currency: z.string().optional().describe("Currency code (USD, EUR, GBP, JPY, etc.)"),
     sortBy: z.enum(["popularity", "price_lowest", "price_highest", "rating", "distance"]).optional().describe("Sort results by"),
+    // Pagination
+    limit: z.number().min(1).max(100).optional().describe("Maximum number of results to return (default: 25, max: 100)"),
+    offset: z.number().min(0).optional().describe("Number of results to skip for pagination (default: 0)"),
     // Rating & Price
     minRating: z.number().optional().describe("Minimum rating (6=Pleasant, 7=Good, 8=Very Good, 9=Wonderful)"),
     minPrice: z.number().optional().describe("Minimum price per night"),
@@ -165,7 +168,7 @@ function formatHotelResult(hotel, index) {
 // Create MCP server
 const server = new Server({
     name: "hotelzero",
-    version: "1.2.0",
+    version: "1.3.0",
 }, {
     capabilities: {
         tools: {},
@@ -192,6 +195,9 @@ const findHotelsInputSchema = {
             description: "Sort results by",
             enum: ["popularity", "price_lowest", "price_highest", "rating", "distance"]
         },
+        // Pagination
+        limit: { type: "number", description: "Maximum results to return (default: 25, max: 100)", default: 25 },
+        offset: { type: "number", description: "Number of results to skip for pagination", default: 0 },
         // Property Type
         propertyType: {
             type: "string",
@@ -353,11 +359,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     rooms: parsed.rooms,
                     currency: parsed.currency,
                     sortBy: parsed.sortBy,
+                    limit: parsed.limit,
+                    offset: parsed.offset,
                 };
                 // Build filters object from all parsed parameters
                 const filters = {};
-                // Copy all filter properties
-                const filterKeys = Object.keys(parsed).filter(k => !['destination', 'checkIn', 'checkOut', 'guests', 'rooms', 'currency', 'sortBy'].includes(k));
+                // Copy all filter properties (exclude search params)
+                const filterKeys = Object.keys(parsed).filter(k => !['destination', 'checkIn', 'checkOut', 'guests', 'rooms', 'currency', 'sortBy', 'limit', 'offset'].includes(k));
                 for (const key of filterKeys) {
                     const value = parsed[key];
                     if (value !== undefined && value !== null) {
@@ -428,15 +436,20 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const filtersLine = activeFilters.length > 0
                     ? `Filters: ${activeFilters.join(", ")}\n\n`
                     : "\n";
+                // Pagination info
+                const offset = parsed.offset || 0;
+                const displayLimit = parsed.limit || 25;
+                const paginationLine = offset > 0
+                    ? `Showing results ${offset + 1}-${offset + results.length} of available hotels\n\n`
+                    : "";
                 const hotelList = results
-                    .slice(0, 15) // Top 15 results
-                    .map((h, i) => formatHotelResult(h, i))
+                    .map((h, i) => formatHotelResult(h, i + offset))
                     .join("\n\n");
                 return {
                     content: [
                         {
                             type: "text",
-                            text: header + filtersLine + hotelList,
+                            text: header + filtersLine + paginationLine + hotelList,
                         },
                     ],
                 };
@@ -544,7 +557,7 @@ process.on("SIGTERM", async () => {
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("HotelZero v1.2.0 running on stdio");
+    console.error("HotelZero v1.3.0 running on stdio");
 }
 main().catch((error) => {
     console.error("Fatal error:", error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hotelzero",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "MCP server for searching hotels on Booking.com with 80+ filters",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",