imprint-mcp 0.2.1 → 0.3.1

package/examples/google-hotels/search_hotels/parser.ts

@@ -0,0 +1,260 @@
+// Parser for google-hotels search_hotels (AtySUc batchexecute response).
+// Decodes the anti-XSSI envelope via the shared helper, then walks the inner
+// JSON collecting hotel entries (keyed "397419284"), the result-count/area row
+// (keyed "416343588"), and recursively extracting per-hotel fields whose exact
+// array positions drift between entries.
+import { parseBatchExecute } from '../_shared/batchexecute.ts';
+
+type Ctx = {
+  params?: Record<string, string | number | boolean>;
+  responses?: unknown[];
+};
+
+function isArr(v: unknown): v is unknown[] {
+  return Array.isArray(v);
+}
+
+// Depth-first: collect every object value stored under `key` anywhere in the tree.
+function collectByKey(node: unknown, key: string, out: unknown[]): void {
+  if (isArr(node)) {
+    for (const child of node) collectByKey(child, key, out);
+  } else if (node && typeof node === 'object') {
+    const obj = node as Record<string, unknown>;
+    for (const k of Object.keys(obj)) {
+      if (k === key) out.push(obj[k]);
+      collectByKey(obj[k], key, out);
+    }
+  }
+}
+
+// Recursively find the first node satisfying `pred`.
+function findFirst(node: unknown, pred: (n: unknown) => boolean): unknown {
+  if (pred(node)) return node;
+  if (isArr(node)) {
+    for (const child of node) {
+      const hit = findFirst(child, pred);
+      if (hit !== undefined) return hit;
+    }
+  }
+  return undefined;
+}
+
+function findHotelId(entry: unknown): string | null {
+  const hit = findFirst(
+    entry,
+    (n) => typeof n === 'string' && /^Ch[a-zA-Z]I[A-Za-z0-9_-]{8,}$/.test(n),
+  );
+  return typeof hit === 'string' ? hit : null;
+}
+
+function findLatLng(entry: unknown): { lat: number; lng: number } | null {
+  const hit = findFirst(
+    entry,
+    (n) =>
+      isArr(n) &&
+      n.length === 2 &&
+      typeof n[0] === 'number' &&
+      typeof n[1] === 'number' &&
+      Math.abs(n[0]) <= 90 &&
+      Math.abs(n[1]) <= 180 &&
+      // exclude small integer pairs like [12,18]; coords have decimals
+      (!Number.isInteger(n[0]) || !Number.isInteger(n[1])),
+  ) as number[] | undefined;
+  return hit ? { lat: hit[0]!, lng: hit[1]! } : null;
+}
+
+// Overall rating block looks like [[4,"4.6"],[1,"4.8"],...] (4 = overall).
+function findRating(entry: unknown): { overall: number | null; categories: Record<string, number> } {
+  const block = findFirst(entry, (n) => {
+    if (!isArr(n) || n.length === 0) return false;
+    return n.every(
+      (p) =>
+        isArr(p) &&
+        p.length === 2 &&
+        typeof p[0] === 'number' &&
+        typeof p[1] === 'string' &&
+        /^\d+(\.\d+)?$/.test(p[1]),
+    );
+  }) as Array<[number, string]> | undefined;
+  const categories: Record<string, number> = {};
+  let overall: number | null = null;
+  if (block) {
+    const labels: Record<number, string> = {
+      4: 'overall',
+      1: 'location',
+      5: 'rooms',
+      2: 'service',
+      3: 'value',
+    };
+    for (const [code, val] of block) {
+      const f = Number(val);
+      if (code === 4) overall = f;
+      categories[labels[code] ?? String(code)] = f;
+    }
+  }
+  return { overall, categories };
+}
+
+function findCheckInOut(entry: unknown): { checkIn: string | null; checkOut: string | null } {
+  const hit = findFirst(
+    entry,
+    (n) =>
+      isArr(n) &&
+      n.length === 2 &&
+      typeof n[0] === 'string' &&
+      typeof n[1] === 'string' &&
+      /\d{1,2}:\d{2}\s?(AM|PM)/i.test(n[0]) &&
+      /\d{1,2}:\d{2}\s?(AM|PM)/i.test(n[1]),
+  ) as string[] | undefined;
+  return hit ? { checkIn: hit[0]!, checkOut: hit[1]! } : { checkIn: null, checkOut: null };
+}
+
+// Price block: ["$98","$115",98,null,98] -> display + numeric.
+function findPrice(entry: unknown): { display: string | null; amount: number | null } {
+  const hit = findFirst(
+    entry,
+    (n) =>
+      isArr(n) &&
+      n.length >= 3 &&
+      typeof n[0] === 'string' &&
+      n[0].startsWith('$') &&
+      typeof n[2] === 'number',
+  ) as unknown[] | undefined;
+  return hit
+    ? { display: hit[0] as string, amount: hit[2] as number }
+    : { display: null, amount: null };
+}
+
+function findStarClass(entry: unknown): string | null {
+  const hit = findFirst(
+    entry,
+    (n) =>
+      isArr(n) &&
+      n.length === 2 &&
+      typeof n[0] === 'string' &&
+      /-star (hotel|property)|star hotel|hotel$/i.test(n[0]) &&
+      typeof n[1] === 'number',
+  ) as unknown[] | undefined;
+  return hit ? (hit[0] as string) : null;
+}
+
+function findAreaMid(entry: unknown): string | null {
+  const hit = findFirst(
+    entry,
+    (n) => typeof n === 'string' && /^\/m\/[a-z0-9_]+$/i.test(n),
+  );
+  return typeof hit === 'string' ? hit : null;
+}
+
+// Nearby POIs: [[1,[1,null,[["Grant Park",null,[[2,"6 min"]]]]]],...]
+function findPois(entry: unknown): string[] {
+  const names: string[] = [];
+  function walk(n: unknown): void {
+    if (isArr(n)) {
+      // a POI tuple ["Name", null, [[code,"X min"]], ...]
+      if (
+        typeof n[0] === 'string' &&
+        n[0].length > 1 &&
+        isArr(n[2]) &&
+        n[2].some(
+          (d) => isArr(d) && typeof d[1] === 'string' && /\bmin\b|\bhr\b/.test(d[1]),
+        )
+      ) {
+        if (!names.includes(n[0])) names.push(n[0]);
+      }
+      for (const c of n) walk(c);
+    }
+  }
+  walk(entry);
+  return names.slice(0, 8);
+}
+
+function mapHotel(rawEntry: unknown, areaMid: string | null, areaName: string): Record<string, unknown> | null {
+  // The "397419284" value wraps the hotel entry: [ [null,"Name",[...]] ].
+  let entry: unknown = rawEntry;
+  if (
+    isArr(entry) &&
+    typeof entry[1] !== 'string' &&
+    isArr(entry[0]) &&
+    typeof (entry[0] as unknown[])[1] === 'string'
+  ) {
+    entry = entry[0];
+  }
+  const name = isArr(entry) && typeof entry[1] === 'string' ? entry[1] : null;
+  const hotelId = findHotelId(entry);
+  if (!name && !hotelId) return null; // content-less sentinel
+  const latlng = findLatLng(entry);
+  const rating = findRating(entry);
+  const times = findCheckInOut(entry);
+  const price = findPrice(entry);
+  const ownMid = findAreaMid(entry) ?? areaMid;
+  return {
+    name,
+    hotel_id: hotelId, // PRODUCER token (ChcI… ftid)
+    location_context: `${ownMid ?? ''}|${areaName}`, // PRODUCER token "<mid>|<displayName>"
+    latitude: latlng?.lat ?? null,
+    longitude: latlng?.lng ?? null,
+    rating: rating.overall,
+    rating_categories: rating.categories,
+    star_class: findStarClass(entry),
+    check_in_time: times.checkIn,
+    check_out_time: times.checkOut,
+    price: price.display,
+    price_amount: price.amount,
+    nearby: findPois(entry),
+  };
+}
+
+export function extract(rawResponse: unknown, context?: Ctx): unknown {
+  const raw =
+    typeof rawResponse === 'string' ? rawResponse : JSON.stringify(rawResponse);
+  let inner: unknown;
+  try {
+    inner = parseBatchExecute(raw, 'AtySUc');
+  } catch {
+    inner = null;
+  }
+  if (inner == null) {
+    return { area: null, result_count: 0, hotels: [] };
+  }
+
+  // result-count / area row: [922,false,"Chicago Loop",true,2]
+  const countRows: unknown[] = [];
+  collectByKey(inner, '416343588', countRows);
+  let resultCount = 0;
+  let areaName = '';
+  for (const row of countRows) {
+    if (isArr(row) && typeof row[0] === 'number') {
+      resultCount = row[0];
+      if (typeof row[2] === 'string') areaName = row[2];
+      break;
+    }
+  }
+  if (!areaName && context?.params?.location) {
+    areaName = String(context.params.location);
+  }
+
+  // area mid from anywhere in the tree
+  const areaMid = findAreaMid(inner);
+
+  // hotel entries
+  const hotelVals: unknown[] = [];
+  collectByKey(inner, '397419284', hotelVals);
+  const seen = new Set<string>();
+  const hotels: Record<string, unknown>[] = [];
+  for (const v of hotelVals) {
+    const mapped = mapHotel(v, areaMid, areaName);
+    if (!mapped) continue;
+    const dedup = `${mapped.name}|${mapped.hotel_id}`;
+    if (seen.has(dedup)) continue;
+    seen.add(dedup);
+    hotels.push(mapped);
+  }
+
+  return {
+    area: areaName || null,
+    area_mid: areaMid,
+    result_count: resultCount || hotels.length,
+    hotels,
+  };
+}

