imprint-mcp 0.2.0

package/examples/namecheap-domains/search_namecheap_domains/request-transform.ts

@@ -0,0 +1,136 @@
+/**
+ * Request transform for Namecheap RTB endpoints.
+ *
+ * The namecheap.com domain-search UI signs every request to its real-time
+ * bidding APIs (rtb.namecheapapi.com, etc.) with an `rcs` query param
+ * computed by client-side JavaScript. The signature is:
+ *   1. Build a canonical string:
+ *        "<secret> <nonce32hex> <METHOD> <pathname> <key1>=<encodedValue1>&<key2>=..."
+ *      where query pairs come from the URL's raw search string (encoded values),
+ *      excluding any existing `rcs` key, sorted alphabetically by key. The
+ *      values are then re-encoded with encodeURIComponent (potentially
+ *      double-encoding), per the original JS implementation.
+ *   2. Compute CRC32 (signed 32-bit) of that string.
+ *   3. JSON.stringify({val: <crc>, n: <nonce>}).
+ *   4. XOR each character of the JSON with 73, then base64 the resulting
+ *      binary string. That value, URL-encoded, becomes the rcs param.
+ *
+ * The two static "secrets" (one for *.namecheapapi.com, one for *.revved.com)
+ * are app-level constants embedded in the public domain-search bundle — not
+ * per-user secrets — and gate access to real availability/pricing data.
+ * Without a valid rcs the API returns sentinel "domain.com" mock data.
+ */
+
+const NC_SECRET = '815e7ef93be85bebe5959f6f72d7e542';
+const REVVED_SECRET = '8f6c7d5691eebd3b5090dc6b06755d58';
+
+const NC_HOST_RE =
+  /(sb[.-])?(rtb|aftermarket|premiums|pricerequest|business-lookup|domain-suggestion)?\.namecheapapi\.com$/;
+const REVVED_HOST_RE = /(sb-)?domains?\.revved\.com$/;
+
+// CRC32 lookup table (matching the `crc-32` npm module v1.2.2 used by the site).
+const CRC32_TABLE: Int32Array = (() => {
+  const t = new Int32Array(256);
+  for (let n = 0; n < 256; n++) {
+    let e = n;
+    for (let k = 0; k < 8; k++) {
+      e = e & 1 ? -306674912 ^ (e >>> 1) : e >>> 1;
+    }
+    t[n] = e;
+  }
+  return t;
+})();
+
+function crc32Str(str: string, seed = 0): number {
+  let r = ~seed;
+  for (let a = 0; a < str.length; a++) {
+    let i = str.charCodeAt(a);
+    if (i < 128) {
+      r = (r >>> 8) ^ CRC32_TABLE[(r ^ i) & 255]!;
+    } else if (i < 2048) {
+      r = (r >>> 8) ^ CRC32_TABLE[(r ^ (192 | ((i >> 6) & 31))) & 255]!;
+      r = (r >>> 8) ^ CRC32_TABLE[(r ^ (128 | (63 & i))) & 255]!;
+    } else if (i >= 55296 && i < 57344) {
+      i = 64 + (1023 & i);
+      const s = 1023 & str.charCodeAt(++a);
+      r = (r >>> 8) ^ CRC32_TABLE[(r ^ (240 | ((i >> 8) & 7))) & 255]!;
+      r = (r >>> 8) ^ CRC32_TABLE[(r ^ (128 | ((i >> 2) & 63))) & 255]!;
+      r = (r >>> 8) ^ CRC32_TABLE[(r ^ (128 | ((s >> 6) & 15) | ((3 & i) << 4))) & 255]!;
+      r = (r >>> 8) ^ CRC32_TABLE[(r ^ (128 | (63 & s))) & 255]!;
+    } else {
+      r = (r >>> 8) ^ CRC32_TABLE[(r ^ (224 | ((i >> 12) & 15))) & 255]!;
+      r = (r >>> 8) ^ CRC32_TABLE[(r ^ (128 | ((i >> 6) & 63))) & 255]!;
+      r = (r >>> 8) ^ CRC32_TABLE[(r ^ (128 | (63 & i))) & 255]!;
+    }
+  }
+  return ~r;
+}
+
+function randomNonce32Hex(): string {
+  let s = '';
+  for (let i = 0; i < 32; i++) s += Math.floor(Math.random() * 16).toString(16);
+  return s;
+}
+
+function chooseSecret(host: string): string | null {
+  if (REVVED_HOST_RE.test(host)) return REVVED_SECRET;
+  if (NC_HOST_RE.test(host)) return NC_SECRET;
+  return null;
+}
+
+export function transform(method: string, urlStr: string, responses?: unknown[]): string {
+  let url: URL;
+  try {
+    url = new URL(urlStr);
+  } catch {
+    return urlStr;
+  }
+
+  // domainStatus placeholder: replace __PLACEHOLDER__ with actual domain
+  // names extracted from the search response (responses[1]).
+  // Use string replacement instead of searchParams.set to avoid encoding commas.
+  if (url.pathname === '/v1/domainStatus' && urlStr.includes('__PLACEHOLDER__') && responses) {
+    const search = responses[1] as { picks?: Array<{ domain?: string }>; ranks?: Array<{ domain?: string }>; exact_match?: { domain?: string } } | undefined;
+    const domains = new Set<string>();
+    if (search?.exact_match?.domain) domains.add(search.exact_match.domain);
+    for (const p of search?.picks ?? []) { if (p?.domain) domains.add(p.domain); }
+    for (const r of search?.ranks ?? []) { if (r?.domain) domains.add(r.domain); }
+    urlStr = urlStr.replace('__PLACEHOLDER__', [...domains].join(','));
+    try { url = new URL(urlStr); } catch { return urlStr; }
+  }
+
+  const secret = chooseSecret(url.host);
+  if (!secret) return urlStr;
+
+  const nonce = randomNonce32Hex();
+  let canonical = `${secret} ${nonce} ${method.toUpperCase()} ${url.pathname} `;
+
+  const pairs: Array<[string, string]> = [];
+  if (url.search && url.search.startsWith('?')) {
+    for (const part of url.search.slice(1).split('&')) {
+      const idx = part.indexOf('=');
+      if (idx === -1) continue;
+      const k = part.slice(0, idx);
+      const v = part.slice(idx + 1);
+      if (k !== 'rcs') pairs.push([k, v]);
+    }
+  }
+  pairs.sort((a, b) => (a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0));
+  canonical += pairs.map(([k, v]) => `${k}=${encodeURIComponent(v)}`).join('&');
+
+  const val = crc32Str(canonical, 0);
+  const payload = JSON.stringify({ val, n: nonce });
+
+  let xored = '';
+  for (let i = 0; i < payload.length; i++) {
+    xored += String.fromCharCode(73 ^ payload.charCodeAt(i));
+  }
+
+  // Buffer is available in Bun/Node; encode the XOR'd binary string as base64.
+  const rcs = Buffer.from(xored, 'binary').toString('base64');
+
+  // Strip any pre-existing rcs param the caller may have placed in the URL.
+  const filtered = pairs.map(([k, v]) => `${k}=${v}`).join('&');
+  const newSearch = filtered ? `?${filtered}&rcs=${encodeURIComponent(rcs)}` : `?rcs=${encodeURIComponent(rcs)}`;
+  return `${url.origin}${url.pathname}${newSearch}${url.hash}`;
+}

