google-flights-mcp-server 0.2.0 → 0.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "google-flights-mcp-server",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "MCP server for searching Google Flights — flight search, date grid pricing, and airport lookup",
   "main": "build/index.js",
   "type": "module",

package/shared/flights-client/flights-client.js

@@ -244,51 +244,87 @@ function parseFareBrand(raw) {
     }
 }
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
+function parseRawOffer(raw, currency) {
+    const details = raw[0];
+    const priceData = raw[1];
+    const rankData = raw[5]; // [is_best (1/0), ?, ?]
+    if (!details || !priceData)
+        return null;
+    // Parse segments
+    const segments = [];
+    const legs = details[2];
+    if (Array.isArray(legs)) {
+        for (const leg of legs) {
+            const segment = parseSegment(leg);
+            if (segment)
+                segments.push(segment);
+        }
+    }
+    const price = priceData[0]?.[1];
+    if (price === undefined || price === null)
+        return null;
+    return {
+        price,
+        currency,
+        airline: details[1]?.[0] || '',
+        airline_code: details[0] || '',
+        is_best: rankData?.[0] === 1,
+        fare_brand: parseFareBrand(raw),
+        departure: formatTime(details[5]),
+        arrival: formatTime(details[8]),
+        departure_date: formatDate(details[4]),
+        arrival_date: formatDate(details[7]),
+        duration_minutes: details[9] || 0,
+        stops: segments.length > 0 ? segments.length - 1 : 0,
+        segments,
+        extensions: parseExtensions(raw),
+        booking_token: priceData[1] || '',
+    };
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 function parseFlightOffers(ds1, currency) {
     const offers = [];
-    if (!ds1?.[3]?.[0] || !Array.isArray(ds1[3][0]))
-        return offers;
-    const rawOffers = ds1[3][0];
-    for (const raw of rawOffers) {
-        try {
-            const details = raw[0];
-            const priceData = raw[1];
-            const rankData = raw[5]; // [is_best (1/0), ?, ?]
-            if (!details || !priceData)
-                continue;
-            // Parse segments
-            const segments = [];
-            const legs = details[2];
-            if (Array.isArray(legs)) {
-                for (const leg of legs) {
-                    const segment = parseSegment(leg);
-                    if (segment)
-                        segments.push(segment);
+    const seenTokens = new Set();
+    // Google Flights returns results in two sections:
+    // - ds1[2][0]: "Best flights" (featured/highlighted flights, typically 3)
+    // - ds1[3][0]: "Other flights" (the main results list)
+    // Both sections use the same offer structure. In practice flights are not
+    // duplicated between them, but we deduplicate by booking_token defensively
+    // since this is an undocumented scraped API that could change.
+    //
+    // The is_best flag comes from raw[5][0] (per-offer rankData), not from which
+    // section the offer appears in. Google sets this flag on all ds1[2][0] offers
+    // and sometimes on ds1[3][0] offers too.
+    // Parse "best flights" from ds1[2][0]
+    const bestFlights = ds1?.[2]?.[0];
+    if (Array.isArray(bestFlights)) {
+        for (const raw of bestFlights) {
+            try {
+                const offer = parseRawOffer(raw, currency);
+                if (offer && !seenTokens.has(offer.booking_token)) {
+                    seenTokens.add(offer.booking_token);
+                    offers.push(offer);
                 }
             }
-            const price = priceData[0]?.[1];
-            if (price === undefined || price === null)
-                continue;
-            offers.push({
-                price,
-                currency,
-                airline: details[1]?.[0] || '',
-                airline_code: details[0] || '',
-                is_best: rankData?.[0] === 1,
-                fare_brand: parseFareBrand(raw),
-                departure: formatTime(details[5]),
-                arrival: formatTime(details[8]),
-                departure_date: formatDate(details[4]),
-                arrival_date: formatDate(details[7]),
-                duration_minutes: details[9] || 0,
-                stops: segments.length > 0 ? segments.length - 1 : 0,
-                segments,
-                extensions: parseExtensions(raw),
-                booking_token: priceData[1] || '',
-            });
+            catch (e) {
+                logDebug('parseFlightOffers', `Skipping malformed best offer: ${e.message}`);
+            }
         }
-        catch (e) {
-            logDebug('parseFlightOffers', `Skipping malformed offer: ${e.message}`);
+    }
+    // Parse "other flights" from ds1[3][0]
+    const otherFlights = ds1?.[3]?.[0];
+    if (Array.isArray(otherFlights)) {
+        for (const raw of otherFlights) {
+            try {
+                const offer = parseRawOffer(raw, currency);
+                if (offer && !seenTokens.has(offer.booking_token)) {
+                    seenTokens.add(offer.booking_token);
+                    offers.push(offer);
+                }
+            }
+            catch (e) {
+                logDebug('parseFlightOffers', `Skipping malformed offer: ${e.message}`);
+            }
         }
     }
     return offers;

package/shared/tools/search-flights.d.ts

@@ -19,9 +19,9 @@ export declare const SearchFlightsSchema: z.ZodObject<{
     currency: z.ZodDefault<z.ZodString>;
     exclude_basic_economy: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
+    currency: string;
     sort_by: "best" | "price" | "duration" | "departure" | "arrival";
     max_stops: "any" | "nonstop" | "1" | "2";
-    currency: string;
     origin: string;
     destination: string;
     departure_date: string;
@@ -39,9 +39,9 @@ export declare const SearchFlightsSchema: z.ZodObject<{
     origin: string;
     destination: string;
     departure_date: string;
+    currency?: string | undefined;
     sort_by?: "best" | "price" | "duration" | "departure" | "arrival" | undefined;
     max_stops?: "any" | "nonstop" | "1" | "2" | undefined;
-    currency?: string | undefined;
     return_date?: string | undefined;
     trip_type?: "one_way" | "round_trip" | undefined;
     seat_class?: "economy" | "premium_economy" | "business" | "first" | undefined;