package/examples/google-hotels/search_hotels/playbook.yaml

@@ -0,0 +1,87 @@
+toolName: search_hotels
+summary: Search Google Hotels for a location over a check-in/check-out date range and return the hotel result list from the AtySUc search XHR.
+parameters:
+  - name: location
+    type: string
+    description: "Destination query typed into the hotel search box, e.g. 'chicago loop', 'tahoe city', 'denver downtown'."
+  - name: check_in_date
+    type: string
+    description: "Check-in day as it appears in the date-picker cell aria-label, e.g. 'Friday, July 3, 2026'."
+  - name: check_out_date
+    type: string
+    description: "Check-out day as it appears in the date-picker cell aria-label, e.g. 'Monday, July 6, 2026'."
+steps:
+  - action: navigate
+    url: https://www.google.com/travel/search
+    wait_for: networkidle
+  - action: click
+    locators:
+      - by: aria_label
+        value: Search for places, hotels and more
+      - by: css
+        value: input.II2One.j0Ppje
+    wait_for:
+      sleep_ms: 300
+  - action: type
+    locators:
+      - by: aria_label
+        value: Search for places, hotels and more
+      - by: css
+        value: input.II2One.j0Ppje
+    value: ${location}
+    wait_for:
+      sleep_ms: 600
+  - action: click
+    locators:
+      - by: text
+        value_pattern: ${location}
+      - by: css
+        value: ul.F3AVKd > li.Q1RWxd
+    wait_for:
+      xhr: rpcids=AtySUc
+  - action: click
+    locators:
+      - by: aria_label
+        value: Check-in
+      - by: css
+        value: input.TP4Lpb.eoY5cb
+    wait_for:
+      sleep_ms: 400
+  - action: click
+    locators:
+      - by: aria_label
+        value_pattern: ${check_in_date}
+    wait_for:
+      sleep_ms: 300
+  - action: click
+    locators:
+      - by: aria_label
+        value_pattern: ${check_out_date}
+    wait_for:
+      sleep_ms: 300
+  - action: click
+    locators:
+      - by: text
+        value: Done
+      - by: css
+        value: div.XfpsVe.J9fJmf button.VfPpkd-LgbsSe-OWXEXe-k8QpJ
+    wait_for:
+      xhr: rpcids=AtySUc
+result:
+  source: xhr
+  url_pattern: rpcids=AtySUc
+  extract: wrb.fr.AtySUc
+  return_as: hotels
+notes: >-
+  The AtySUc response is a batchexecute anti-XSSI envelope: strip the ")]}'" prefix and chunk-length
+  lines, then JSON.parse the inner escaped string inside [["wrb.fr","AtySUc","<inner-json>"]]. The inner
+  payload is positional nested arrays (no named keys), so the result-bearing hotel list and the
+  "$low/typical/high" price-index block must be walked by index after parsing — the same shared helper
+  used by the API workflow does this. Each typed location triggers an mejVKc autocomplete lookup plus an
+  AtySUc search; clicking the first suggestion that contains ${location} re-runs AtySUc with the resolved
+  Knowledge-Graph mid. Date cells are targeted by their full aria-label (e.g. "Friday, July 3, 2026"), so
+  check_in_date/check_out_date must be passed in that exact format; if the target month is not visible,
+  the picker may need next-month navigation first. Filter refinements seen in the recording (min_rating,
+  min_price/max_price, amenities, hotel_class, brands, sort_by, property_type) all re-issue the same
+  AtySUc endpoint with integer filter codes and are better applied via the API workflow than via static
+  DOM steps; this playbook covers the core location + date search that grounds every variation.