package/examples/namecheap-domains/search_namecheap_domains/workflow.json

@@ -0,0 +1,97 @@
+{
+  "toolName": "search_namecheap_domains",
+  "intent": {
+    "description": "Search Namecheap for available domains matching a query, returning the exact-match availability + pricing, suggested domain picks across many TLDs, the TLD catalog, and Spaceship/brandstore aftermarket marketplace listings.",
+    "userSaid": "i searched for imprint on namecheap. njow there are a lot of filters, by default i am on \"Popular\". there were about 30 filters. i cycled through all of them"
+  },
+  "parameters": [
+    {
+      "name": "query",
+      "type": "string",
+      "description": "The SLD (second-level-domain) or search term to look up (e.g. 'imprint').",
+      "default": "imprint"
+    },
+    {
+      "name": "category",
+      "type": "string",
+      "description": "Optional TLD category filter to narrow returned suggestions. One of the CategoryName values exposed by the TLD catalog: 'popular', 'international', 'new', '088domains'. Leave empty for unfiltered results.",
+      "default": ""
+    }
+  ],
+  "site": "namecheap-domains",
+  "requests": [
+    {
+      "method": "GET",
+      "url": "https://www.namecheap.com/domains/tlds.ashx",
+      "headers": {
+        "Accept": "application/json, text/plain, */*",
+        "Accept-Language": "en-US,en;q=0.9",
+        "Referer": "https://www.namecheap.com/domains/registration/results/?domain=${param.query}",
+        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/147.0.0.0 Safari/537.36",
+        "sec-ch-ua": "\"Chromium\";v=\"147\", \"Not.A/Brand\";v=\"8\"",
+        "sec-ch-ua-mobile": "?0",
+        "sec-ch-ua-platform": "\"macOS\""
+      },
+      "effect": "safe"
+    },
+    {
+      "method": "GET",
+      "url": "https://rtb.namecheapapi.com/api/search/${param.query}?session_id=1000000000000&search=false",
+      "headers": {
+        "Accept": "application/json, text/plain, */*",
+        "Accept-Language": "en-US,en;q=0.9",
+        "Origin": "https://www.namecheap.com",
+        "Referer": "https://www.namecheap.com/",
+        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/147.0.0.0 Safari/537.36",
+        "sec-ch-ua": "\"Chromium\";v=\"147\", \"Not.A/Brand\";v=\"8\"",
+        "sec-ch-ua-mobile": "?0",
+        "sec-ch-ua-platform": "\"macOS\""
+      },
+      "effect": "safe"
+    },
+    {
+      "method": "GET",
+      "url": "https://rtb.namecheapapi.com/api/picks/${param.query}?session_id=1000000000000",
+      "headers": {
+        "Accept": "application/json, text/plain, */*",
+        "Accept-Language": "en-US,en;q=0.9",
+        "Origin": "https://www.namecheap.com",
+        "Referer": "https://www.namecheap.com/",
+        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/147.0.0.0 Safari/537.36",
+        "sec-ch-ua": "\"Chromium\";v=\"147\", \"Not.A/Brand\";v=\"8\"",
+        "sec-ch-ua-mobile": "?0",
+        "sec-ch-ua-platform": "\"macOS\""
+      },
+      "effect": "safe"
+    },
+    {
+      "method": "POST",
+      "url": "https://www.namecheap.com/api/v1/ncpl/domainsearchgateway/domain/readBySld",
+      "headers": {
+        "Accept": "application/json, text/plain, */*",
+        "Accept-Language": "en-US,en;q=0.9",
+        "Content-Type": "application/json; charset=UTF-8",
+        "Origin": "https://www.namecheap.com",
+        "Referer": "https://www.namecheap.com/domains/registration/results/?domain=${param.query}",
+        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/147.0.0.0 Safari/537.36",
+        "X-Requested-With": "XMLHttpRequest",
+        "sec-ch-ua": "\"Chromium\";v=\"147\", \"Not.A/Brand\";v=\"8\"",
+        "sec-ch-ua-mobile": "?0",
+        "sec-ch-ua-platform": "\"macOS\""
+      },
+      "body": "{\"request\":{\"sld\":\"${param.query}\",\"sources\":[\"sellerhub\",\"brandstore\"]}}",
+      "effect": "safe"
+    },
+    {
+      "method": "GET",
+      "url": "https://domains.revved.com/v1/domainStatus?whois=true&domains=__PLACEHOLDER__",
+      "headers": {
+        "Accept": "application/json, text/plain, */*",
+        "Referer": "https://www.namecheap.com/"
+      },
+      "effect": "safe"
+    }
+  ],
+  "parserModule": "./parser.ts",
+  "requestTransformModule": "./request-transform.ts"
+}

