mcp-scraper 0.1.3 → 0.1.4

package/dist/bin/api-server.cjs

@@ -10700,6 +10700,587 @@ var init_FacebookAdExtractor = __esm({
   }
 });
 
+// src/extractor/FacebookAdGraphql.ts
+function parseFbGraphqlJson(text) {
+  const out = [];
+  const body = text.replace(/^for\s*\(;;\);/, "").trim();
+  try {
+    out.push(JSON.parse(body));
+    return out;
+  } catch {
+    for (const line of body.split("\n")) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      try {
+        out.push(JSON.parse(trimmed));
+      } catch {
+        continue;
+      }
+    }
+    return out;
+  }
+}
+function extractCollatedResults(payload) {
+  const root = payload;
+  const edges = root?.data?.ad_library_main?.search_results_connection?.edges ?? [];
+  const results = [];
+  for (const edge of edges) {
+    const node = edge?.node;
+    for (const raw of node?.collated_results ?? []) {
+      const r = raw;
+      const id = r.ad_archive_id;
+      if (id === void 0 || id === null) continue;
+      const snapshot = r.snapshot ?? null;
+      results.push({
+        ad_archive_id: String(id),
+        page_id: r.page_id != null ? String(r.page_id) : "",
+        page_name: r.page_name ?? snapshot?.page_name ?? "",
+        is_active: Boolean(r.is_active),
+        collation_count: typeof r.collation_count === "number" ? r.collation_count : null,
+        snapshot
+      });
+    }
+  }
+  return results;
+}
+async function collectAdLibraryResults(page, url, maxResults, opts = {}) {
+  const captureMs = opts.captureMs ?? 3e4;
+  const collected = [];
+  const seen = /* @__PURE__ */ new Set();
+  const handler = (resp) => {
+    if (!resp.url().includes("/api/graphql")) return;
+    const friendlyName = (resp.request().postData() ?? "").match(/fb_api_req_friendly_name=([^&]+)/)?.[1];
+    if (friendlyName !== AD_LIBRARY_QUERY) return;
+    void resp.text().then((text) => {
+      for (const payload of parseFbGraphqlJson(text)) {
+        for (const result of extractCollatedResults(payload)) {
+          if (seen.has(result.ad_archive_id)) continue;
+          seen.add(result.ad_archive_id);
+          collected.push(result);
+        }
+      }
+    }).catch(() => void 0);
+  };
+  page.on("response", handler);
+  try {
+    await page.goto(url, { waitUntil: "domcontentloaded", timeout: 45e3 });
+    const deadline = Date.now() + captureMs;
+    let lastCount = -1;
+    let stableRounds = 0;
+    while (Date.now() < deadline && collected.length < maxResults) {
+      await page.evaluate(() => window.scrollTo(0, document.body.scrollHeight)).catch(() => void 0);
+      await page.waitForTimeout(2e3);
+      if (collected.length === lastCount) {
+        stableRounds++;
+        if (stableRounds >= 2 && collected.length > 0) break;
+      } else {
+        stableRounds = 0;
+      }
+      lastCount = collected.length;
+    }
+  } finally {
+    page.off("response", handler);
+  }
+  return collected.slice(0, maxResults);
+}
+function advertisersFromResults(results, maxResults) {
+  const byPage = /* @__PURE__ */ new Map();
+  for (const r of results) {
+    if (!r.page_id || !r.page_name) continue;
+    const collation = typeof r.collation_count === "number" && r.collation_count > 0 ? r.collation_count : 0;
+    const existing = byPage.get(r.page_id);
+    if (existing) {
+      existing.resultCount++;
+      existing.maxCollation = Math.max(existing.maxCollation, collation);
+    } else {
+      byPage.set(r.page_id, { pageName: r.page_name, pageId: r.page_id, sampleLibraryId: r.ad_archive_id, maxCollation: collation, resultCount: 1 });
+    }
+  }
+  return [...byPage.values()].map((e) => ({ pageName: e.pageName, pageId: e.pageId, sampleLibraryId: e.sampleLibraryId, adCount: Math.max(e.maxCollation, e.resultCount) })).sort((a, b) => b.adCount - a.adCount).slice(0, maxResults);
+}
+var AD_LIBRARY_QUERY;
+var init_FacebookAdGraphql = __esm({
+  "src/extractor/FacebookAdGraphql.ts"() {
+    "use strict";
+    AD_LIBRARY_QUERY = "AdLibrarySearchPaginationQuery";
+  }
+});
+
+// src/locations.ts
+var LOCATIONS;
+var init_locations = __esm({
+  "src/locations.ts"() {
+    "use strict";
+    LOCATIONS = {
+      "austin": "Austin,Texas,United States",
+      "new york": "New York,New York,United States",
+      "new york city": "New York,New York,United States",
+      "nyc": "New York,New York,United States",
+      "los angeles": "Los Angeles,California,United States",
+      "la": "Los Angeles,California,United States",
+      "chicago": "Chicago,Illinois,United States",
+      "houston": "Houston,Texas,United States",
+      "phoenix": "Phoenix,Arizona,United States",
+      "philadelphia": "Philadelphia,Pennsylvania,United States",
+      "philly": "Philadelphia,Pennsylvania,United States",
+      "san antonio": "San Antonio,Texas,United States",
+      "dallas": "Dallas,Texas,United States",
+      "miami": "Miami,Florida,United States",
+      "seattle": "Seattle,Washington,United States",
+      "denver": "Denver,Colorado,United States",
+      "loveland": "Loveland,Colorado,United States",
+      "loveland co": "Loveland,Colorado,United States",
+      "fort collins": "Fort Collins,Colorado,United States",
+      "boulder": "Boulder,Colorado,United States",
+      "colorado springs": "Colorado Springs,Colorado,United States",
+      "boston": "Boston,Massachusetts,United States",
+      "atlanta": "Atlanta,Georgia,United States",
+      "san francisco": "San Francisco,California,United States",
+      "sf": "San Francisco,California,United States",
+      "portland": "Portland,Oregon,United States",
+      "las vegas": "Las Vegas,Nevada,United States",
+      "minneapolis": "Minneapolis,Minnesota,United States",
+      "detroit": "Detroit,Michigan,United States",
+      "nashville": "Nashville,Tennessee,United States",
+      "charlotte": "Charlotte,North Carolina,United States",
+      "orlando": "Orlando,Florida,United States",
+      "san diego": "San Diego,California,United States",
+      "baltimore": "Baltimore,Maryland,United States",
+      "sacramento": "Sacramento,California,United States",
+      "columbus": "Columbus,Ohio,United States",
+      "indianapolis": "Indianapolis,Indiana,United States",
+      "san jose": "San Jose,California,United States",
+      "fort worth": "Fort Worth,Texas,United States",
+      "jacksonville": "Jacksonville,Florida,United States",
+      "memphis": "Memphis,Tennessee,United States",
+      "louisville": "Louisville,Kentucky,United States",
+      "raleigh": "Raleigh,North Carolina,United States",
+      "richmond": "Richmond,Virginia,United States",
+      "salt lake city": "Salt Lake City,Utah,United States",
+      "toronto": "Toronto,Ontario,Canada",
+      "vancouver": "Vancouver,British Columbia,Canada",
+      "montreal": "Montreal,Quebec,Canada",
+      "calgary": "Calgary,Alberta,Canada",
+      "ottawa": "Ottawa,Ontario,Canada",
+      "london": "London,England,United Kingdom",
+      "manchester": "Manchester,England,United Kingdom",
+      "birmingham": "Birmingham,England,United Kingdom",
+      "edinburgh": "Edinburgh,Scotland,United Kingdom",
+      "glasgow": "Glasgow,Scotland,United Kingdom",
+      "leeds": "Leeds,England,United Kingdom",
+      "sydney": "Sydney,New South Wales,Australia",
+      "melbourne": "Melbourne,Victoria,Australia",
+      "brisbane": "Brisbane,Queensland,Australia",
+      "perth": "Perth,Western Australia,Australia",
+      "adelaide": "Adelaide,South Australia,Australia",
+      "dublin": "Dublin,Leinster,Ireland"
+    };
+  }
+});
+
+// src/uule.ts
+function encodeVarint(value) {
+  const bytes = [];
+  let remaining = value;
+  do {
+    let byte = remaining & 127;
+    remaining >>>= 7;
+    if (remaining > 0) byte |= 128;
+    bytes.push(byte);
+  } while (remaining > 0);
+  return bytes;
+}
+function encodeUule(name) {
+  const locationBytes = Buffer.from(name, "utf8");
+  const payload = Buffer.concat([
+    Buffer.from([8, 2, 16, 32, 34]),
+    Buffer.from(encodeVarint(locationBytes.length)),
+    locationBytes
+  ]);
+  return `w+${payload.toString("base64")}`;
+}
+function normalizeLocation(input) {
+  const raw = input.toLowerCase().trim();
+  if (LOCATIONS[raw]) return LOCATIONS[raw];
+  const beforeComma = raw.split(",")[0].trim();
+  if (beforeComma !== raw && LOCATIONS[beforeComma]) return LOCATIONS[beforeComma];
+  const withoutState = raw.replace(/\s+[a-z]{2}$/, "").trim();
+  if (withoutState !== raw && LOCATIONS[withoutState]) return LOCATIONS[withoutState];
+  return input;
+}
+var init_uule = __esm({
+  "src/uule.ts"() {
+    "use strict";
+    init_locations();
+  }
+});
+
+// src/kernel-proxy-resolver.ts
+function proxyIdSuffix2(proxyId) {
+  return proxyId ? proxyId.slice(-6) : null;
+}
+function resolution(source, proxyMode, proxyId, target, error) {
+  return {
+    kernelProxyId: proxyId,
+    resolution: {
+      source,
+      proxyMode,
+      proxyIdPresent: Boolean(proxyId),
+      proxyIdSuffix: proxyIdSuffix2(proxyId),
+      target,
+      error
+    }
+  };
+}
+function normalizeStateName(value) {
+  return value.trim().toLowerCase().replace(/\s+/g, " ");
+}
+function normalizeCountryName(value) {
+  return value.trim().toLowerCase().replace(/\./g, "").replace(/\s+/g, " ");
+}
+function isUnitedStates(country) {
+  if (!country) return true;
+  const normalized = normalizeCountryName(country);
+  return normalized === "united states" || normalized === "united states of america" || normalized === "usa" || normalized === "us";
+}
+function stateCodeFor(region) {
+  const trimmed = region.trim();
+  if (/^[A-Za-z]{2}$/.test(trimmed)) return trimmed.toUpperCase();
+  return US_STATE_CODES[normalizeStateName(trimmed)] ?? null;
+}
+function kernelCityIdentifierCandidates(city) {
+  const ascii = city.normalize("NFKD").replace(/[^\x00-\x7F]/g, "").toLowerCase();
+  const words = ascii.split(/[^a-z0-9]+/).filter(Boolean);
+  const underscored = words.join("_");
+  const compact = words.join("");
+  return Array.from(new Set([underscored, compact].filter(Boolean)));
+}
+function proxyName(country, state, city) {
+  return city ? `mcp-serp-residential-${country.toLowerCase()}-${state.toLowerCase()}-${city}` : `mcp-serp-residential-${country.toLowerCase()}-${state.toLowerCase()}`;
+}
+function zipProxyName(zip) {
+  return `mcp-serp-residential-us-zip-${zip}`;
+}
+function parseKernelLocationProxyTarget(location, gl) {
+  if (!location || gl.toLowerCase() !== "us") return null;
+  const canonicalLocation = normalizeLocation(location);
+  let parts = canonicalLocation.split(",").map((part) => part.trim()).filter(Boolean);
+  if (parts.length > 1 && isUnitedStates(parts[parts.length - 1])) {
+    parts = parts.slice(0, -1);
+  }
+  if (parts.length === 1) {
+    const stateOnly = stateCodeFor(parts[0]);
+    if (!stateOnly) return null;
+    return {
+      canonicalLocation,
+      level: "state",
+      country: "US",
+      state: stateOnly,
+      city: "",
+      cityCandidates: [],
+      proxyName: proxyName("US", stateOnly),
+      config: {
+        country: "US",
+        state: stateOnly
+      }
+    };
+  }
+  const [city = "", region = ""] = parts;
+  if (!city || !region) return null;
+  const state = stateCodeFor(region);
+  if (!state) return null;
+  const cityCandidates = kernelCityIdentifierCandidates(city);
+  const primaryCity = cityCandidates[0];
+  if (!primaryCity) return null;
+  return {
+    canonicalLocation,
+    level: "city",
+    country: "US",
+    state,
+    city: primaryCity,
+    cityCandidates,
+    proxyName: proxyName("US", state, primaryCity),
+    config: {
+      country: "US",
+      state,
+      city: primaryCity
+    }
+  };
+}
+function cityZipKey(target) {
+  return `${target.city}|${target.state}`;
+}
+function knownZipFor(target, explicitZip) {
+  if (explicitZip && /^\d{5}$/.test(explicitZip)) return explicitZip;
+  return US_CITY_CENTER_ZIPS[cityZipKey(target)] ?? null;
+}
+function zipTarget(target, zip) {
+  return {
+    ...target,
+    level: "zip",
+    zip,
+    proxyName: zipProxyName(zip),
+    config: {
+      country: target.country,
+      state: target.state,
+      zip
+    }
+  };
+}
+function configMatches(config, target, city) {
+  if (target.level === "zip") {
+    return config?.country?.toUpperCase() === target.country && config?.zip === target.zip;
+  }
+  return config?.country?.toUpperCase() === target.country && config?.state?.toUpperCase() === target.state && (city ? config?.city === city : !config?.city);
+}
+function findExistingTargetProxy(proxies, target) {
+  return proxies.find((proxy) => proxy.type === "residential" && proxy.status !== "unavailable" && Boolean(proxy.id) && (proxy.name === target.proxyName || configMatches(proxy.config, target, target.level === "city" ? target.city : void 0))) ?? null;
+}
+function findExistingProxy(proxies, target) {
+  for (const city of target.cityCandidates) {
+    const name = proxyName(target.country, target.state, city);
+    const found = proxies.find((proxy) => proxy.type === "residential" && proxy.status !== "unavailable" && Boolean(proxy.id) && (proxy.name === name || configMatches(proxy.config, target, city)));
+    if (found) return found;
+  }
+  return null;
+}
+function stateTarget(target) {
+  return {
+    ...target,
+    level: "state",
+    proxyName: proxyName(target.country, target.state),
+    config: {
+      country: target.country,
+      state: target.state
+    }
+  };
+}
+function findExistingStateProxy(proxies, target) {
+  const name = proxyName(target.country, target.state);
+  return proxies.find((proxy) => proxy.type === "residential" && proxy.status !== "unavailable" && Boolean(proxy.id) && (proxy.name === name || configMatches(proxy.config, target))) ?? null;
+}
+function escalatedTargetLevel(target, attemptIndex) {
+  return stateTarget(target);
+}
+function errorText2(err) {
+  return err instanceof Error ? err.message : String(err);
+}
+async function resolveKernelProxyId(options) {
+  if (options.proxyMode === "none") {
+    return resolution("disabled", options.proxyMode, void 0, null, null);
+  }
+  if (options.proxyMode === "configured") {
+    return resolution("configured_fallback", options.proxyMode, options.configuredKernelProxyId, null, null);
+  }
+  const target = parseKernelLocationProxyTarget(options.location, options.gl);
+  if (!target || !options.kernelApiKey) {
+    return resolution("configured_fallback", options.proxyMode, options.configuredKernelProxyId, target, target ? null : "location could not be normalized to a US city/state proxy target");
+  }
+  const kernel = new import_sdk5.default({ apiKey: options.kernelApiKey });
+  try {
+    const attemptIndex = options.attemptIndex ?? 0;
+    if (attemptIndex >= 1) {
+      const escalatedTarget = escalatedTargetLevel(target, attemptIndex);
+      const createErrors2 = [];
+      try {
+        const created = await kernel.proxies.create({
+          type: "residential",
+          name: escalatedTarget.proxyName,
+          config: escalatedTarget.config
+        });
+        if (created.id) {
+          return resolution("location_created", options.proxyMode, created.id, escalatedTarget, null);
+        }
+        createErrors2.push(`${escalatedTarget.state}: Kernel did not return a proxy id`);
+      } catch (err) {
+        createErrors2.push(`${escalatedTarget.state}: ${errorText2(err)}`);
+      }
+      return resolution("configured_fallback", options.proxyMode, options.configuredKernelProxyId, escalatedTarget, createErrors2.join(" | "));
+    }
+    const proxies = await kernel.proxies.list();
+    const zip = knownZipFor(target, options.proxyZip);
+    const createErrors = [];
+    if (zip) {
+      const targetZip = zipTarget(target, zip);
+      const existingZip = findExistingTargetProxy(proxies, targetZip);
+      if (existingZip?.id) {
+        return resolution("location_reused", options.proxyMode, existingZip.id, targetZip, null);
+      }
+      try {
+        const created = await kernel.proxies.create({
+          type: "residential",
+          name: targetZip.proxyName,
+          config: {
+            country: targetZip.country,
+            zip
+          }
+        });
+        if (created.id) {
+          return resolution("location_created", options.proxyMode, created.id, targetZip, null);
+        }
+        createErrors.push(`${zip}: Kernel did not return a proxy id`);
+      } catch (err) {
+        createErrors.push(`${zip}: ${errorText2(err)}`);
+      }
+    }
+    const existing = findExistingProxy(proxies, target);
+    if (existing?.id) {
+      return resolution("location_reused", options.proxyMode, existing.id, target, createErrors.join(" | ") || null);
+    }
+    for (const city of target.cityCandidates) {
+      try {
+        const created = await kernel.proxies.create({
+          type: "residential",
+          name: proxyName(target.country, target.state, city),
+          config: {
+            country: target.country,
+            state: target.state,
+            city
+          }
+        });
+        if (created.id) {
+          return resolution("location_created", options.proxyMode, created.id, {
+            ...target,
+            level: "city",
+            city,
+            proxyName: proxyName(target.country, target.state, city),
+            config: {
+              country: target.country,
+              state: target.state,
+              city
+            }
+          }, null);
+        }
+        createErrors.push(`${city}: Kernel did not return a proxy id`);
+      } catch (err) {
+        createErrors.push(`${city}: ${errorText2(err)}`);
+      }
+    }
+    const fallbackTarget = stateTarget(target);
+    const existingState = findExistingStateProxy(proxies, fallbackTarget);
+    if (existingState?.id) {
+      return resolution("location_reused", options.proxyMode, existingState.id, fallbackTarget, createErrors.join(" | "));
+    }
+    try {
+      const created = await kernel.proxies.create({
+        type: "residential",
+        name: fallbackTarget.proxyName,
+        config: fallbackTarget.config
+      });
+      if (created.id) {
+        return resolution("location_created", options.proxyMode, created.id, fallbackTarget, createErrors.join(" | "));
+      }
+      createErrors.push(`${fallbackTarget.state}: Kernel did not return a proxy id`);
+    } catch (err) {
+      createErrors.push(`${fallbackTarget.state}: ${errorText2(err)}`);
+    }
+    return resolution("configured_fallback", options.proxyMode, options.configuredKernelProxyId, target, createErrors.join(" | "));
+  } catch (err) {
+    return resolution("configured_fallback", options.proxyMode, options.configuredKernelProxyId, target, errorText2(err));
+  }
+}
+var import_sdk5, US_STATE_CODES, US_CITY_CENTER_ZIPS;
+var init_kernel_proxy_resolver = __esm({
+  "src/kernel-proxy-resolver.ts"() {
+    "use strict";
+    import_sdk5 = __toESM(require("@onkernel/sdk"), 1);
+    init_uule();
+    US_STATE_CODES = {
+      alabama: "AL",
+      alaska: "AK",
+      arizona: "AZ",
+      arkansas: "AR",
+      california: "CA",
+      colorado: "CO",
+      connecticut: "CT",
+      delaware: "DE",
+      florida: "FL",
+      georgia: "GA",
+      hawaii: "HI",
+      idaho: "ID",
+      illinois: "IL",
+      indiana: "IN",
+      iowa: "IA",
+      kansas: "KS",
+      kentucky: "KY",
+      louisiana: "LA",
+      maine: "ME",
+      maryland: "MD",
+      massachusetts: "MA",
+      michigan: "MI",
+      minnesota: "MN",
+      mississippi: "MS",
+      missouri: "MO",
+      montana: "MT",
+      nebraska: "NE",
+      nevada: "NV",
+      "new hampshire": "NH",
+      "new jersey": "NJ",
+      "new mexico": "NM",
+      "new york": "NY",
+      "north carolina": "NC",
+      "north dakota": "ND",
+      ohio: "OH",
+      oklahoma: "OK",
+      oregon: "OR",
+      pennsylvania: "PA",
+      "rhode island": "RI",
+      "south carolina": "SC",
+      "south dakota": "SD",
+      tennessee: "TN",
+      texas: "TX",
+      utah: "UT",
+      vermont: "VT",
+      virginia: "VA",
+      washington: "WA",
+      "west virginia": "WV",
+      wisconsin: "WI",
+      wyoming: "WY"
+    };
+    US_CITY_CENTER_ZIPS = {
+      "atlanta|GA": "30303",
+      "austin|TX": "78701",
+      "baltimore|MD": "21201",
+      "boston|MA": "02108",
+      "boulder|CO": "80302",
+      "charlotte|NC": "28202",
+      "chicago|IL": "60601",
+      "colorado_springs|CO": "80903",
+      "columbus|OH": "43215",
+      "dallas|TX": "75201",
+      "denver|CO": "80202",
+      "detroit|MI": "48226",
+      "fort_collins|CO": "80524",
+      "fort_worth|TX": "76102",
+      "houston|TX": "77002",
+      "indianapolis|IN": "46204",
+      "jacksonville|FL": "32202",
+      "las_vegas|NV": "89101",
+      "los_angeles|CA": "90012",
+      "louisville|KY": "40202",
+      "loveland|CO": "80537",
+      "memphis|TN": "38103",
+      "miami|FL": "33131",
+      "minneapolis|MN": "55401",
+      "nashville|TN": "37203",
+      "new_york|NY": "10001",
+      "orlando|FL": "32801",
+      "philadelphia|PA": "19103",
+      "phoenix|AZ": "85004",
+      "portland|OR": "97205",
+      "raleigh|NC": "27601",
+      "richmond|VA": "23219",
+      "sacramento|CA": "95814",
+      "salt_lake_city|UT": "84101",
+      "san_antonio|TX": "78205",
+      "san_diego|CA": "92101",
+      "san_francisco|CA": "94103",
+      "san_jose|CA": "95113",
+      "seattle|WA": "98101"
+    };
+  }
+});
+
 // src/api/facebook-ad-routes.ts
 function invalidRequest(message) {
   return { error_code: "invalid_request", message };
@@ -10717,6 +11298,22 @@ function buildPageIntelUrl(body, country) {
 function kernelLaunchOpts() {
   return { headless: true, kernelApiKey: process.env.KERNEL_API_KEY?.trim(), kernelProxyId: process.env.KERNEL_PROXY_ID?.trim(), viewport: { width: 1280, height: 900 }, locale: "en-US" };
 }
+async function kernelLaunchOptsResidential() {
+  let proxyId = process.env.KERNEL_PROXY_ID?.trim();
+  try {
+    const resolution2 = await resolveKernelProxyId({
+      kernelApiKey: process.env.KERNEL_API_KEY?.trim(),
+      proxyMode: "location",
+      configuredKernelProxyId: process.env.KERNEL_PROXY_ID?.trim(),
+      location: "New York, NY",
+      gl: "us"
+    });
+    if (resolution2.kernelProxyId) proxyId = resolution2.kernelProxyId;
+  } catch {
+    proxyId = process.env.KERNEL_PROXY_ID?.trim();
+  }
+  return { headless: true, kernelApiKey: process.env.KERNEL_API_KEY?.trim(), kernelProxyId: proxyId, viewport: { width: 1280, height: 900 }, locale: "en-US" };
+}
 var import_hono4, import_zod15, import_client3, FacebookAdBodySchema, FacebookPageIntelBodySchema, FacebookTranscribeBodySchema, FacebookSearchBodySchema, FacebookMediaBodySchema, facebookAdApp, ALLOWED_MEDIA_HOSTS;
 var init_facebook_ad_routes = __esm({
   "src/api/facebook-ad-routes.ts"() {
@@ -10727,6 +11324,8 @@ var init_facebook_ad_routes = __esm({
     init_rates();
     init_BrowserDriver();
     init_FacebookAdExtractor();
+    init_FacebookAdGraphql();
+    init_kernel_proxy_resolver();
     import_client3 = require("@fal-ai/client");
     init_api_auth();
     init_url_utils();
@@ -10812,7 +11411,7 @@ var init_facebook_ad_routes = __esm({
       const driver = new BrowserDriver();
       let refunded = false;
       try {
-        await driver.launch(kernelLaunchOpts());
+        await driver.launch(await kernelLaunchOptsResidential());
         await driver.navigateTo(listingUrl);
         const extractor = new FacebookAdExtractor(driver);
         const result = await extractor.extractPageIntel(listingUrl, maxAds);
@@ -10896,18 +11495,15 @@ var init_facebook_ad_routes = __esm({
       const driver = new BrowserDriver();
       let searchRefunded = false;
       try {
-        await driver.launch(kernelLaunchOpts());
+        await driver.launch(await kernelLaunchOptsResidential());
         const page = driver.getPage();
-        await driver.navigateTo(searchUrl);
-        try {
-          await page.waitForFunction(
-            () => {
-              const bt = document.body ? document.body.innerText ?? "" : "";
-              return bt.includes("Library ID") || bt.includes("No results");
-            },
-            { timeout: 2e4, polling: 500 }
-          );
-        } catch {
+        const collated = await collectAdLibraryResults(page, searchUrl, Math.max(maxResults * 4, 40));
+        const gqlAdvertisers = advertisersFromResults(collated, maxResults);
+        if (gqlAdvertisers.length > 0) {
+          const results2 = gqlAdvertisers.map((a) => ({ name: a.pageName, pageName: a.pageName, pageId: a.pageId, libraryId: a.sampleLibraryId, sampleLibraryId: a.sampleLibraryId, adCount: a.adCount }));
+          const searchResult2 = { query: body.query.trim(), searchUrl, results: results2, via: "graphql" };
+          await logRequestEvent({ userId: fbUser.id, source: "facebook_search", status: "done", query: body.query.trim(), resultCount: results2.length, result: searchResult2 });
+          return c.json(searchResult2);
         }
         await page.waitForTimeout(1500);
         for (let scroll = 0; scroll < 3; scroll++) {
@@ -10953,7 +11549,7 @@ var init_facebook_ad_routes = __esm({
             advertiserMap.set(pageName, { pageName, sampleLibraryId: libraryId, adCount: 1 });
           }
         }
-        const results = [...advertiserMap.values()].sort((a, b) => b.adCount - a.adCount).slice(0, maxResults);
+        const results = [...advertiserMap.values()].sort((a, b) => b.adCount - a.adCount).slice(0, maxResults).map((a) => ({ name: a.pageName, pageName: a.pageName, libraryId: a.sampleLibraryId, sampleLibraryId: a.sampleLibraryId, adCount: a.adCount }));
         const searchResult = { query: body.query.trim(), searchUrl, results };
         await logRequestEvent({ userId: fbUser.id, source: "facebook_search", status: "done", query: body.query.trim(), resultCount: results.length, result: searchResult });
         return c.json(searchResult);
@@ -11944,136 +12540,27 @@ async function capturePageSnapshots(targets, options = {}) {
   const capturedCount = pageSnapshotArtifacts.filter((artifact) => artifact.status === "captured").length;
   return {
     pageSnapshotArtifacts,
-    attempts,
-    diagnostics: {
-      requestedCount: targets.length,
-      capturedCount,
-      failedCount: targets.length - capturedCount,
-      maxConcurrency,
-      timeoutMs
-    }
-  };
-}
-var import_node_crypto2, import_p_limit3, DEFAULT_TIMEOUT_MS, DEFAULT_MAX_CONCURRENCY, DEFAULT_MAX_CONTENT_CHARS;
-var init_page_snapshot_extractor = __esm({
-  "src/serp-intelligence/page-snapshot-extractor.ts"() {
-    "use strict";
-    import_node_crypto2 = require("crypto");
-    import_p_limit3 = __toESM(require("p-limit"), 1);
-    init_kpo_extractor();
-    init_url_utils();
-    DEFAULT_TIMEOUT_MS = 15e3;
-    DEFAULT_MAX_CONCURRENCY = 2;
-    DEFAULT_MAX_CONTENT_CHARS = 25e4;
-  }
-});
-
-// src/locations.ts
-var LOCATIONS;
-var init_locations = __esm({
-  "src/locations.ts"() {
-    "use strict";
-    LOCATIONS = {
-      "austin": "Austin,Texas,United States",
-      "new york": "New York,New York,United States",
-      "new york city": "New York,New York,United States",
-      "nyc": "New York,New York,United States",
-      "los angeles": "Los Angeles,California,United States",
-      "la": "Los Angeles,California,United States",
-      "chicago": "Chicago,Illinois,United States",
-      "houston": "Houston,Texas,United States",
-      "phoenix": "Phoenix,Arizona,United States",
-      "philadelphia": "Philadelphia,Pennsylvania,United States",
-      "philly": "Philadelphia,Pennsylvania,United States",
-      "san antonio": "San Antonio,Texas,United States",
-      "dallas": "Dallas,Texas,United States",
-      "miami": "Miami,Florida,United States",
-      "seattle": "Seattle,Washington,United States",
-      "denver": "Denver,Colorado,United States",
-      "loveland": "Loveland,Colorado,United States",
-      "loveland co": "Loveland,Colorado,United States",
-      "fort collins": "Fort Collins,Colorado,United States",
-      "boulder": "Boulder,Colorado,United States",
-      "colorado springs": "Colorado Springs,Colorado,United States",
-      "boston": "Boston,Massachusetts,United States",
-      "atlanta": "Atlanta,Georgia,United States",
-      "san francisco": "San Francisco,California,United States",
-      "sf": "San Francisco,California,United States",
-      "portland": "Portland,Oregon,United States",
-      "las vegas": "Las Vegas,Nevada,United States",
-      "minneapolis": "Minneapolis,Minnesota,United States",
-      "detroit": "Detroit,Michigan,United States",
-      "nashville": "Nashville,Tennessee,United States",
-      "charlotte": "Charlotte,North Carolina,United States",
-      "orlando": "Orlando,Florida,United States",
-      "san diego": "San Diego,California,United States",
-      "baltimore": "Baltimore,Maryland,United States",
-      "sacramento": "Sacramento,California,United States",
-      "columbus": "Columbus,Ohio,United States",
-      "indianapolis": "Indianapolis,Indiana,United States",
-      "san jose": "San Jose,California,United States",
-      "fort worth": "Fort Worth,Texas,United States",
-      "jacksonville": "Jacksonville,Florida,United States",
-      "memphis": "Memphis,Tennessee,United States",
-      "louisville": "Louisville,Kentucky,United States",
-      "raleigh": "Raleigh,North Carolina,United States",
-      "richmond": "Richmond,Virginia,United States",
-      "salt lake city": "Salt Lake City,Utah,United States",
-      "toronto": "Toronto,Ontario,Canada",
-      "vancouver": "Vancouver,British Columbia,Canada",
-      "montreal": "Montreal,Quebec,Canada",
-      "calgary": "Calgary,Alberta,Canada",
-      "ottawa": "Ottawa,Ontario,Canada",
-      "london": "London,England,United Kingdom",
-      "manchester": "Manchester,England,United Kingdom",
-      "birmingham": "Birmingham,England,United Kingdom",
-      "edinburgh": "Edinburgh,Scotland,United Kingdom",
-      "glasgow": "Glasgow,Scotland,United Kingdom",
-      "leeds": "Leeds,England,United Kingdom",
-      "sydney": "Sydney,New South Wales,Australia",
-      "melbourne": "Melbourne,Victoria,Australia",
-      "brisbane": "Brisbane,Queensland,Australia",
-      "perth": "Perth,Western Australia,Australia",
-      "adelaide": "Adelaide,South Australia,Australia",
-      "dublin": "Dublin,Leinster,Ireland"
-    };
-  }
-});
-
-// src/uule.ts
-function encodeVarint(value) {
-  const bytes = [];
-  let remaining = value;
-  do {
-    let byte = remaining & 127;
-    remaining >>>= 7;
-    if (remaining > 0) byte |= 128;
-    bytes.push(byte);
-  } while (remaining > 0);
-  return bytes;
-}
-function encodeUule(name) {
-  const locationBytes = Buffer.from(name, "utf8");
-  const payload = Buffer.concat([
-    Buffer.from([8, 2, 16, 32, 34]),
-    Buffer.from(encodeVarint(locationBytes.length)),
-    locationBytes
-  ]);
-  return `w+${payload.toString("base64")}`;
-}
-function normalizeLocation(input) {
-  const raw = input.toLowerCase().trim();
-  if (LOCATIONS[raw]) return LOCATIONS[raw];
-  const beforeComma = raw.split(",")[0].trim();
-  if (beforeComma !== raw && LOCATIONS[beforeComma]) return LOCATIONS[beforeComma];
-  const withoutState = raw.replace(/\s+[a-z]{2}$/, "").trim();
-  if (withoutState !== raw && LOCATIONS[withoutState]) return LOCATIONS[withoutState];
-  return input;
+    attempts,
+    diagnostics: {
+      requestedCount: targets.length,
+      capturedCount,
+      failedCount: targets.length - capturedCount,
+      maxConcurrency,
+      timeoutMs
+    }
+  };
 }
-var init_uule = __esm({
-  "src/uule.ts"() {
+var import_node_crypto2, import_p_limit3, DEFAULT_TIMEOUT_MS, DEFAULT_MAX_CONCURRENCY, DEFAULT_MAX_CONTENT_CHARS;
+var init_page_snapshot_extractor = __esm({
+  "src/serp-intelligence/page-snapshot-extractor.ts"() {
     "use strict";
-    init_locations();
+    import_node_crypto2 = require("crypto");
+    import_p_limit3 = __toESM(require("p-limit"), 1);
+    init_kpo_extractor();
+    init_url_utils();
+    DEFAULT_TIMEOUT_MS = 15e3;
+    DEFAULT_MAX_CONCURRENCY = 2;
+    DEFAULT_MAX_CONTENT_CHARS = 25e4;
   }
 });
 
@@ -13347,442 +13834,76 @@ var init_OutputSerializer = __esm({
       }
       async writeAIOverviewCSV(citations, text, seed, outputDir) {
         await import_node_fs3.promises.mkdir(outputDir, { recursive: true });
-        const slug = seed.toLowerCase().replace(/\W+/g, "-").slice(0, 40);
-        const rows = citations.map((c, i) => ({
-          seed_query: seed,
-          response_text: i === 0 ? text ?? "" : "",
-          citation_text: c.text,
-          citation_href: c.href
-        }));
-        const csv = import_papaparse2.default.unparse(rows, { header: true });
-        const filename = `${slug}-ai-overview-${Date.now()}.csv`;
-        const fullPath = import_node_path5.default.join(outputDir, filename);
-        await import_node_fs3.promises.writeFile(fullPath, csv, "utf8");
-        return fullPath;
-      }
-      async writeAIModeCSV(citations, text, seed, outputDir) {
-        await import_node_fs3.promises.mkdir(outputDir, { recursive: true });
-        const slug = seed.toLowerCase().replace(/\W+/g, "-").slice(0, 40);
-        const rows = citations.map((c, i) => ({
-          seed_query: seed,
-          response_text: i === 0 ? text ?? "" : "",
-          citation_text: c.text,
-          citation_href: c.href
-        }));
-        const csv = import_papaparse2.default.unparse(rows, { header: true });
-        const filename = `${slug}-ai-mode-${Date.now()}.csv`;
-        const fullPath = import_node_path5.default.join(outputDir, filename);
-        await import_node_fs3.promises.writeFile(fullPath, csv, "utf8");
-        return fullPath;
-      }
-      async writeWhatPeopleSayingCSV(cards, seed, outputDir) {
-        await import_node_fs3.promises.mkdir(outputDir, { recursive: true });
-        const slug = seed.toLowerCase().replace(/\W+/g, "-").slice(0, 40);
-        const rows = cards.map((c) => ({ seed_query: seed, ...c }));
-        const csv = import_papaparse2.default.unparse(rows, { header: true });
-        const filename = `${slug}-what-people-saying-${Date.now()}.csv`;
-        const fullPath = import_node_path5.default.join(outputDir, filename);
-        await import_node_fs3.promises.writeFile(fullPath, csv, "utf8");
-        return fullPath;
-      }
-    };
-  }
-});
-
-// src/output/ProgressReporter.ts
-var ProgressReporter;
-var init_ProgressReporter = __esm({
-  "src/output/ProgressReporter.ts"() {
-    "use strict";
-    ProgressReporter = class {
-      onQuestion(node) {
-        process.stdout.write(JSON.stringify({ event: "question", depth: node.depth, question: node.question }) + "\n");
-      }
-      onDepth(depth) {
-        process.stdout.write(JSON.stringify({ event: "depth", depth }) + "\n");
-      }
-      onVideos(videos) {
-        for (const v of videos) {
-          process.stdout.write(JSON.stringify({ event: "video", type: v.type, platform: v.platform, duration: v.duration, title: v.title, channel: v.channel, url: v.url }) + "\n");
-        }
-      }
-      onForums(forums) {
-        for (const f of forums) {
-          process.stdout.write(JSON.stringify({ event: "forum", title: f.title, source: f.source, url: f.url }) + "\n");
-        }
-      }
-      onComplete(stats) {
-        process.stdout.write(JSON.stringify({ event: "complete", ...stats }) + "\n");
-      }
-      onError(err) {
-        process.stderr.write(JSON.stringify({ event: "error", type: err.constructor.name, message: err.message }) + "\n");
-      }
-    };
-  }
-});
-
-// src/kernel-proxy-resolver.ts
-function proxyIdSuffix2(proxyId) {
-  return proxyId ? proxyId.slice(-6) : null;
-}
-function resolution(source, proxyMode, proxyId, target, error) {
-  return {
-    kernelProxyId: proxyId,
-    resolution: {
-      source,
-      proxyMode,
-      proxyIdPresent: Boolean(proxyId),
-      proxyIdSuffix: proxyIdSuffix2(proxyId),
-      target,
-      error
-    }
-  };
-}
-function normalizeStateName(value) {
-  return value.trim().toLowerCase().replace(/\s+/g, " ");
-}
-function normalizeCountryName(value) {
-  return value.trim().toLowerCase().replace(/\./g, "").replace(/\s+/g, " ");
-}
-function isUnitedStates(country) {
-  if (!country) return true;
-  const normalized = normalizeCountryName(country);
-  return normalized === "united states" || normalized === "united states of america" || normalized === "usa" || normalized === "us";
-}
-function stateCodeFor(region) {
-  const trimmed = region.trim();
-  if (/^[A-Za-z]{2}$/.test(trimmed)) return trimmed.toUpperCase();
-  return US_STATE_CODES[normalizeStateName(trimmed)] ?? null;
-}
-function kernelCityIdentifierCandidates(city) {
-  const ascii = city.normalize("NFKD").replace(/[^\x00-\x7F]/g, "").toLowerCase();
-  const words = ascii.split(/[^a-z0-9]+/).filter(Boolean);
-  const underscored = words.join("_");
-  const compact = words.join("");
-  return Array.from(new Set([underscored, compact].filter(Boolean)));
-}
-function proxyName(country, state, city) {
-  return city ? `mcp-serp-residential-${country.toLowerCase()}-${state.toLowerCase()}-${city}` : `mcp-serp-residential-${country.toLowerCase()}-${state.toLowerCase()}`;
-}
-function zipProxyName(zip) {
-  return `mcp-serp-residential-us-zip-${zip}`;
-}
-function parseKernelLocationProxyTarget(location, gl) {
-  if (!location || gl.toLowerCase() !== "us") return null;
-  const canonicalLocation = normalizeLocation(location);
-  let parts = canonicalLocation.split(",").map((part) => part.trim()).filter(Boolean);
-  if (parts.length > 1 && isUnitedStates(parts[parts.length - 1])) {
-    parts = parts.slice(0, -1);
-  }
-  if (parts.length === 1) {
-    const stateOnly = stateCodeFor(parts[0]);
-    if (!stateOnly) return null;
-    return {
-      canonicalLocation,
-      level: "state",
-      country: "US",
-      state: stateOnly,
-      city: "",
-      cityCandidates: [],
-      proxyName: proxyName("US", stateOnly),
-      config: {
-        country: "US",
-        state: stateOnly
-      }
-    };
-  }
-  const [city = "", region = ""] = parts;
-  if (!city || !region) return null;
-  const state = stateCodeFor(region);
-  if (!state) return null;
-  const cityCandidates = kernelCityIdentifierCandidates(city);
-  const primaryCity = cityCandidates[0];
-  if (!primaryCity) return null;
-  return {
-    canonicalLocation,
-    level: "city",
-    country: "US",
-    state,
-    city: primaryCity,
-    cityCandidates,
-    proxyName: proxyName("US", state, primaryCity),
-    config: {
-      country: "US",
-      state,
-      city: primaryCity
-    }
-  };
-}
-function cityZipKey(target) {
-  return `${target.city}|${target.state}`;
-}
-function knownZipFor(target, explicitZip) {
-  if (explicitZip && /^\d{5}$/.test(explicitZip)) return explicitZip;
-  return US_CITY_CENTER_ZIPS[cityZipKey(target)] ?? null;
-}
-function zipTarget(target, zip) {
-  return {
-    ...target,
-    level: "zip",
-    zip,
-    proxyName: zipProxyName(zip),
-    config: {
-      country: target.country,
-      state: target.state,
-      zip
-    }
-  };
-}
-function configMatches(config, target, city) {
-  if (target.level === "zip") {
-    return config?.country?.toUpperCase() === target.country && config?.zip === target.zip;
-  }
-  return config?.country?.toUpperCase() === target.country && config?.state?.toUpperCase() === target.state && (city ? config?.city === city : !config?.city);
-}
-function findExistingTargetProxy(proxies, target) {
-  return proxies.find((proxy) => proxy.type === "residential" && proxy.status !== "unavailable" && Boolean(proxy.id) && (proxy.name === target.proxyName || configMatches(proxy.config, target, target.level === "city" ? target.city : void 0))) ?? null;
-}
-function findExistingProxy(proxies, target) {
-  for (const city of target.cityCandidates) {
-    const name = proxyName(target.country, target.state, city);
-    const found = proxies.find((proxy) => proxy.type === "residential" && proxy.status !== "unavailable" && Boolean(proxy.id) && (proxy.name === name || configMatches(proxy.config, target, city)));
-    if (found) return found;
-  }
-  return null;
-}
-function stateTarget(target) {
-  return {
-    ...target,
-    level: "state",
-    proxyName: proxyName(target.country, target.state),
-    config: {
-      country: target.country,
-      state: target.state
-    }
-  };
-}
-function findExistingStateProxy(proxies, target) {
-  const name = proxyName(target.country, target.state);
-  return proxies.find((proxy) => proxy.type === "residential" && proxy.status !== "unavailable" && Boolean(proxy.id) && (proxy.name === name || configMatches(proxy.config, target))) ?? null;
-}
-function escalatedTargetLevel(target, attemptIndex) {
-  return stateTarget(target);
-}
-function errorText2(err) {
-  return err instanceof Error ? err.message : String(err);
-}
-async function resolveKernelProxyId(options) {
-  if (options.proxyMode === "none") {
-    return resolution("disabled", options.proxyMode, void 0, null, null);
-  }
-  if (options.proxyMode === "configured") {
-    return resolution("configured_fallback", options.proxyMode, options.configuredKernelProxyId, null, null);
-  }
-  const target = parseKernelLocationProxyTarget(options.location, options.gl);
-  if (!target || !options.kernelApiKey) {
-    return resolution("configured_fallback", options.proxyMode, options.configuredKernelProxyId, target, target ? null : "location could not be normalized to a US city/state proxy target");
+        const slug = seed.toLowerCase().replace(/\W+/g, "-").slice(0, 40);
+        const rows = citations.map((c, i) => ({
+          seed_query: seed,
+          response_text: i === 0 ? text ?? "" : "",
+          citation_text: c.text,
+          citation_href: c.href
+        }));
+        const csv = import_papaparse2.default.unparse(rows, { header: true });
+        const filename = `${slug}-ai-overview-${Date.now()}.csv`;
+        const fullPath = import_node_path5.default.join(outputDir, filename);
+        await import_node_fs3.promises.writeFile(fullPath, csv, "utf8");
+        return fullPath;
+      }
+      async writeAIModeCSV(citations, text, seed, outputDir) {
+        await import_node_fs3.promises.mkdir(outputDir, { recursive: true });
+        const slug = seed.toLowerCase().replace(/\W+/g, "-").slice(0, 40);
+        const rows = citations.map((c, i) => ({
+          seed_query: seed,
+          response_text: i === 0 ? text ?? "" : "",
+          citation_text: c.text,
+          citation_href: c.href
+        }));
+        const csv = import_papaparse2.default.unparse(rows, { header: true });
+        const filename = `${slug}-ai-mode-${Date.now()}.csv`;
+        const fullPath = import_node_path5.default.join(outputDir, filename);
+        await import_node_fs3.promises.writeFile(fullPath, csv, "utf8");
+        return fullPath;
+      }
+      async writeWhatPeopleSayingCSV(cards, seed, outputDir) {
+        await import_node_fs3.promises.mkdir(outputDir, { recursive: true });
+        const slug = seed.toLowerCase().replace(/\W+/g, "-").slice(0, 40);
+        const rows = cards.map((c) => ({ seed_query: seed, ...c }));
+        const csv = import_papaparse2.default.unparse(rows, { header: true });
+        const filename = `${slug}-what-people-saying-${Date.now()}.csv`;
+        const fullPath = import_node_path5.default.join(outputDir, filename);
+        await import_node_fs3.promises.writeFile(fullPath, csv, "utf8");
+        return fullPath;
+      }
+    };
   }
-  const kernel = new import_sdk5.default({ apiKey: options.kernelApiKey });
-  try {
-    const attemptIndex = options.attemptIndex ?? 0;
-    if (attemptIndex >= 1) {
-      const escalatedTarget = escalatedTargetLevel(target, attemptIndex);
-      const createErrors2 = [];
-      try {
-        const created = await kernel.proxies.create({
-          type: "residential",
-          name: escalatedTarget.proxyName,
-          config: escalatedTarget.config
-        });
-        if (created.id) {
-          return resolution("location_created", options.proxyMode, created.id, escalatedTarget, null);
-        }
-        createErrors2.push(`${escalatedTarget.state}: Kernel did not return a proxy id`);
-      } catch (err) {
-        createErrors2.push(`${escalatedTarget.state}: ${errorText2(err)}`);
+});
+
+// src/output/ProgressReporter.ts
+var ProgressReporter;
+var init_ProgressReporter = __esm({
+  "src/output/ProgressReporter.ts"() {
+    "use strict";
+    ProgressReporter = class {
+      onQuestion(node) {
+        process.stdout.write(JSON.stringify({ event: "question", depth: node.depth, question: node.question }) + "\n");
       }
-      return resolution("configured_fallback", options.proxyMode, options.configuredKernelProxyId, escalatedTarget, createErrors2.join(" | "));
-    }
-    const proxies = await kernel.proxies.list();
-    const zip = knownZipFor(target, options.proxyZip);
-    const createErrors = [];
-    if (zip) {
-      const targetZip = zipTarget(target, zip);
-      const existingZip = findExistingTargetProxy(proxies, targetZip);
-      if (existingZip?.id) {
-        return resolution("location_reused", options.proxyMode, existingZip.id, targetZip, null);
+      onDepth(depth) {
+        process.stdout.write(JSON.stringify({ event: "depth", depth }) + "\n");
       }
-      try {
-        const created = await kernel.proxies.create({
-          type: "residential",
-          name: targetZip.proxyName,
-          config: {
-            country: targetZip.country,
-            zip
-          }
-        });
-        if (created.id) {
-          return resolution("location_created", options.proxyMode, created.id, targetZip, null);
+      onVideos(videos) {
+        for (const v of videos) {
+          process.stdout.write(JSON.stringify({ event: "video", type: v.type, platform: v.platform, duration: v.duration, title: v.title, channel: v.channel, url: v.url }) + "\n");
         }
-        createErrors.push(`${zip}: Kernel did not return a proxy id`);
-      } catch (err) {
-        createErrors.push(`${zip}: ${errorText2(err)}`);
       }
-    }
-    const existing = findExistingProxy(proxies, target);
-    if (existing?.id) {
-      return resolution("location_reused", options.proxyMode, existing.id, target, createErrors.join(" | ") || null);
-    }
-    for (const city of target.cityCandidates) {
-      try {
-        const created = await kernel.proxies.create({
-          type: "residential",
-          name: proxyName(target.country, target.state, city),
-          config: {
-            country: target.country,
-            state: target.state,
-            city
-          }
-        });
-        if (created.id) {
-          return resolution("location_created", options.proxyMode, created.id, {
-            ...target,
-            level: "city",
-            city,
-            proxyName: proxyName(target.country, target.state, city),
-            config: {
-              country: target.country,
-              state: target.state,
-              city
-            }
-          }, null);
+      onForums(forums) {
+        for (const f of forums) {
+          process.stdout.write(JSON.stringify({ event: "forum", title: f.title, source: f.source, url: f.url }) + "\n");
         }
-        createErrors.push(`${city}: Kernel did not return a proxy id`);
-      } catch (err) {
-        createErrors.push(`${city}: ${errorText2(err)}`);
       }
-    }
-    const fallbackTarget = stateTarget(target);
-    const existingState = findExistingStateProxy(proxies, fallbackTarget);
-    if (existingState?.id) {
-      return resolution("location_reused", options.proxyMode, existingState.id, fallbackTarget, createErrors.join(" | "));
-    }
-    try {
-      const created = await kernel.proxies.create({
-        type: "residential",
-        name: fallbackTarget.proxyName,
-        config: fallbackTarget.config
-      });
-      if (created.id) {
-        return resolution("location_created", options.proxyMode, created.id, fallbackTarget, createErrors.join(" | "));
+      onComplete(stats) {
+        process.stdout.write(JSON.stringify({ event: "complete", ...stats }) + "\n");
+      }
+      onError(err) {
+        process.stderr.write(JSON.stringify({ event: "error", type: err.constructor.name, message: err.message }) + "\n");
       }
-      createErrors.push(`${fallbackTarget.state}: Kernel did not return a proxy id`);
-    } catch (err) {
-      createErrors.push(`${fallbackTarget.state}: ${errorText2(err)}`);
-    }
-    return resolution("configured_fallback", options.proxyMode, options.configuredKernelProxyId, target, createErrors.join(" | "));
-  } catch (err) {
-    return resolution("configured_fallback", options.proxyMode, options.configuredKernelProxyId, target, errorText2(err));
-  }
-}
-var import_sdk5, US_STATE_CODES, US_CITY_CENTER_ZIPS;
-var init_kernel_proxy_resolver = __esm({
-  "src/kernel-proxy-resolver.ts"() {
-    "use strict";
-    import_sdk5 = __toESM(require("@onkernel/sdk"), 1);
-    init_uule();
-    US_STATE_CODES = {
-      alabama: "AL",
-      alaska: "AK",
-      arizona: "AZ",
-      arkansas: "AR",
-      california: "CA",
-      colorado: "CO",
-      connecticut: "CT",
-      delaware: "DE",
-      florida: "FL",
-      georgia: "GA",
-      hawaii: "HI",
-      idaho: "ID",
-      illinois: "IL",
-      indiana: "IN",
-      iowa: "IA",
-      kansas: "KS",
-      kentucky: "KY",
-      louisiana: "LA",
-      maine: "ME",
-      maryland: "MD",
-      massachusetts: "MA",
-      michigan: "MI",
-      minnesota: "MN",
-      mississippi: "MS",
-      missouri: "MO",
-      montana: "MT",
-      nebraska: "NE",
-      nevada: "NV",
-      "new hampshire": "NH",
-      "new jersey": "NJ",
-      "new mexico": "NM",
-      "new york": "NY",
-      "north carolina": "NC",
-      "north dakota": "ND",
-      ohio: "OH",
-      oklahoma: "OK",
-      oregon: "OR",
-      pennsylvania: "PA",
-      "rhode island": "RI",
-      "south carolina": "SC",
-      "south dakota": "SD",
-      tennessee: "TN",
-      texas: "TX",
-      utah: "UT",
-      vermont: "VT",
-      virginia: "VA",
-      washington: "WA",
-      "west virginia": "WV",
-      wisconsin: "WI",
-      wyoming: "WY"
-    };
-    US_CITY_CENTER_ZIPS = {
-      "atlanta|GA": "30303",
-      "austin|TX": "78701",
-      "baltimore|MD": "21201",
-      "boston|MA": "02108",
-      "boulder|CO": "80302",
-      "charlotte|NC": "28202",
-      "chicago|IL": "60601",
-      "colorado_springs|CO": "80903",
-      "columbus|OH": "43215",
-      "dallas|TX": "75201",
-      "denver|CO": "80202",
-      "detroit|MI": "48226",
-      "fort_collins|CO": "80524",
-      "fort_worth|TX": "76102",
-      "houston|TX": "77002",
-      "indianapolis|IN": "46204",
-      "jacksonville|FL": "32202",
-      "las_vegas|NV": "89101",
-      "los_angeles|CA": "90012",
-      "louisville|KY": "40202",
-      "loveland|CO": "80537",
-      "memphis|TN": "38103",
-      "miami|FL": "33131",
-      "minneapolis|MN": "55401",
-      "nashville|TN": "37203",
-      "new_york|NY": "10001",
-      "orlando|FL": "32801",
-      "philadelphia|PA": "19103",
-      "phoenix|AZ": "85004",
-      "portland|OR": "97205",
-      "raleigh|NC": "27601",
-      "richmond|VA": "23219",
-      "sacramento|CA": "95814",
-      "salt_lake_city|UT": "84101",
-      "san_antonio|TX": "78205",
-      "san_diego|CA": "92101",
-      "san_francisco|CA": "94103",
-      "san_jose|CA": "95113",
-      "seattle|WA": "98101"
     };
   }
 });
@@ -15377,7 +15498,7 @@ function formatFacebookAdSearch(raw, input) {
   const d = parsed.data;
   const advertisers = d.results ?? d.advertisers ?? [];
   const rows = advertisers.map(
-    (a, i) => `| ${i + 1} | ${cell(a.name)} | ${a.adCount ?? "\u2014"} | \`${a.libraryId ?? "\u2014"}\` |`
+    (a, i) => `| ${i + 1} | ${cell(a.pageName ?? a.name)} | ${a.adCount ?? "\u2014"} | \`${a.sampleLibraryId ?? a.libraryId ?? "\u2014"}\` |`
   ).join("\n");
   const full = [
     `# Facebook Ad Library Search: "${input.query}"`,