package/examples/google-hotels/search_hotels/request-transform.ts

@@ -0,0 +1,197 @@
+// Per-tool request transform for google-hotels search_hotels.
+// Builds the AtySUc batchexecute inner payload from the tool params, then wraps
+// it with the SHARED freq.ts helpers (buildFreqBody / buildBatchExecuteUrl).
+// The structure was reverse-engineered from recorded requests:
+//   seq 229  (location only)               -> proves a bare text query resolves
+//   seq 300  (location + dates)            -> [1][2] location/dates block
+//   seq 691  (4+ rating)                   -> [1][4][3]/[1][4][4]
+//   seq 745  (price max 338)               -> [1][4][3][1] = [min,max]
+//   seq 1098 (19 amenities + 4/5 star)     -> [1][4][0][0] amenities, [1][4][0][1] stars
+//   seq 1745 (brands)                      -> [1][4][0][7] brands
+//   seq 1842 (sort lowest price)           -> [1][4][0][4] sort code
+//   seq 2082 (property type / vacation)    -> [1][0] = 1 hotels / 2 vacation rentals
+import {
+  buildFreqBody,
+  buildBatchExecuteUrl,
+  encodeDate,
+} from '../_shared/freq.ts';
+
+type Params = Record<string, string | number | boolean | undefined>;
+
+function num(v: unknown, dflt = 0): number {
+  if (v === undefined || v === null || v === '') return dflt;
+  const n = typeof v === 'number' ? v : Number(v);
+  return Number.isFinite(n) ? n : dflt;
+}
+
+function str(v: unknown): string {
+  return v === undefined || v === null ? '' : String(v).trim();
+}
+
+// Amenity name aliases -> Google integer codes (best-effort; numeric codes pass
+// through unchanged). Codes observed in the recording's 19-amenity list.
+const AMENITY_ALIASES: Record<string, number> = {
+  'free breakfast': 4,
+  breakfast: 4,
+  'free wi-fi': 6,
+  'free wifi': 6,
+  wifi: 6,
+  'wi-fi': 6,
+  bar: 2,
+  pool: 9,
+  spa: 15,
+  'air conditioning': 8,
+  'pet-friendly': 12,
+  'pet friendly': 12,
+  'fitness center': 19,
+  gym: 19,
+  restaurant: 1,
+  'room service': 3,
+  'airport shuttle': 22,
+  'electric vehicle charging station': 61,
+  parking: 7,
+  'free parking': 10,
+  'hot tub': 40,
+  'accessible': 5,
+  'kid-friendly': 53,
+  'all-inclusive available': 11,
+  'beach access': 52,
+};
+
+function parseCodeList(raw: string, aliases?: Record<string, number>): number[] {
+  if (!raw) return [];
+  const out: number[] = [];
+  for (const part of raw.split(',')) {
+    const t = part.trim().toLowerCase();
+    if (!t) continue;
+    if (aliases && t in aliases) {
+      out.push(aliases[t]!);
+      continue;
+    }
+    const n = Number(t);
+    if (Number.isFinite(n)) out.push(n);
+  }
+  return out;
+}
+
+// Brand filter: each entry encodes as [parentCode,[childCode]]. Accept "parent:child"
+// or a bare numeric code (wrapped as [code,[code]]).
+function parseBrands(raw: string): Array<[number, number[]]> {
+  if (!raw) return [];
+  const out: Array<[number, number[]]> = [];
+  for (const part of raw.split(',')) {
+    const t = part.trim();
+    if (!t) continue;
+    if (t.includes(':')) {
+      const [a, b] = t.split(':');
+      const pa = Number(a);
+      const pb = Number(b);
+      if (Number.isFinite(pa) && Number.isFinite(pb)) out.push([pa, [pb]]);
+    } else {
+      const n = Number(t);
+      if (Number.isFinite(n)) out.push([n, [n]]);
+    }
+  }
+  return out;
+}
+
+const SORT_CODES: Record<string, number | null> = {
+  relevance: null,
+  lowest_price: 3,
+  highest_rating: 8,
+  most_reviewed: 13,
+};
+
+function nightsBetween(ci: string, co: string): number {
+  const a = Date.parse(ci + 'T00:00:00Z');
+  const b = Date.parse(co + 'T00:00:00Z');
+  if (!Number.isFinite(a) || !Number.isFinite(b) || b <= a) return 1;
+  return Math.round((b - a) / 86_400_000);
+}
+
+export function buildInnerPayload(params: Params): unknown {
+  const location = str(params.location);
+  const checkIn = str(params.check_in_date);
+  const checkOut = str(params.check_out_date);
+  const adults = Math.max(1, num(params.adults, 2));
+  const children = Math.max(0, num(params.children, 0));
+  const minRating = num(params.min_rating, 0);
+  const minPrice = num(params.min_price, 0);
+  const maxPrice = num(params.max_price, 0);
+  const amenities = parseCodeList(str(params.amenities), AMENITY_ALIASES);
+  const stars = parseCodeList(str(params.hotel_class));
+  const brands = parseBrands(str(params.brands));
+  const sortKey = str(params.sort_by).toLowerCase() || 'relevance';
+  const sortCode = sortKey in SORT_CODES ? SORT_CODES[sortKey] : null;
+  const propertyType =
+    str(params.property_type).toLowerCase() === 'vacation_rentals' ? 2 : 1;
+
+  // [1][1] occupancy: array of adults (each [3]) + children scalar
+  const occupancy: unknown = [Array.from({ length: adults }, () => [3]), children];
+
+  // [1][2] location/dates: empty mid block + dates block
+  let locDates: unknown;
+  if (checkIn && checkOut) {
+    locDates = [
+      [],
+      [
+        null,
+        [encodeDate(checkIn), encodeDate(checkOut), nightsBetween(checkIn, checkOut)],
+        null,
+        null,
+        null,
+        [1],
+      ],
+    ];
+  } else {
+    locDates = null;
+  }
+
+  // [1][4] filters
+  const filterObj: unknown[] = [
+    amenities.length ? amenities : null, // [0] amenities
+    stars.length ? stars : null, // [1] hotel class (stars)
+    null, // [2]
+    null, // [3]
+    sortCode ?? null, // [4] sort
+    null, // [5]
+    'USD', // [6] currency
+  ];
+  if (brands.length) filterObj[7] = brands; // [7] brands
+
+  const f14: unknown[] = [filterObj, null, []];
+
+  const ratingCode = minRating > 0 ? Math.round(minRating * 2) : 0;
+  const priceSet = minPrice > 0 || maxPrice > 0;
+  if (priceSet || ratingCode) {
+    const priceTuple = priceSet ? [minPrice > 0 ? minPrice : null, maxPrice > 0 ? maxPrice : null] : null;
+    f14[3] = [null, priceTuple, 1];
+    if (ratingCode) f14[4] = ratingCode;
+  }
+
+  const block1: unknown = [propertyType, occupancy, locDates, null, f14];
+
+  // [2] fresh-search block (matches seq 229 / a brand-new query)
+  const block2: unknown = [0, null, null, 0, 0, null, null, null, 0];
+
+  return [location, block1, block2];
+}
+
+export function transform(
+  method: string,
+  url: string,
+  responses: Record<string, any>,
+  params?: Params,
+): { url: string; body: string } {
+  void method;
+  void responses;
+  const u = new URL(url);
+  const rpcid = u.searchParams.get('rpcids') || 'AtySUc';
+  const fSid = u.searchParams.get('f.sid') ?? '';
+  const bl = u.searchParams.get('bl') ?? '';
+  const inner = buildInnerPayload(params ?? {});
+  return {
+    url: buildBatchExecuteUrl(rpcid, { f_sid: fSid, bl }),
+    body: buildFreqBody(rpcid, inner, '1'),
+  };
+}