package/examples/southwest/README.md

@@ -0,0 +1,81 @@
+# Southwest fare-drop watcher
+
+> Watch a Southwest route, push when the lowest fare drops below your threshold. Defeats Akamai bot detection via `stealth-fetch`.
+
+## What this shows off
+
+- **The full backend ladder in action.** `fetch` returns 403 (Akamai), `stealth-fetch` mints sensor tokens via a brief Playwright bootstrap then succeeds in ~10s/call.
+- **`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.
+- **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
+
+# Run a single tick (verifies everything still works)
+imprint cron southwest --once
+
+# Production: foreground daemon
+NTFY_URL=https://ntfy.sh/your-secret-topic imprint cron southwest
+
+# Production: OS scheduler (cron / systemd timer / launchd) — wraps --once
+NTFY_URL=https://ntfy.sh/your-secret-topic imprint cron southwest --once
+```
+
+## What you should see
+
+```
+[imprint cron] config: examples/southwest/search_southwest_flights/cron.json
+[imprint cron] backends.json: probed 2026-05-03T22:23Z, preferred order: stealth-fetch → playbook
+[imprint cron] tool: search_southwest_flights (5 param(s))
+[imprint cron] schedule: 0 9 * * *
+[imprint cron] notifyWhen: price_below
+[imprint cron] replayBackend: auto (ladder: stealth-fetch → playbook)
+[imprint backend] trying stealth-fetch…
+[imprint stealth] bootstrapping…
+[imprint stealth] bootstrapped in ~13s — 21 cookies, 6 sensor headers
+[imprint backend] stealth-fetch: OK in ~15s
+[imprint cron]   OK in ~15s via stealth-fetch: {"data":{"searchResults":{...,"value":"108.40"}}}
+```
+
+Real Southwest data, real $108.40 lowest WGA fare. Bootstrap is one-time per process; subsequent ticks reuse the stealth-fetch session.
+
+## Files
+
+| File | What |
+|---|---|
+| `~/.imprint/southwest/sessions/<ts>.{jsonl,json}` | Raw recording (local only — may contain cookies) |
+| `~/.imprint/southwest/sessions/<ts>.redacted.json` | Scrubbed for LLM analysis |
+| `workflow.json` | API workflow used by stealth-fetch backend |
+| `index.ts` | Generated tool function (`opts.fetchImpl` is what stealth-fetch injects into) |
+| `playbook.yaml` | DOM playbook fallback — single navigate to the URL-prefilled search + XHR result extraction |
+| `cron.json` | Daily 9am tick; `replayBackend: "auto"`; `price_below: 99` |
+| `backends.json` | Probe artifact — `preferredOrder: ["stealth-fetch", "playbook"]` |
+
+## Tuning
+
+- **Threshold**: currently `$99`. Today's lowest is $108.40 so nothing fires; lower for noisy alerts, raise to wait for a deeper drop.
+- **Date**: polls one date (`departure_date: 2026-06-20`). Multiple dates = multiple `cron.json` files for now.
+- **Re-probe**: re-run `imprint probe-backends southwest` if the cron starts erroring — Akamai's sensor schema changes occasionally.
+
+## Notes (gotchas this demo handles)
+
+These came up during bring-up; documented so the next person knows they're handled:
+
+- **Hidden duplicate elements.** Southwest renders both a custom dropdown and a hidden native `<select>`. Runner filters to visible.
+- **Wrapper intercepts pointer events.** Clickable `<strong>` inside `role=checkbox`. Runner retries with `force: true`.
+- **Date input is non-typeable.** URL-prefilled navigation sidesteps the calendar widget.
+- **Vanilla Playwright gets a 403.** `navigator.webdriver` is the tell. Stealth plugin patches it.
+- **Token GC race.** Playwright GCs response bodies aggressively. Runner reads inside the response handler and drains pending text() promises before extracting.
+- **`networkidle` hangs on SPAs.** Persistent connections never go idle. Runner uses `domcontentloaded` + the explicit `wait_for`.
+- **Stale `X-User-Experience-ID`.** stealth-fetch regenerates a fresh UUID per call AND auto-injects if the workflow dropped it.
+
+## Not in this demo
+
+- Auto-booking the cheaper flight on a drop (read-only watcher).
+- Multi-date sweep (one `cron.json` per date).
+- Hosted execution (run foreground or wire to your OS scheduler).

