hotelzero 1.3.1 → 1.5.0

package/dist/browser.d.ts

@@ -124,6 +124,52 @@ export interface HotelResult {
     matchScore?: number;
     matchReasons?: string[];
 }
+export interface HotelDetails {
+    name: string;
+    url: string;
+    rating: number | null;
+    ratingText: string;
+    reviewCount: number | null;
+    starRating: number | null;
+    address: string;
+    description: string;
+    highlights: string;
+    pricePerNight: number | null;
+    priceDisplay: string;
+    totalPrice: string;
+    checkInTime: string;
+    checkOutTime: string;
+    popularFacilities: string[];
+    allFacilities: string[];
+    roomTypes: string[];
+    photos: string[];
+    nearbyAttractions: string[];
+    guestReviewHighlights: string[];
+    locationInfo: string;
+}
+export interface RoomOption {
+    name: string;
+    price: number | null;
+    priceDisplay: string;
+    sleeps: number | null;
+    features: string[];
+    bedType: string;
+    cancellation: string;
+    breakfast: string;
+}
+export interface AvailabilityResult {
+    available: boolean;
+    hotelName: string;
+    checkIn: string;
+    checkOut: string;
+    guests: number;
+    rooms: number;
+    roomOptions: RoomOption[];
+    lowestPrice: number | null;
+    lowestPriceDisplay: string;
+    message: string;
+    url: string;
+}
 export declare class HotelBrowser {
     private browser;
     private page;
@@ -143,4 +189,22 @@ export declare class HotelBrowser {
     getHotelDetails(hotelUrl: string): Promise<Record<string, unknown>>;
     takeScreenshot(path: string): Promise<void>;
     getPageContent(): Promise<string>;
+    /**
+     * Get detailed hotel information for comparison
+     */
+    getHotelDetailsForComparison(hotelUrl: string): Promise<HotelDetails>;
+    /**
+     * Compare multiple hotels side-by-side
+     */
+    compareHotels(hotelUrls: string[]): Promise<HotelDetails[]>;
+    /**
+     * Check availability for a specific hotel on given dates
+     */
+    checkAvailability(params: {
+        hotelUrl: string;
+        checkIn: string;
+        checkOut: string;
+        guests?: number;
+        rooms?: number;
+    }): Promise<AvailabilityResult>;
 }

package/dist/browser.js

@@ -974,4 +974,513 @@ export class HotelBrowser {
             throw new Error("Browser not initialized");
         return await this.page.content();
     }
+    /**
+     * Get detailed hotel information for comparison
+     */
+    async getHotelDetailsForComparison(hotelUrl) {
+        if (!this.page) {
+            throw new HotelSearchError("Browser not initialized. Call init() first.", ErrorCodes.BROWSER_NOT_INITIALIZED, false);
+        }
+        return await retryWithBackoff(async () => {
+            await this.enforceRateLimit();
+            try {
+                await this.page.goto(hotelUrl, {
+                    waitUntil: "networkidle",
+                    timeout: 30000
+                });
+            }
+            catch (error) {
+                const err = error;
+                if (err.message.includes("timeout") || err.message.includes("Timeout")) {
+                    throw new HotelSearchError("Page load timed out.", ErrorCodes.TIMEOUT, true);
+                }
+                throw new HotelSearchError(`Navigation failed: ${err.message}`, ErrorCodes.NAVIGATION_FAILED, true);
+            }
+            await this.page.waitForTimeout(2000);
+            await this.checkForBlocking();
+            await this.dismissPopups();
+            // Extract comprehensive hotel details using evaluate with string to avoid __name compilation issues
+            const details = await this.page.evaluate(`
+          (function() {
+            function getText(selector) {
+              var el = document.querySelector(selector);
+              return el && el.textContent ? el.textContent.trim() : "";
+            }
+            
+            function getTexts(selector) {
+              var elements = document.querySelectorAll(selector);
+              var result = [];
+              for (var i = 0; i < elements.length; i++) {
+                var text = elements[i].textContent;
+                if (text) {
+                  text = text.trim();
+                  if (text.length > 0) result.push(text);
+                }
+              }
+              return result;
+            }
+            
+            function getUniqueTexts(selector) {
+              var texts = getTexts(selector);
+              var seen = {};
+              var result = [];
+              for (var i = 0; i < texts.length; i++) {
+                if (!seen[texts[i]]) {
+                  seen[texts[i]] = true;
+                  result.push(texts[i]);
+                }
+              }
+              return result;
+            }
+
+            // Name - h2 is cleaner than h1 on Booking.com property pages
+            var name = getText('h2');
+            if (!name) name = getText('h1').split('(')[0].trim(); // fallback, strip suffix
+
+            // Rating - parse from review-score-component which contains "Scored 7.4 7.4Rated good Good · 11 reviews"
+            var ratingEl = document.querySelector('[data-testid="review-score-component"]');
+            var ratingFullText = ratingEl ? ratingEl.textContent || "" : "";
+            
+            // Extract numeric rating (first number after "Scored")
+            var ratingMatch = ratingFullText.match(/Scored\\s+([\\d.]+)/i);
+            var rating = ratingMatch ? parseFloat(ratingMatch[1]) : null;
+            
+            // Extract rating description (Good, Excellent, etc.)
+            var descMatch = ratingFullText.match(/Rated\\s*\\w+\\s*(\\w+)/i);
+            var ratingDesc = descMatch ? descMatch[1] : "";
+            if (!ratingDesc) {
+              // Try alternate pattern
+              var altMatch = ratingFullText.match(/(Exceptional|Superb|Excellent|Very Good|Good|Pleasant|Review score)/i);
+              ratingDesc = altMatch ? altMatch[1] : "";
+            }
+            
+            // Review count - look for number followed by "review"
+            var reviewMatch = ratingFullText.match(/([\\d,]+)\\s*reviews?/i);
+            var reviewCount = reviewMatch ? parseInt(reviewMatch[1].replace(/,/g, "")) : null;
+
+            // Star rating (for hotels)
+            var starEl = document.querySelector('[data-testid="rating-stars"]');
+            var starCount = starEl ? starEl.querySelectorAll('span[class*="star"], svg').length : null;
+            // Sometimes stars are indicated by aria-label
+            if (!starCount) {
+              var starLabel = document.querySelector('[aria-label*="star"]');
+              if (starLabel) {
+                var labelMatch = starLabel.getAttribute('aria-label').match(/(\\d+)/);
+                starCount = labelMatch ? parseInt(labelMatch[1]) : null;
+              }
+            }
+
+            // Address - from header address wrapper, clean up extra content
+            var address = "";
+            var addressWrapper = document.querySelector('[data-testid="PropertyHeaderAddressDesktop-wrapper"]');
+            if (addressWrapper) {
+              // Get all spans and find the one with the actual address
+              var spans = addressWrapper.querySelectorAll('span');
+              for (var i = 0; i < spans.length; i++) {
+                var text = spans[i].textContent ? spans[i].textContent.trim() : "";
+                // Address typically contains comma-separated parts ending with country
+                if (text.length > 10 && text.indexOf(",") > 0) {
+                  // Cut off at common suffixes that indicate end of address
+                  var cutoffs = ["Excellent location", "Great location", "Good location", "Very good location", "show map", "– rated", "After booking"];
+                  for (var j = 0; j < cutoffs.length; j++) {
+                    var idx = text.indexOf(cutoffs[j]);
+                    if (idx > 0) {
+                      text = text.substring(0, idx).trim();
+                      break;
+                    }
+                  }
+                  if (text.length > 10) {
+                    address = text;
+                    break;
+                  }
+                }
+              }
+            }
+            if (!address) address = getText('[data-testid="property-header-location"]');
+
+            // Description
+            var description = getText('[data-testid="property-description"]');
+
+            // Property highlights (size, bathroom, etc.)
+            var highlights = getText('[data-testid="property-highlights"]');
+
+            // Price - look in the reservation/booking section
+            var priceDisplay = "";
+            var pricePerNight = null;
+            
+            // Try multiple price selectors
+            var priceSelectors = [
+              '[data-testid="price-and-discounted-price"]',
+              '[class*="prco-valign-middle-helper"]',
+              '[class*="bui-price-display__value"]',
+              'span[class*="price"]'
+            ];
+            
+            for (var i = 0; i < priceSelectors.length; i++) {
+              var priceEl = document.querySelector(priceSelectors[i]);
+              if (priceEl && priceEl.textContent) {
+                var text = priceEl.textContent.trim();
+                // Look for currency symbol followed by number
+                var match = text.match(/[\\$€£¥]\\s*([\\d,]+)/);
+                if (match) {
+                  priceDisplay = text;
+                  pricePerNight = parseInt(match[1].replace(/,/g, ""));
+                  break;
+                }
+              }
+            }
+
+            // Check-in/out times - try multiple approaches
+            var checkInTime = getText('[data-testid="check-in-time"]');
+            var checkOutTime = getText('[data-testid="check-out-time"]');
+            
+            // If not found, look in policies section
+            if (!checkInTime) {
+              var policyText = getText('[data-testid="policy-summary"]') || "";
+              var checkInMatch = policyText.match(/check-in[:\\s]*(\\d{1,2}:\\d{2})/i);
+              checkInTime = checkInMatch ? checkInMatch[1] : "";
+            }
+            if (!checkOutTime) {
+              var policyText = getText('[data-testid="policy-summary"]') || "";
+              var checkOutMatch = policyText.match(/check-out[:\\s]*(\\d{1,2}:\\d{2})/i);
+              checkOutTime = checkOutMatch ? checkOutMatch[1] : "";
+            }
+
+            // Popular facilities - from the wrapper, get unique spans
+            var facilitiesWrapper = document.querySelector('[data-testid="property-most-popular-facilities-wrapper"]');
+            var popularFacilities = [];
+            if (facilitiesWrapper) {
+              var spans = facilitiesWrapper.querySelectorAll('span');
+              var seen = {};
+              for (var i = 0; i < spans.length; i++) {
+                var text = spans[i].textContent ? spans[i].textContent.trim() : "";
+                // Skip labels like "Most popular amenities" and short items
+                if (text && text.length > 2 && text.length < 50 && !seen[text] && 
+                    text.indexOf("Most popular") === -1 && text.indexOf("amenities") === -1) {
+                  seen[text] = true;
+                  popularFacilities.push(text);
+                }
+              }
+            }
+            
+            // If still empty, try property-highlights
+            if (popularFacilities.length === 0 && highlights) {
+              // Parse highlights like "Private bathroomFree WifiShower..."
+              var items = highlights.split(/(?=[A-Z][a-z])/);
+              for (var i = 0; i < items.length; i++) {
+                var item = items[i].trim();
+                if (item && item.length > 2) popularFacilities.push(item);
+              }
+            }
+
+            // All facilities from facilities section
+            var allFacilities = getUniqueTexts('[data-testid="property-section-facilities"] li');
+            if (allFacilities.length === 0) {
+              allFacilities = getUniqueTexts('[data-testid="Property-Facilities-Tab-Content"] li');
+            }
+
+            // Room types
+            var roomTypes = getUniqueTexts('[data-testid="room-name"]');
+
+            // Photos from gallery
+            var photoEls = document.querySelectorAll('[data-testid="GalleryUnifiedDesktop-wrapper"] img, [class*="gallery"] img');
+            var photos = [];
+            var seenPhotos = {};
+            for (var i = 0; i < photoEls.length && photos.length < 5; i++) {
+              var src = photoEls[i].src;
+              if (src && src.indexOf("data:") === -1 && !seenPhotos[src]) {
+                seenPhotos[src] = true;
+                photos.push(src);
+              }
+            }
+
+            // Location info from map
+            var locationInfo = getText('[data-testid="map-entry-point-desktop"]');
+
+            return {
+              name: name,
+              rating: rating,
+              ratingText: ratingDesc,
+              reviewCount: reviewCount,
+              starRating: starCount,
+              address: address,
+              description: description.slice(0, 500),
+              highlights: highlights,
+              pricePerNight: pricePerNight,
+              priceDisplay: priceDisplay,
+              totalPrice: "",
+              checkInTime: checkInTime,
+              checkOutTime: checkOutTime,
+              popularFacilities: popularFacilities.slice(0, 15),
+              allFacilities: allFacilities.slice(0, 30),
+              roomTypes: roomTypes.slice(0, 5),
+              photos: photos,
+              nearbyAttractions: [],
+              guestReviewHighlights: [],
+              locationInfo: locationInfo
+            };
+          })()
+        `);
+            return {
+                ...details,
+                url: hotelUrl,
+            };
+        }, DEFAULT_RETRY_CONFIG, (attempt, error, delayMs) => {
+            console.error(`Get hotel details attempt ${attempt} failed: ${error.message}. Retrying in ${Math.round(delayMs / 1000)}s...`);
+        });
+    }
+    /**
+     * Compare multiple hotels side-by-side
+     */
+    async compareHotels(hotelUrls) {
+        if (hotelUrls.length < 2 || hotelUrls.length > 3) {
+            throw new HotelSearchError("Please provide 2-3 hotel URLs to compare", "INVALID_INPUT", false);
+        }
+        const results = [];
+        for (const url of hotelUrls) {
+            const details = await this.getHotelDetailsForComparison(url);
+            results.push(details);
+        }
+        return results;
+    }
+    /**
+     * Check availability for a specific hotel on given dates
+     */
+    async checkAvailability(params) {
+        if (!this.page) {
+            throw new HotelSearchError("Browser not initialized. Call init() first.", ErrorCodes.BROWSER_NOT_INITIALIZED, false);
+        }
+        const { hotelUrl, checkIn, checkOut, guests = 2, rooms = 1 } = params;
+        // Validate dates
+        const checkInDate = new Date(checkIn);
+        const checkOutDate = new Date(checkOut);
+        if (isNaN(checkInDate.getTime()) || isNaN(checkOutDate.getTime())) {
+            throw new HotelSearchError("Invalid date format. Use YYYY-MM-DD.", "INVALID_INPUT", false);
+        }
+        if (checkOutDate <= checkInDate) {
+            throw new HotelSearchError("Check-out date must be after check-in date.", "INVALID_INPUT", false);
+        }
+        return await retryWithBackoff(async () => {
+            await this.enforceRateLimit();
+            // Build URL with date parameters
+            // Strip existing query params and add our own
+            const baseUrl = hotelUrl.split("?")[0];
+            const urlWithDates = `${baseUrl}?checkin=${checkIn}&checkout=${checkOut}&group_adults=${guests}&no_rooms=${rooms}&group_children=0`;
+            try {
+                await this.page.goto(urlWithDates, {
+                    waitUntil: "networkidle",
+                    timeout: 30000,
+                });
+            }
+            catch (error) {
+                const err = error;
+                if (err.message.includes("timeout") || err.message.includes("Timeout")) {
+                    throw new HotelSearchError("Page load timed out.", ErrorCodes.TIMEOUT, true);
+                }
+                throw new HotelSearchError(`Navigation failed: ${err.message}`, ErrorCodes.NAVIGATION_FAILED, true);
+            }
+            await this.page.waitForTimeout(2000);
+            await this.checkForBlocking();
+            await this.dismissPopups();
+            // Extract room availability using string-based evaluate
+            const result = await this.page.evaluate(`
+          (function() {
+            function getText(selector) {
+              var el = document.querySelector(selector);
+              return el && el.textContent ? el.textContent.trim() : "";
+            }
+
+            // Get hotel name
+            var hotelName = getText('h2') || getText('h1').split('(')[0].trim() || "Unknown Hotel";
+
+            var roomOptions = [];
+            var seenRooms = {};
+            
+            // Strategy 1: Look for room type links (most reliable on Booking.com)
+            var roomTypeLinks = document.querySelectorAll('.hprt-roomtype-link, a[class*="hprt-roomtype"]');
+            
+            for (var i = 0; i < roomTypeLinks.length && roomOptions.length < 10; i++) {
+              var roomLink = roomTypeLinks[i];
+              var name = roomLink.textContent.trim();
+              
+              if (!name || name.length < 3 || seenRooms[name]) continue;
+              seenRooms[name] = true;
+              
+              // Find the containing row to get price and details
+              var row = roomLink.closest('tr') || roomLink.closest('[data-block-id]') || roomLink.parentElement;
+              var rowText = row ? row.textContent || "" : "";
+              
+              // Try to find price in the same row or nearby
+              var price = null;
+              var priceDisplay = "";
+              
+              // Look for price cell in this row or next siblings
+              var priceCell = row ? row.querySelector('.hprt-table-cell-price, [class*="price-block"], [class*="bui-price"]') : null;
+              if (priceCell) {
+                priceDisplay = priceCell.textContent.trim();
+                var match = priceDisplay.match(/[\\$€£¥]\\s*([\\d,]+)/);
+                if (match) {
+                  price = parseInt(match[1].replace(/,/g, ""));
+                  // Clean up price display
+                  var perNightMatch = priceDisplay.match(/[\\$€£¥]\\s*[\\d,]+/);
+                  priceDisplay = perNightMatch ? perNightMatch[0] : priceDisplay.split('\\n')[0];
+                }
+              }
+              
+              // If no price found in row, search in sibling rows with same room type
+              if (!price) {
+                var allPriceCells = document.querySelectorAll('.hprt-table-cell-price');
+                for (var j = 0; j < allPriceCells.length && !price; j++) {
+                  var cellText = allPriceCells[j].textContent || "";
+                  var match = cellText.match(/[\\$€£¥]\\s*([\\d,]+)/);
+                  if (match) {
+                    price = parseInt(match[1].replace(/,/g, ""));
+                    priceDisplay = match[0];
+                    break;
+                  }
+                }
+              }
+              
+              // Bed type - clean up multiline text
+              var bedType = "";
+              var bedEl = row ? row.querySelector('.hprt-roomtype-bed, [class*="bed-type"]') : null;
+              if (bedEl) {
+                // Get first meaningful line
+                var bedText = bedEl.textContent || "";
+                var bedLines = bedText.split('\\n').map(function(l) { return l.trim(); }).filter(function(l) { return l.length > 0; });
+                // Find line with bed info
+                for (var k = 0; k < bedLines.length; k++) {
+                  if (bedLines[k].match(/(bed|queen|king|twin|double|single|sofa)/i)) {
+                    bedType = bedLines[k];
+                    break;
+                  }
+                }
+                if (!bedType && bedLines.length > 0) {
+                  bedType = bedLines[0];
+                }
+              }
+              
+              // Cancellation
+              var cancellation = "";
+              if (rowText.toLowerCase().indexOf("free cancellation") >= 0) {
+                cancellation = "Free cancellation";
+              } else if (rowText.toLowerCase().indexOf("non-refundable") >= 0) {
+                cancellation = "Non-refundable";
+              }
+              
+              // Breakfast
+              var breakfast = "";
+              if (rowText.toLowerCase().indexOf("breakfast included") >= 0) {
+                breakfast = "Breakfast included";
+              } else if (rowText.toLowerCase().indexOf("room only") >= 0) {
+                breakfast = "Room only";
+              }
+              
+              // Occupancy
+              var sleeps = null;
+              var occupancyEl = row ? row.querySelector('[class*="occupancy"], .hprt-occupancy-occupancy-info') : null;
+              if (occupancyEl) {
+                var occMatch = occupancyEl.textContent.match(/(\\d+)/);
+                sleeps = occMatch ? parseInt(occMatch[1]) : null;
+              }
+              
+              roomOptions.push({
+                name: name,
+                price: price,
+                priceDisplay: priceDisplay,
+                sleeps: sleeps,
+                features: [],
+                bedType: bedType,
+                cancellation: cancellation,
+                breakfast: breakfast
+              });
+            }
+            
+            // Strategy 2: If no rooms found, try data-block-id elements
+            if (roomOptions.length === 0) {
+              var blocks = document.querySelectorAll('[data-block-id]');
+              for (var i = 0; i < blocks.length && roomOptions.length < 10; i++) {
+                var block = blocks[i];
+                var blockText = block.textContent || "";
+                
+                // Look for any room name pattern
+                var nameEl = block.querySelector('a[class*="room"], span[class*="room-name"]');
+                var name = nameEl ? nameEl.textContent.trim() : "";
+                
+                if (!name) {
+                  // Try to extract from block text
+                  var lines = blockText.split('\\n').filter(function(l) { return l.trim().length > 0; });
+                  name = lines[0] ? lines[0].trim().slice(0, 50) : "";
+                }
+                
+                if (!name || name.length < 3 || seenRooms[name]) continue;
+                seenRooms[name] = true;
+                
+                var priceMatch = blockText.match(/[\\$€£¥]\\s*([\\d,]+)/);
+                var price = priceMatch ? parseInt(priceMatch[1].replace(/,/g, "")) : null;
+                
+                roomOptions.push({
+                  name: name,
+                  price: price,
+                  priceDisplay: priceMatch ? priceMatch[0] : "",
+                  sleeps: null,
+                  features: [],
+                  bedType: "",
+                  cancellation: "",
+                  breakfast: ""
+                });
+              }
+            }
+            
+            // Check for "no availability" message
+            var bodyText = document.body.textContent || "";
+            var noAvailability = 
+              bodyText.indexOf("no availability") >= 0 ||
+              bodyText.indexOf("sold out") >= 0 ||
+              bodyText.indexOf("no rooms available") >= 0 ||
+              bodyText.indexOf("fully booked") >= 0 ||
+              bodyText.indexOf("We have no availability") >= 0;
+            
+            return {
+              hotelName: hotelName,
+              roomOptions: roomOptions,
+              noAvailabilityDetected: noAvailability && roomOptions.length === 0
+            };
+          })()
+        `);
+            // Determine availability and lowest price
+            const available = result.roomOptions.length > 0 && !result.noAvailabilityDetected;
+            const prices = result.roomOptions
+                .map(r => r.price)
+                .filter((p) => p !== null);
+            const lowestPrice = prices.length > 0 ? Math.min(...prices) : null;
+            const lowestPriceRoom = result.roomOptions.find(r => r.price === lowestPrice);
+            // Build message
+            let message;
+            if (!available) {
+                message = "No rooms available for the selected dates.";
+            }
+            else if (result.roomOptions.length === 1) {
+                message = `1 room type available${lowestPrice ? ` from ${lowestPriceRoom?.priceDisplay || '$' + lowestPrice}` : ''}.`;
+            }
+            else {
+                message = `${result.roomOptions.length} room types available${lowestPrice ? ` from ${lowestPriceRoom?.priceDisplay || '$' + lowestPrice}` : ''}.`;
+            }
+            return {
+                available,
+                hotelName: result.hotelName,
+                checkIn,
+                checkOut,
+                guests,
+                rooms,
+                roomOptions: result.roomOptions,
+                lowestPrice,
+                lowestPriceDisplay: lowestPriceRoom?.priceDisplay || "",
+                message,
+                url: urlWithDates,
+            };
+        }, DEFAULT_RETRY_CONFIG, (attempt, error, delayMs) => {
+            console.error(`Check availability attempt ${attempt} failed: ${error.message}. Retrying in ${Math.round(delayMs / 1000)}s...`);
+        });
+    }
 }