package/examples/google-hotels/search_hotels/workflow.json

@@ -0,0 +1,127 @@
+{
+  "toolName": "search_hotels",
+  "intent": {
+    "description": "Search Google Hotels for a location and date range with optional filters (price, rating, amenities, star class, brands, sort, property type).",
+    "userSaid": "searched for hotels at chicago loop from july 3-6; filtered for > 4.0 rating; filtered min and max price; added amenities; added 2/4/5 star; added brand filters; sorted by lowest price, highest rating, most reviewed; changed property type to vacation rentals; changed location to tahoe city and denver downtown"
+  },
+  "parameters": [
+    {
+      "name": "location",
+      "type": "string",
+      "description": "Destination query, e.g. 'chicago loop', 'tahoe city', 'denver downtown'",
+      "default": "chicago loop",
+      "verified": true
+    },
+    {
+      "name": "check_in_date",
+      "type": "string",
+      "description": "Check-in date (YYYY-MM-DD)",
+      "default": "2026-07-03",
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "check_out_date",
+      "type": "string",
+      "description": "Check-out date (YYYY-MM-DD)",
+      "default": "2026-07-06",
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "adults",
+      "type": "number",
+      "description": "Number of adult travelers",
+      "default": 2,
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "children",
+      "type": "number",
+      "description": "Number of child travelers",
+      "default": 0,
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "min_rating",
+      "type": "number",
+      "description": "Minimum guest rating filter, e.g. 4.0 (0 = no filter)",
+      "default": 0,
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "min_price",
+      "type": "number",
+      "description": "Minimum nightly price filter (0 = no filter)",
+      "default": 0,
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "max_price",
+      "type": "number",
+      "description": "Maximum nightly price filter, e.g. 338 (0 = no filter)",
+      "default": 0,
+      "verified": true
+    },
+    {
+      "name": "amenities",
+      "type": "string",
+      "description": "Comma-separated amenity names or codes (e.g. 'free wi-fi,pool' or '6,9'); empty = no filter",
+      "default": "",
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "hotel_class",
+      "type": "string",
+      "description": "Comma-separated star classes, e.g. '2,3' or '4,5'; empty = no filter",
+      "default": "",
+      "verified": true
+    },
+    {
+      "name": "brands",
+      "type": "string",
+      "description": "Comma-separated brand codes ('parent:child' or numeric); empty = no filter",
+      "default": "",
+      "verified": false,
+      "verifyNote": "annotated"
+    },
+    {
+      "name": "sort_by",
+      "type": "string",
+      "description": "Sort order: relevance | lowest_price | highest_rating | most_reviewed",
+      "default": "relevance",
+      "verified": true
+    },
+    {
+      "name": "property_type",
+      "type": "string",
+      "description": "hotels | vacation_rentals",
+      "default": "hotels",
+      "verified": true
+    }
+  ],
+  "requests": [
+    {
+      "method": "POST",
+      "url": "https://www.google.com/_/TravelFrontendUi/data/batchexecute?rpcids=AtySUc&source-path=%2Ftravel%2Fsearch&f.sid=7513562915459271421&bl=boq_travel-frontend-ui_20260527.01_p0&hl=en-US&soc-app=162&soc-platform=1&soc-device=1&_reqid=2252256&rt=c",
+      "headers": {
+        "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8",
+        "X-Same-Domain": "1",
+        "x-goog-ext-259736195-jspb": "[\"en-US\",\"US\",\"USD\",2,null,[420],null,null,7,[]]",
+        "x-goog-ext-190139975-jspb": "[\"US\",\"ZZ\",\"x6c25Q==\"]",
+        "Referer": "https://www.google.com/travel/search"
+      },
+      "body": "f.req={\"location\":\"${param.location}\",\"check_in_date\":\"${param.check_in_date}\",\"check_out_date\":\"${param.check_out_date}\",\"adults\":\"${param.adults}\",\"children\":\"${param.children}\",\"min_rating\":\"${param.min_rating}\",\"min_price\":\"${param.min_price}\",\"max_price\":\"${param.max_price}\",\"amenities\":\"${param.amenities}\",\"hotel_class\":\"${param.hotel_class}\",\"brands\":\"${param.brands}\",\"sort_by\":\"${param.sort_by}\",\"property_type\":\"${param.property_type}\"}",
+      "effect": "safe"
+    }
+  ],
+  "site": "google-hotels",
+  "requestTransformModule": "./request-transform.ts",
+  "parserModule": "./parser.ts",
+  "liveVerified": true
+}

package/examples/southwest/README.md

@@ -8,13 +8,14 @@
 - **`probe-backends` skipping the futile rung.** The cached `backends.json` orders the ladder `stealth-fetch → playbook` so cron doesn't burn 200ms on a fetch attempt every tick.
 - **`notifyWhen: price_below`** pushing only on real drops, with the `pricePath` extracting from real Southwest response shape.
 - **The fresh-UUID header trick** — Southwest rejects stale `X-User-Experience-ID`; stealth-fetch regenerates per call.
+- **Public bootstrap config capture.** The workflow fetches Southwest's public bootstrap `data.js` and captures the current `api-keys.prod` value, so installed examples do not require a `SOUTHWEST_API_KEY` environment variable.
 - **Multi-path `pricePath`** — `cron.json`'s notifyWhen lists both the raw API shape (when stealth-fetch wins) and the playbook's reshaped output, so the push fires regardless of which backend produced the result.
 
 ## Run it
 
 ```bash
-# One-time setup (if you haven't already)
-bunx playwright install chromium
+# One-time setup: registers the example MCP and installs Playwright Chromium if missing
+imprint install southwest --source examples --platform claude-desktop
 
 # Run a single tick (verifies everything still works)
 imprint cron southwest --once