package/examples/southwest/search_southwest_flights/backends.json

@@ -0,0 +1,23 @@
+{
+  "probedAt": "2026-05-03T22:23:26.619Z",
+  "imprintVersion": "0.1.0",
+  "preferredOrder": [
+    "stealth-fetch",
+    "playbook"
+  ],
+  "results": {
+    "fetch": {
+      "outcome": "forbidden",
+      "durationMs": 579,
+      "detail": "Request 0 returned 403: {\n  \"code\": 403050700\n}"
+    },
+    "stealth-fetch": {
+      "outcome": "ok",
+      "durationMs": 12419
+    },
+    "playbook": {
+      "outcome": "ok",
+      "durationMs": 13597
+    }
+  }
+}

package/examples/southwest/search_southwest_flights/cron.json

@@ -0,0 +1,19 @@
+{
+  "schedule": "0 9 * * *",
+  "replayBackend": "auto",
+  "params": {
+    "origin_airport_code": "SJC",
+    "destination_airport_code": "SAN",
+    "departure_date": "2026-06-20",
+    "adult_passengers_count": 1,
+    "fare_type": "USD"
+  },
+  "notifyWhen": {
+    "type": "price_below",
+    "threshold": 99,
+    "pricePath": [
+      "data.searchResults.airProducts[].lowestFare.value",
+      "prices[]"
+    ]
+  }
+}