package/dist/index.js

@@ -123,6 +123,16 @@ const FindHotelsSchema = z.object({
 const HotelDetailsSchema = z.object({
     url: z.string().describe("Booking.com URL for the hotel"),
 });
+const CompareHotelsSchema = z.object({
+    urls: z.array(z.string()).min(2).max(3).describe("Array of 2-3 Booking.com hotel URLs to compare"),
+});
+const CheckAvailabilitySchema = z.object({
+    hotelUrl: z.string().describe("Booking.com hotel URL to check availability for"),
+    checkIn: z.string().describe("Check-in date (YYYY-MM-DD)"),
+    checkOut: z.string().describe("Check-out date (YYYY-MM-DD)"),
+    guests: z.number().min(1).max(30).optional().describe("Number of guests (default: 2)"),
+    rooms: z.number().min(1).max(10).optional().describe("Number of rooms (default: 1)"),
+});
 // Global browser instance (reuse for efficiency)
 let browser = null;
 async function getBrowser() {
@@ -164,10 +174,197 @@ function formatHotelResult(hotel, index) {
     }
     return lines.join("\n");
 }
+function formatHotelComparison(hotels) {
+    const lines = [];
+    // Header
+    lines.push("=".repeat(60));
+    lines.push("HOTEL COMPARISON");
+    lines.push("=".repeat(60));
+    lines.push("");
+    // Create comparison sections
+    const sections = [
+        {
+            title: "OVERVIEW",
+            rows: [
+                { label: "Name", getValue: (h) => h.name || "Unknown" },
+                { label: "Rating", getValue: (h) => h.rating ? `${h.rating}/10 ${h.ratingText}` : "N/A" },
+                { label: "Reviews", getValue: (h) => h.reviewCount ? `${h.reviewCount.toLocaleString()} reviews` : "N/A" },
+                { label: "Stars", getValue: (h) => h.starRating ? "★".repeat(h.starRating) : "N/A" },
+                { label: "Location", getValue: (h) => h.address || h.locationInfo || "N/A" },
+            ],
+        },
+        {
+            title: "PRICING",
+            rows: [
+                { label: "Per Night", getValue: (h) => h.priceDisplay || "N/A" },
+                { label: "Total", getValue: (h) => h.totalPrice || "N/A" },
+            ],
+        },
+        {
+            title: "CHECK-IN/OUT",
+            rows: [
+                { label: "Check-in", getValue: (h) => h.checkInTime || "N/A" },
+                { label: "Check-out", getValue: (h) => h.checkOutTime || "N/A" },
+            ],
+        },
+        {
+            title: "PROPERTY HIGHLIGHTS",
+            rows: [
+                { label: "Highlights", getValue: (h) => h.highlights || "N/A" },
+            ],
+        },
+    ];
+    // Render each section
+    for (const section of sections) {
+        lines.push(`--- ${section.title} ---`);
+        lines.push("");
+        for (const row of section.rows) {
+            const values = hotels.map(h => row.getValue(h));
+            lines.push(`${row.label}:`);
+            values.forEach((v, i) => {
+                lines.push(`  ${i + 1}. ${v}`);
+            });
+            lines.push("");
+        }
+    }
+    // Facilities comparison
+    lines.push("--- TOP FACILITIES ---");
+    lines.push("");
+    hotels.forEach((h, i) => {
+        const facilities = h.popularFacilities.length > 0 ? h.popularFacilities : h.allFacilities;
+        lines.push(`${i + 1}. ${h.name}:`);
+        facilities.slice(0, 8).forEach(f => {
+            lines.push(`   • ${f}`);
+        });
+        lines.push("");
+    });
+    // Find common and unique facilities
+    if (hotels.length >= 2) {
+        const allFacilitySets = hotels.map(h => {
+            const facilities = [...h.popularFacilities, ...h.allFacilities];
+            return new Set(facilities.map(f => f.toLowerCase()));
+        });
+        // Find facilities in all hotels
+        const commonFacilities = [];
+        const firstHotelFacilities = [...hotels[0].popularFacilities, ...hotels[0].allFacilities];
+        for (const facility of firstHotelFacilities) {
+            const lowerFacility = facility.toLowerCase();
+            if (allFacilitySets.every(set => set.has(lowerFacility))) {
+                commonFacilities.push(facility);
+            }
+        }
+        if (commonFacilities.length > 0) {
+            lines.push("--- COMMON FACILITIES ---");
+            commonFacilities.slice(0, 10).forEach(f => {
+                lines.push(`• ${f}`);
+            });
+            lines.push("");
+        }
+    }
+    // Room types
+    const hasRoomTypes = hotels.some(h => h.roomTypes.length > 0);
+    if (hasRoomTypes) {
+        lines.push("--- ROOM TYPES ---");
+        lines.push("");
+        hotels.forEach((h, i) => {
+            lines.push(`${i + 1}. ${h.name}:`);
+            if (h.roomTypes.length > 0) {
+                h.roomTypes.slice(0, 3).forEach(r => {
+                    lines.push(`   • ${r}`);
+                });
+            }
+            else {
+                lines.push(`   (Room types not available)`);
+            }
+            lines.push("");
+        });
+    }
+    // Quick verdict based on data
+    lines.push("--- QUICK COMPARISON ---");
+    lines.push("");
+    // Best rating
+    const withRatings = hotels.filter(h => h.rating !== null);
+    if (withRatings.length > 0) {
+        const bestRated = withRatings.reduce((a, b) => (a.rating > b.rating ? a : b));
+        lines.push(`Highest Rated: ${bestRated.name} (${bestRated.rating}/10)`);
+    }
+    // Best price
+    const withPrices = hotels.filter(h => h.pricePerNight !== null);
+    if (withPrices.length > 0) {
+        const cheapest = withPrices.reduce((a, b) => (a.pricePerNight < b.pricePerNight ? a : b));
+        lines.push(`Lowest Price: ${cheapest.name} (${cheapest.priceDisplay})`);
+    }
+    // Most reviews
+    const withReviews = hotels.filter(h => h.reviewCount !== null);
+    if (withReviews.length > 0) {
+        const mostReviewed = withReviews.reduce((a, b) => (a.reviewCount > b.reviewCount ? a : b));
+        lines.push(`Most Reviews: ${mostReviewed.name} (${mostReviewed.reviewCount?.toLocaleString()})`);
+    }
+    lines.push("");
+    lines.push("=".repeat(60));
+    // Add URLs for reference
+    lines.push("BOOKING LINKS:");
+    hotels.forEach((h, i) => {
+        const shortUrl = h.url.split("?")[0];
+        lines.push(`${i + 1}. ${shortUrl}`);
+    });
+    return lines.join("\n");
+}
+function formatAvailabilityResult(result) {
+    const lines = [];
+    lines.push("=".repeat(60));
+    lines.push("AVAILABILITY CHECK");
+    lines.push("=".repeat(60));
+    lines.push("");
+    lines.push(`Hotel: ${result.hotelName}`);
+    lines.push(`Dates: ${result.checkIn} to ${result.checkOut}`);
+    lines.push(`Guests: ${result.guests} | Rooms: ${result.rooms}`);
+    lines.push("");
+    if (!result.available) {
+        lines.push("STATUS: NOT AVAILABLE");
+        lines.push(result.message);
+    }
+    else {
+        lines.push(`STATUS: AVAILABLE - ${result.message}`);
+        lines.push("");
+        lines.push("--- ROOM OPTIONS ---");
+        lines.push("");
+        result.roomOptions.forEach((room, i) => {
+            lines.push(`${i + 1}. ${room.name}`);
+            if (room.priceDisplay) {
+                lines.push(`   Price: ${room.priceDisplay}`);
+            }
+            if (room.sleeps) {
+                lines.push(`   Sleeps: ${room.sleeps}`);
+            }
+            if (room.bedType) {
+                lines.push(`   Bed: ${room.bedType}`);
+            }
+            if (room.cancellation) {
+                lines.push(`   Cancellation: ${room.cancellation}`);
+            }
+            if (room.breakfast) {
+                lines.push(`   Meals: ${room.breakfast}`);
+            }
+            if (room.features.length > 0) {
+                lines.push(`   Features: ${room.features.join(", ")}`);
+            }
+            lines.push("");
+        });
+        if (result.lowestPrice) {
+            lines.push("--- SUMMARY ---");
+            lines.push(`Lowest price: ${result.lowestPriceDisplay}`);
+        }
+    }
+    lines.push("");
+    lines.push("=".repeat(60));
+    lines.push(`Book at: ${result.url.split("?")[0]}`);
+    return lines.join("\n");
+}
 // Create MCP server
 const server = new Server({
     name: "hotelzero",
-    version: "1.3.1",
+    version: "1.5.0",
 }, {
     capabilities: {
         tools: {},
@@ -338,6 +535,38 @@ Results are scored and ranked by how well they match the criteria.`,
                     required: ["url"],
                 },
             },
+            {
+                name: "compare_hotels",
+                description: "Compare 2-3 hotels side-by-side. Provide Booking.com URLs from search results to see a detailed comparison of ratings, prices, amenities, and facilities.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        urls: {
+                            type: "array",
+                            items: { type: "string" },
+                            minItems: 2,
+                            maxItems: 3,
+                            description: "Array of 2-3 Booking.com hotel URLs to compare"
+                        },
+                    },
+                    required: ["urls"],
+                },
+            },
+            {
+                name: "check_availability",
+                description: "Check room availability and prices for a specific hotel on given dates. Returns available room types, prices, and booking details.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        hotelUrl: { type: "string", description: "Booking.com hotel URL to check" },
+                        checkIn: { type: "string", description: "Check-in date (YYYY-MM-DD)" },
+                        checkOut: { type: "string", description: "Check-out date (YYYY-MM-DD)" },
+                        guests: { type: "number", description: "Number of guests (default: 2)", minimum: 1, maximum: 30 },
+                        rooms: { type: "number", description: "Number of rooms (default: 1)", minimum: 1, maximum: 10 },
+                    },
+                    required: ["hotelUrl", "checkIn", "checkOut"],
+                },
+            },
         ],
     };
 });
@@ -480,6 +709,38 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            case "compare_hotels": {
+                const parsed = CompareHotelsSchema.parse(args);
+                const hotels = await b.compareHotels(parsed.urls);
+                const comparison = formatHotelComparison(hotels);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: comparison,
+                        },
+                    ],
+                };
+            }
+            case "check_availability": {
+                const parsed = CheckAvailabilitySchema.parse(args);
+                const result = await b.checkAvailability({
+                    hotelUrl: parsed.hotelUrl,
+                    checkIn: parsed.checkIn,
+                    checkOut: parsed.checkOut,
+                    guests: parsed.guests,
+                    rooms: parsed.rooms,
+                });
+                const formatted = formatAvailabilityResult(result);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: formatted,
+                        },
+                    ],
+                };
+            }
             default:
                 throw new Error(`Unknown tool: ${name}`);
         }
@@ -548,7 +809,7 @@ process.on("SIGTERM", async () => {
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("HotelZero v1.3.1 running on stdio");
+    console.error("HotelZero v1.5.0 running on stdio");
 }
 main().catch((error) => {
     console.error("Fatal error:", error);

package/package.json

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