hotelzero 1.7.0 → 1.9.0

package/README.md

@@ -25,6 +25,30 @@ Or run directly with npx:
 npx hotelzero
 ```
 
+## Proxy Support
+
+For heavy usage or to avoid IP blocks, you can configure a proxy server via the `HOTELZERO_PROXY` environment variable:
+
+```bash
+# HTTP proxy
+HOTELZERO_PROXY=http://proxy.example.com:8080 npx hotelzero
+
+# HTTP proxy with authentication
+HOTELZERO_PROXY=http://user:pass@proxy.example.com:8080 npx hotelzero
+
+# SOCKS5 proxy
+HOTELZERO_PROXY=socks5://proxy.example.com:1080 npx hotelzero
+
+# SOCKS5 proxy with authentication
+HOTELZERO_PROXY=socks5://user:pass@proxy.example.com:1080 npx hotelzero
+```
+
+When a proxy is configured, you'll see confirmation in the startup logs:
+```
+Proxy enabled: http://proxy.example.com:8080
+HotelZero v1.8.0 running on stdio
+```
+
 ## Quick Start
 
 ### Run as MCP Server
@@ -516,6 +540,14 @@ Run `npx playwright install chromium` to install the browser.
 
 - Wait a few minutes before retrying
 - The server uses anti-detection measures, but excessive requests may trigger blocks
+- Consider using a proxy server (see [Proxy Support](#proxy-support))
+
+### Proxy not working
+
+- Verify the proxy server is running and accessible
+- Check credentials if using authentication
+- Ensure the proxy supports HTTPS connections
+- Try a different proxy or test without proxy first
 
 ---
 

package/dist/browser.d.ts

@@ -1,3 +1,8 @@
+export interface ProxyConfig {
+    server: string;
+    username?: string;
+    password?: string;
+}
 export declare class HotelSearchError extends Error {
     code: string;
     retryable: boolean;
@@ -225,7 +230,16 @@ export declare class HotelBrowser {
     private page;
     private lastRequestTime;
     private minRequestIntervalMs;
-    init(headless?: boolean): Promise<void>;
+    private proxyConfig;
+    init(headless?: boolean, proxy?: ProxyConfig): Promise<void>;
+    /**
+     * Check if a proxy is configured
+     */
+    hasProxy(): boolean;
+    /**
+     * Get the current proxy server (without credentials)
+     */
+    getProxyServer(): string | null;
     close(): Promise<void>;
     private buildBookingUrl;
     private enforceRateLimit;

package/dist/browser.js

@@ -232,17 +232,42 @@ export class HotelBrowser {
     page = null;
     lastRequestTime = 0;
     minRequestIntervalMs = 2000; // Minimum 2 seconds between requests
-    async init(headless = true) {
-        this.browser = await chromium.launch({
+    proxyConfig = null;
+    async init(headless = true, proxy) {
+        // Store proxy config for reference
+        this.proxyConfig = proxy || null;
+        // Build launch options
+        const launchOptions = {
             headless,
             args: ["--disable-blink-features=AutomationControlled"],
-        });
+        };
+        // Add proxy to launch options if provided
+        if (proxy) {
+            launchOptions.proxy = {
+                server: proxy.server,
+                username: proxy.username,
+                password: proxy.password,
+            };
+        }
+        this.browser = await chromium.launch(launchOptions);
         const context = await this.browser.newContext({
             userAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
             viewport: { width: 1280, height: 900 },
         });
         this.page = await context.newPage();
     }
+    /**
+     * Check if a proxy is configured
+     */
+    hasProxy() {
+        return this.proxyConfig !== null;
+    }
+    /**
+     * Get the current proxy server (without credentials)
+     */
+    getProxyServer() {
+        return this.proxyConfig?.server || null;
+    }
     async close() {
         if (this.browser) {
             await this.browser.close();

package/dist/index.js

@@ -149,10 +149,45 @@ const GetPriceCalendarSchema = z.object({
 });
 // Global browser instance (reuse for efficiency)
 let browser = null;
+/**
+ * Parse proxy configuration from environment variable
+ * Supports formats:
+ *   - http://proxy.example.com:8080
+ *   - http://user:pass@proxy.example.com:8080
+ *   - socks5://proxy.example.com:1080
+ *   - socks5://user:pass@proxy.example.com:1080
+ */
+function parseProxyFromEnv() {
+    const proxyUrl = process.env.HOTELZERO_PROXY;
+    if (!proxyUrl)
+        return undefined;
+    try {
+        const url = new URL(proxyUrl);
+        const config = {
+            server: `${url.protocol}//${url.host}`,
+        };
+        if (url.username) {
+            config.username = decodeURIComponent(url.username);
+        }
+        if (url.password) {
+            config.password = decodeURIComponent(url.password);
+        }
+        return config;
+    }
+    catch (error) {
+        console.error(`Invalid HOTELZERO_PROXY format: ${proxyUrl}`);
+        return undefined;
+    }
+}
 async function getBrowser() {
     if (!browser) {
         browser = new HotelBrowser();
-        await browser.init(true);
+        const proxyConfig = parseProxyFromEnv();
+        await browser.init(true, proxyConfig);
+        // Log proxy status (without credentials)
+        if (browser.hasProxy()) {
+            console.error(`Proxy enabled: ${browser.getProxyServer()}`);
+        }
     }
     return browser;
 }
@@ -511,7 +546,7 @@ function formatPriceCalendarResult(result) {
 // Create MCP server
 const server = new Server({
     name: "hotelzero",
-    version: "1.7.0",
+    version: "1.8.0",
 }, {
     capabilities: {
         tools: {},
@@ -1012,7 +1047,7 @@ process.on("SIGTERM", async () => {
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("HotelZero v1.7.0 running on stdio");
+    console.error("HotelZero v1.8.0 running on stdio");
 }
 main().catch((error) => {
     console.error("Fatal error:", error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hotelzero",
-  "version": "1.7.0",
+  "version": "1.9.0",
   "description": "MCP server for searching hotels on Booking.com with 80+ filters",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -15,7 +15,14 @@
     "build": "tsc",
     "start": "node dist/index.js",
     "dev": "tsx src/index.ts",
-    "test": "tsx src/test.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "test:selectors": "vitest run tests/selectors.test.ts",
+    "test:search": "vitest run tests/search.test.ts",
+    "test:details": "vitest run tests/details.test.ts",
+    "test:reviews": "vitest run tests/reviews.test.ts",
+    "test:calendar": "vitest run tests/price-calendar.test.ts",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -48,7 +55,9 @@
   },
   "devDependencies": {
     "@types/node": "^25.2.3",
+    "@vitest/ui": "^4.0.18",
     "tsx": "^4.21.0",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
   }
 }