package/examples/southwest/search_southwest_flights/index.ts

@@ -0,0 +1,110 @@
+/**
+ * GENERATED by `imprint emit` — DO NOT EDIT BY HAND.
+ *
+ * Tool: search_southwest_flights
+ * Site: southwest
+ * Intent: Search for one-way Southwest Airlines flights between two airports on a given departure date, returning available flights and fares.
+ *
+ * To regenerate: imprint emit ~/.imprint/southwest/search_southwest_flights/workflow.json --force
+ */
+
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import {
+  executeWorkflow,
+  type CredentialStore,
+} from 'imprint/runtime';
+import type { ToolResult, Workflow } from 'imprint/types';
+
+const WORKFLOW: Workflow = {
+  "toolName": "search_southwest_flights",
+  "intent": {
+    "description": "Search for one-way Southwest Airlines flights between two airports on a given departure date, returning available flights and fares.",
+    "userSaid": "i just specified the departure and arrival airports (SJC and SAN) i set teh depart date now i changed to one way trip only now i clicked search now i clicked hte low fare calendar i clicked 26 june from the low fare calendar now i clicked continue to flight times on the low fare calendar, and now it's showing me the flight prices for 26 june"
+  },
+  "parameters": [
+    {
+      "name": "origin_airport_code",
+      "type": "string",
+      "description": "IATA code for the departure airport (e.g. SJC)",
+      "default": "SJC"
+    },
+    {
+      "name": "destination_airport_code",
+      "type": "string",
+      "description": "IATA code for the arrival airport (e.g. SAN)",
+      "default": "SAN"
+    },
+    {
+      "name": "departure_date",
+      "type": "string",
+      "description": "Departure date in YYYY-MM-DD format",
+      "default": "2026-06-23"
+    },
+    {
+      "name": "adult_passengers_count",
+      "type": "number",
+      "description": "Number of adult passengers",
+      "default": 1
+    },
+    {
+      "name": "fare_type",
+      "type": "string",
+      "description": "Fare currency type: USD for dollars, POINTS for Rapid Rewards points",
+      "default": "USD"
+    }
+  ],
+  "requests": [
+    {
+      "method": "POST",
+      "url": "https://www.southwest.com/api/air-booking/v1/air-booking/page/air/booking/shopping",
+      "headers": {
+        "Content-Type": "application/json",
+        "Accept": "application/json, text/javascript, */*; q=0.01",
+        "X-API-Key": "${env.SOUTHWEST_API_KEY}",
+        "X-App-ID": "air-booking",
+        "X-Channel-ID": "southwest"
+      },
+      "body": "{\"adultPassengersCount\":\"${param.adult_passengers_count}\",\"adultsCount\":\"${param.adult_passengers_count}\",\"departureDate\":\"${param.departure_date}\",\"departureTimeOfDay\":\"ALL_DAY\",\"destinationAirportCode\":\"${param.destination_airport_code}\",\"fareType\":\"${param.fare_type}\",\"int\":\"HOMEQBOMAIR\",\"originationAirportCode\":\"${param.origin_airport_code}\",\"passengerType\":\"ADULT\",\"promoCode\":\"\",\"returnDate\":\"\",\"returnTimeOfDay\":\"ALL_DAY\",\"tripType\":\"oneway\",\"application\":\"air-booking\",\"site\":\"southwest\"}"
+    }
+  ],
+  "site": "southwest"
+};
+
+export interface SearchSouthwestFlightsInput {
+  /** IATA code for the departure airport (e.g. SJC) */
+  origin_airport_code?: string;
+  /** IATA code for the arrival airport (e.g. SAN) */
+  destination_airport_code?: string;
+  /** Departure date in YYYY-MM-DD format */
+  departure_date?: string;
+  /** Number of adult passengers */
+  adult_passengers_count?: number;
+  /** Fare currency type: USD for dollars, POINTS for Rapid Rewards points */
+  fare_type?: string;
+}
+
+export async function searchSouthwestFlights(
+  input: SearchSouthwestFlightsInput,
+  opts: { credentials?: CredentialStore; fetchImpl?: typeof fetch; initialState?: Record<string, unknown> } = {},
+): Promise<ToolResult> {
+  const __dirname = dirname(fileURLToPath(import.meta.url));
+  const params: Record<string, string | number | boolean> = {
+    origin_airport_code: input.origin_airport_code ?? "SJC",
+    destination_airport_code: input.destination_airport_code ?? "SAN",
+    departure_date: input.departure_date ?? "2026-06-23",
+    adult_passengers_count: input.adult_passengers_count ?? 1,
+    fare_type: input.fare_type ?? "USD",
+
+  };
+  return executeWorkflow({
+    workflow: WORKFLOW,
+    params,
+    credentials: opts.credentials,
+    fetchImpl: opts.fetchImpl,
+    initialState: opts.initialState,
+    workflowPath: join(__dirname, 'workflow.json'),
+  });
+}
+
+export { WORKFLOW };

package/examples/southwest/search_southwest_flights/playbook.yaml

@@ -0,0 +1,46 @@
+toolName: search_southwest_flights
+summary: |
+  Search Southwest for one-way fares between two airports on a given date.
+  Uses the URL-prefilled search shortcut so a single navigation triggers the
+  shopping XHR — no DOM walk needed. Stealth Chromium (default in the runner)
+  defeats Akamai's bot detection that blocks naive HTTP clients.
+parameters:
+  - name: origin_airport_code
+    type: string
+    description: IATA origin airport code, e.g. SJC
+  - name: destination_airport_code
+    type: string
+    description: IATA destination airport code, e.g. SAN
+  - name: departure_date
+    type: string
+    description: YYYY-MM-DD
+  - name: adult_passengers_count
+    type: number
+    description: Number of adult passengers
+    default: 1
+  - name: fare_type
+    type: string
+    description: "USD or POINTS"
+    default: USD
+steps:
+  - action: navigate
+    url: https://www.southwest.com/air/booking/select-depart.html?adultsCount=${adult_passengers_count}&adultPassengersCount=${adult_passengers_count}&originationAirportCode=${origin_airport_code}&destinationAirportCode=${destination_airport_code}&departureDate=${departure_date}&departureTimeOfDay=ALL_DAY&fareType=${fare_type}&int=HOMEQBOMAIR&passengerType=ADULT&promoCode=&returnDate=&returnTimeOfDay=ALL_DAY&tripType=oneway
+    wait_for:
+      xhr: /api/air-booking/v1/air-booking/page/air/booking/shopping
+result:
+  source: xhr
+  url_pattern: /api/air-booking/v1/air-booking/page/air/booking/shopping
+  extract: data.searchResults.airProducts[].lowestFare.value
+  return_as: prices
+notes: |
+  Param names match workflow.json exactly (origin_airport_code etc., not the
+  friendlier origin) so cron.json's params block is shared across the
+  fetch / stealth-fetch / playbook backends and the auto-ladder can hot-swap
+  between them without rewriting params.
+
+  The original recording walked through the form (autocompletes, date picker,
+  trip-type dropdown, search submit, Low Fare Calendar drilldown). Six
+  iterations revealed Southwest's date input is non-typeable (zero input
+  events captured on #departureDate — the user clicked the input + clicked
+  a calendar cell). The URL-param shortcut sidesteps every form-fill quirk
+  in one navigation.

package/examples/southwest/search_southwest_flights/workflow.json

@@ -0,0 +1,54 @@
+{
+  "toolName": "search_southwest_flights",
+  "intent": {
+    "description": "Search for one-way Southwest Airlines flights between two airports on a given departure date, returning available flights and fares.",
+    "userSaid": "i just specified the departure and arrival airports (SJC and SAN) i set teh depart date now i changed to one way trip only now i clicked search now i clicked hte low fare calendar i clicked 26 june from the low fare calendar now i clicked continue to flight times on the low fare calendar, and now it's showing me the flight prices for 26 june"
+  },
+  "parameters": [
+    {
+      "name": "origin_airport_code",
+      "type": "string",
+      "description": "IATA code for the departure airport (e.g. SJC)",
+      "default": "SJC"
+    },
+    {
+      "name": "destination_airport_code",
+      "type": "string",
+      "description": "IATA code for the arrival airport (e.g. SAN)",
+      "default": "SAN"
+    },
+    {
+      "name": "departure_date",
+      "type": "string",
+      "description": "Departure date in YYYY-MM-DD format",
+      "default": "2026-06-23"
+    },
+    {
+      "name": "adult_passengers_count",
+      "type": "number",
+      "description": "Number of adult passengers",
+      "default": 1
+    },
+    {
+      "name": "fare_type",
+      "type": "string",
+      "description": "Fare currency type: USD for dollars, POINTS for Rapid Rewards points",
+      "default": "USD"
+    }
+  ],
+  "requests": [
+    {
+      "method": "POST",
+      "url": "https://www.southwest.com/api/air-booking/v1/air-booking/page/air/booking/shopping",
+      "headers": {
+        "Content-Type": "application/json",
+        "Accept": "application/json, text/javascript, */*; q=0.01",
+        "X-API-Key": "${env.SOUTHWEST_API_KEY}",
+        "X-App-ID": "air-booking",
+        "X-Channel-ID": "southwest"
+      },
+      "body": "{\"adultPassengersCount\":\"${param.adult_passengers_count}\",\"adultsCount\":\"${param.adult_passengers_count}\",\"departureDate\":\"${param.departure_date}\",\"departureTimeOfDay\":\"ALL_DAY\",\"destinationAirportCode\":\"${param.destination_airport_code}\",\"fareType\":\"${param.fare_type}\",\"int\":\"HOMEQBOMAIR\",\"originationAirportCode\":\"${param.origin_airport_code}\",\"passengerType\":\"ADULT\",\"promoCode\":\"\",\"returnDate\":\"\",\"returnTimeOfDay\":\"ALL_DAY\",\"tripType\":\"oneway\",\"application\":\"air-booking\",\"site\":\"southwest\"}"
+    }
+  ],
+  "site": "southwest"
+}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "imprint-mcp",
+  "version": "0.2.0",
+  "description": "Teach an AI agent how to use any website. Once. Records a real browser session + narration; generates a deterministic MCP tool plus a DOM-replay playbook fallback.",
+  "type": "module",
+  "exports": {
+    "./runtime": "./src/imprint/runtime.ts",
+    "./types": "./src/imprint/types.ts"
+  },
+  "license": "MIT",
+  "author": "Ashay Changwani",
+  "homepage": "https://github.com/ashaychangwani/imprint",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ashaychangwani/imprint.git"
+  },
+  "files": [
+    "src/",
+    "prompts/",
+    "examples/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "bun": ">=1.3.0"
+  },
+  "bin": {
+    "imprint": "./src/cli.ts"
+  },
+  "scripts": {
+    "dev": "bun run src/cli.ts",
+    "imprint": "bun run src/cli.ts",
+    "doctor": "bun run src/cli.ts doctor",
+    "test": "bun test",
+    "lint": "biome check src test",
+    "lint:fix": "biome check --write src test",
+    "typecheck": "tsc --noEmit",
+    "knip": "knip --no-progress",
+    "deadcode": "bun run knip && bun run circular",
+    "circular": "madge --circular --extensions ts src/",
+    "check": "bun run typecheck && bun run lint && bun run test && bun run deadcode",
+    "bench:redact": "bun run scripts/redact-benchmark.ts",
+    "build:binary": "bun run scripts/build-binary.ts",
+    "build:binary:all": "bun run scripts/build-binary.ts --all-targets",
+    "changelog": "bunx git-cliff --config cliff.toml --unreleased --strip header",
+    "prepare": "git config core.hooksPath .githooks"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.52.0",
+    "@arizeai/phoenix-otel": "^1.0.2",
+    "@clack/prompts": "^1.3.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@napi-rs/keyring": "^1.3.0",
+    "@noble/hashes": "^2.2.0",
+    "@opentelemetry/api": "^1.9.1",
+    "chrome-remote-interface": "^0.33.0",
+    "env-paths": "^3.0.0",
+    "libsodium-wrappers": "^0.8.4",
+    "node-cron": "^3.0.3",
+    "playwright": "^1.49.0",
+    "playwright-extra": "^4.3.6",
+    "puppeteer-extra-plugin-stealth": "^2.11.2",
+    "redactum": "^1.1.0",
+    "yaml": "^2.8.4",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@types/bun": "^1.1.0",
+    "@types/chrome-remote-interface": "^0.31.14",
+    "@types/node": "^22.10.0",
+    "@types/node-cron": "^3.0.11",
+    "knip": "^5.0.0",
+    "madge": "^8.0.0",
+    "typescript": "^5.7.0"
+  }
+}