mcp-scraper 0.1.8 → 0.2.0

package/dist/bin/api-server.cjs

@@ -3530,8 +3530,8 @@ var init_url_utils = __esm({
 async function fetchWithKernel(url) {
   const apiKey = browserServiceApiKey();
   if (!apiKey) throw new Error("Browser backend API key not set");
-  const client = new import_sdk.default({ apiKey });
-  const kb = await client.browsers.create({ stealth: true, timeout_seconds: 60 });
+  const client2 = new import_sdk.default({ apiKey });
+  const kb = await client2.browsers.create({ stealth: true, timeout_seconds: 60 });
   const browser = await import_playwright.chromium.connectOverCDP(kb.cdp_ws_url);
   try {
     const context = browser.contexts()[0] ?? await browser.newContext({
@@ -3544,7 +3544,7 @@ async function fetchWithKernel(url) {
   } finally {
     await browser.close().catch(() => {
     });
-    await client.browsers.deleteByID(kb.session_id).catch(() => {
+    await client2.browsers.deleteByID(kb.session_id).catch(() => {
     });
   }
 }
@@ -4343,8 +4343,8 @@ async function downloadAsset(url, destDir, filename) {
   }
   const writer = (0, import_node_fs.createWriteStream)(dest);
   await (0, import_promises2.pipeline)(import_node_stream.Readable.fromWeb(res.body), writer);
-  const { statSync } = await import("fs");
-  const sizeBytes = statSync(dest).size;
+  const { statSync: statSync2 } = await import("fs");
+  const sizeBytes = statSync2(dest).size;
   return { savedPath: dest, sizeBytes, mimeType };
 }
 async function harvestPageMedia(html, pageUrl, options = {}) {
@@ -8292,6 +8292,9 @@ var init_site_audit_routes = __esm({
 });
 
 // src/api/rates.ts
+function browserActiveCostMc(activeMs) {
+  return Math.round(activeMs * MC_PER_BROWSER_MS);
+}
 function mcToCredits(mc) {
   return mc / MC_PER_CREDIT;
 }
@@ -8308,7 +8311,7 @@ function insufficientBalanceResponse(balanceMc, requiredMc) {
     topup_url: topupUrl
   };
 }
-var MC_COSTS, MC_PER_CREDIT, CREDIT_COST_CATALOG, CONCURRENCY_PRICE_ID, FREE_SIGNUP_MC, FREE_MONTHLY_REFRESH_MC, BALANCE_PRICE_IDS, BALANCE_PACK_LABELS, LedgerOperation;
+var MC_COSTS, MC_PER_BROWSER_MS, BROWSER_OPEN_MIN_BALANCE_MC, MC_PER_CREDIT, CREDIT_COST_CATALOG, CONCURRENCY_PRICE_ID, FREE_SIGNUP_MC, FREE_MONTHLY_REFRESH_MC, BALANCE_PRICE_IDS, BALANCE_PACK_LABELS, LedgerOperation;
 var init_rates = __esm({
   "src/api/rates.ts"() {
     "use strict";
@@ -8324,8 +8327,11 @@ var init_rates = __esm({
       maps_place: 2e3,
       maps_review: 50,
       fb_search: 50,
-      fb_transcribe: 50
+      fb_transcribe: 50,
+      browser_minute: 4e3
     };
+    MC_PER_BROWSER_MS = MC_COSTS.browser_minute / 6e4;
+    BROWSER_OPEN_MIN_BALANCE_MC = 1e3;
     MC_PER_CREDIT = 1e3;
     CREDIT_COST_CATALOG = [
       {
@@ -8421,6 +8427,14 @@ var init_rates = __esm({
         credits: mcToCredits(MC_COSTS.fb_transcribe),
         unit: "per call",
         notes: "Whisper transcription of Facebook ad video via fal.ai."
+      },
+      {
+        key: "browser_minute",
+        label: "Interactive browser session",
+        aliases: ["browser_open", "browser agent", "browser_agent", "live browser", "browse", "browser control", "interactive browser"],
+        credits: mcToCredits(MC_COSTS.browser_minute),
+        unit: "per minute of active time",
+        notes: "Metered per second of active browser work (navigation, clicks, typing, screenshots). Idle and standby time are free. Billed against your balance as you act; close the session to stop the meter."
       }
     ];
     CONCURRENCY_PRICE_ID = "price_1Ta1NRS8aAcsk3TGwsRnYbix";
@@ -8466,7 +8480,8 @@ var init_rates = __esm({
       FB_SEARCH: "fb_search",
       FB_TRANSCRIBE: "fb_transcribe",
       FB_SEARCH_REFUND: "fb_search_refund",
-      FB_TRANSCRIBE_REFUND: "fb_transcribe_refund"
+      FB_TRANSCRIBE_REFUND: "fb_transcribe_refund",
+      BROWSER_SESSION: "browser_session"
     };
   }
 });
@@ -9032,19 +9047,19 @@ var init_BrowserDriver = __esm({
         if (this.browser) {
           const b = this.browser;
           const sessionId = this.kernelSessionId;
-          const client = this.kernelClient;
+          const client2 = this.kernelClient;
           this.browser = null;
           this.context = null;
           this.page = null;
           this.kernelSessionId = null;
           this.kernelClient = null;
-          if (client && sessionId) {
+          if (client2 && sessionId) {
             console.info(JSON.stringify({
               event: "kernel_browser_delete_started",
               kernel_session_id: sessionId
             }));
             const deleteSession = withTimeout(
-              client.browsers.deleteByID(sessionId),
+              client2.browsers.deleteByID(sessionId),
               KERNEL_SESSION_DELETE_TIMEOUT_MS,
               `Kernel session ${sessionId} delete`
             );
@@ -10513,13 +10528,13 @@ var init_FacebookAdExtractor = __esm({
         }
         await page.waitForTimeout(1500);
         let prevCount = 0;
-        for (let scroll = 0; scroll < 20; scroll++) {
+        for (let scroll2 = 0; scroll2 < 20; scroll2++) {
           const count = await page.evaluate(() => {
             const bt = document.body ? document.body.innerText ?? "" : "";
             return [...bt.matchAll(/Library ID/g)].length;
           });
           if (count >= maxAds) break;
-          if (count === prevCount && scroll > 0) break;
+          if (count === prevCount && scroll2 > 0) break;
           prevCount = count;
           await page.evaluate(() => {
             if (document.body) window.scrollTo(0, document.body.scrollHeight);
@@ -11663,7 +11678,7 @@ var init_facebook_ad_routes = __esm({
           return c.json(searchResult2);
         }
         await page.waitForTimeout(1500);
-        for (let scroll = 0; scroll < 3; scroll++) {
+        for (let scroll2 = 0; scroll2 < 3; scroll2++) {
           await page.evaluate(() => {
             if (document.body) window.scrollTo(0, document.body.scrollHeight);
           });
@@ -15276,321 +15291,7 @@ var PACKAGE_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    PACKAGE_VERSION = "0.1.8";
-  }
-});
-
-// src/mcp/mcp-tool-schemas.ts
-var import_zod19, HarvestPaaInputSchema, ExtractUrlInputSchema, MapSiteUrlsInputSchema, ExtractSiteInputSchema, YoutubeHarvestInputSchema, YoutubeTranscribeInputSchema, FacebookPageIntelInputSchema, FacebookAdSearchInputSchema, FacebookAdTranscribeInputSchema, MapsPlaceIntelInputSchema, MapsSearchInputSchema, NullableString, MapsSearchOutputSchema, OrganicResultOutput, AiOverviewOutput, EntityIdsOutput, HarvestPaaOutputSchema, SearchSerpOutputSchema, ExtractUrlOutputSchema, ExtractSiteOutputSchema, MapsPlaceIntelOutputSchema, CreditsInfoOutputSchema, MapSiteUrlsOutputSchema, YoutubeHarvestOutputSchema, FacebookAdSearchOutputSchema, FacebookPageIntelOutputSchema, CreditsInfoInputSchema, SearchSerpInputSchema, CaptureSerpSnapshotInputSchema, ScreenshotInputSchema, CaptureSerpPageSnapshotsInputSchema;
-var init_mcp_tool_schemas = __esm({
-  "src/mcp/mcp-tool-schemas.ts"() {
-    "use strict";
-    import_zod19 = require("zod");
-    HarvestPaaInputSchema = {
-      query: import_zod19.z.string().min(1).describe('Core search topic only. If the user says "best hvac company in Denver CO", use query="best hvac company" and location="Denver, CO". Do not include the location in query when it can be separated.'),
-      location: import_zod19.z.string().optional().describe('City, region, or country for geo-targeted results, inferred from the user request when present, e.g. "Denver, CO", "Tokyo, Japan", "London, UK".'),
-      maxQuestions: import_zod19.z.number().int().min(1).max(200).default(30).describe("Number of PAA questions to extract. Default 30. Maximum 200. Use 10 for quick probes, 30 for normal research, 100-200 when the user asks for everything/full/deep research. Larger harvests get a longer server time budget (151-200 questions \u2192 up to 280s). Credits are charged by extracted question; unused request hold is refunded."),
-      gl: import_zod19.z.string().length(2).default("us").describe("Google country code inferred from location or user language. Examples: United States us, United Kingdom gb, Japan jp, Canada ca, Australia au."),
-      hl: import_zod19.z.string().default("en").describe("Google interface/content language inferred from the user request. Use en unless the user asks for another language or locale."),
-      device: import_zod19.z.enum(["desktop", "mobile"]).default("desktop").describe("SERP device context. Use desktop by default; use mobile only when the user asks for mobile rankings."),
-      proxyMode: import_zod19.z.enum(["location", "configured", "none"]).default("location").describe("Proxy targeting mode. Use location by default so city/state searches create or reuse a matching residential proxy. Use configured for the static configured proxy. Use none only for direct-network debugging."),
-      proxyZip: import_zod19.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting. Use only when the user gives a specific ZIP or city-center proxy targeting needs to be forced."),
-      debug: import_zod19.z.boolean().default(false).describe("Include sanitized browser/session/location diagnostics in the response. Use true when debugging localization, CAPTCHA, or proxy behavior.")
-    };
-    ExtractUrlInputSchema = {
-      url: import_zod19.z.string().url().describe("Public http/https URL to extract. Use this when the user provides one specific page URL."),
-      screenshot: import_zod19.z.boolean().default(false).describe("Also capture a full-page screenshot of the URL. Saved to ~/Downloads/mcp-scraper/screenshots/ and returned inline. Use when the user asks to see or capture the page visually."),
-      screenshotDevice: import_zod19.z.enum(["desktop", "mobile"]).default("desktop").describe("Viewport for screenshot. desktop = 1440\xD7900. mobile = 390\xD7844. Default desktop."),
-      extractBranding: import_zod19.z.boolean().default(false).describe("Extract brand colors, fonts, logo, and favicon using a rendered browser session. Returns colorScheme (light/dark), colors (primary/accent/background/text/heading as hex), fonts (heading/body family names), and assets (logo URL, favicon URL). Use when the user asks about brand colors, site theme, or brand assets."),
-      downloadMedia: import_zod19.z.boolean().default(false).describe("Extract and download all page media (images, video, audio) to ~/Downloads/mcp-scraper/media/. Ad networks, tracking pixels, and noise URLs are filtered automatically. Use when the user asks to download or harvest assets from a page."),
-      mediaTypes: import_zod19.z.array(import_zod19.z.enum(["image", "video", "audio"])).default(["image", "video", "audio"]).describe("Which media types to download. Default all three."),
-      allowLocal: import_zod19.z.boolean().default(false).describe("Allow localhost and private-network URLs. For local development only.")
-    };
-    MapSiteUrlsInputSchema = {
-      url: import_zod19.z.string().url().describe("Public website URL or domain to crawl for internal URLs. Use before extract_site when the user asks to audit/map/crawl a site."),
-      maxUrls: import_zod19.z.number().int().min(1).max(500).optional().describe("Maximum URLs to discover. Use 100 for normal maps, higher when the user asks for a full inventory.")
-    };
-    ExtractSiteInputSchema = {
-      url: import_zod19.z.string().url().describe("Public website URL or domain to extract across multiple pages. Use when the user asks for a site audit, website crawl, or full-site content/schema extraction."),
-      maxPages: import_zod19.z.number().int().min(1).max(50).optional().describe("Maximum pages to extract. Use 50 when the user asks for full results or a complete crawl within MCP limits.")
-    };
-    YoutubeHarvestInputSchema = {
-      mode: import_zod19.z.enum(["search", "channel"]).describe("Use search for topic/keyword requests. Use channel when the user provides @handle, channel ID, or channel URL."),
-      query: import_zod19.z.string().optional().describe("Required when mode is search. The YouTube search topic in the user\u2019s words."),
-      channelHandle: import_zod19.z.string().optional().describe("YouTube channel handle, channel ID, or URL. Examples: @mkbhd, UC..., https://youtube.com/@mkbhd."),
-      maxVideos: import_zod19.z.number().int().min(1).max(500).default(50).describe("Number of videos to return. Default 50. Increase when user asks for full channel/history.")
-    };
-    YoutubeTranscribeInputSchema = {
-      videoId: import_zod19.z.string().min(1).describe("YouTube video ID, e.g. dQw4w9WgXcQ")
-    };
-    FacebookPageIntelInputSchema = {
-      pageId: import_zod19.z.string().optional(),
-      libraryId: import_zod19.z.string().optional(),
-      query: import_zod19.z.string().optional().describe("Advertiser or brand name when pageId/libraryId is not known. One of pageId, libraryId, or query is required."),
-      maxAds: import_zod19.z.number().int().min(1).max(200).default(50),
-      country: import_zod19.z.string().length(2).default("US")
-    };
-    FacebookAdSearchInputSchema = {
-      query: import_zod19.z.string().min(1).describe("Advertiser, brand, competitor, niche, or keyword to search in Facebook Ad Library."),
-      country: import_zod19.z.string().length(2).default("US"),
-      maxResults: import_zod19.z.number().int().min(1).max(20).default(10)
-    };
-    FacebookAdTranscribeInputSchema = {
-      videoUrl: import_zod19.z.string().url().describe("Facebook CDN video URL from a facebook_page_intel result")
-    };
-    MapsPlaceIntelInputSchema = {
-      businessName: import_zod19.z.string().min(1).describe('Business name only. If user says "Elite Roofing Denver CO", use businessName="Elite Roofing" and location="Denver, CO".'),
-      location: import_zod19.z.string().min(1).describe('City/region/country where the business should be searched, e.g. "Denver, CO". Infer from the user request when possible.'),
-      gl: import_zod19.z.string().length(2).default("us").describe("Google country code inferred from location."),
-      hl: import_zod19.z.string().length(2).default("en").describe("Language inferred from user request."),
-      includeReviews: import_zod19.z.boolean().default(false).describe("Whether to fetch individual review cards"),
-      maxReviews: import_zod19.z.number().int().min(1).max(500).default(50).describe("Max review cards to return (requires includeReviews: true)")
-    };
-    MapsSearchInputSchema = {
-      query: import_zod19.z.string().min(1).describe('Business category, niche, keyword, or search term. If the user says "roofers in Denver CO", use query="roofers" and location="Denver, CO". Do not put the location here when it can be separated.'),
-      location: import_zod19.z.string().optional().describe('City, region, country, or service area for the Maps search, e.g. "Denver, CO". Infer from the user request when present.'),
-      gl: import_zod19.z.string().length(2).default("us").describe("Google country code inferred from location."),
-      hl: import_zod19.z.string().length(2).default("en").describe("Language inferred from user request."),
-      maxResults: import_zod19.z.number().int().min(1).max(50).default(10).describe("Number of Google Maps business/profile candidates to return. Default 10. Maximum 50. Use 10 unless the user asks for more.")
-    };
-    NullableString = import_zod19.z.string().nullable();
-    MapsSearchOutputSchema = {
-      query: import_zod19.z.string(),
-      location: import_zod19.z.string().nullable(),
-      searchQuery: import_zod19.z.string(),
-      searchUrl: import_zod19.z.string().url(),
-      extractedAt: import_zod19.z.string(),
-      requestedMaxResults: import_zod19.z.number().int().min(1).max(50),
-      resultCount: import_zod19.z.number().int().min(0).max(50),
-      results: import_zod19.z.array(import_zod19.z.object({
-        position: import_zod19.z.number().int().min(1),
-        name: import_zod19.z.string(),
-        placeUrl: import_zod19.z.string().url(),
-        cid: NullableString,
-        cidDecimal: NullableString,
-        rating: NullableString,
-        reviewCount: NullableString,
-        category: NullableString,
-        address: NullableString,
-        websiteUrl: NullableString,
-        directionsUrl: NullableString,
-        metadata: import_zod19.z.array(import_zod19.z.string())
-      })),
-      durationMs: import_zod19.z.number().int().min(0)
-    };
-    OrganicResultOutput = import_zod19.z.object({
-      position: import_zod19.z.number().int(),
-      title: import_zod19.z.string(),
-      url: import_zod19.z.string(),
-      domain: import_zod19.z.string(),
-      snippet: NullableString
-    });
-    AiOverviewOutput = import_zod19.z.object({
-      detected: import_zod19.z.boolean(),
-      text: NullableString
-    }).nullable();
-    EntityIdsOutput = import_zod19.z.object({
-      kgIds: import_zod19.z.array(import_zod19.z.string()),
-      cids: import_zod19.z.array(import_zod19.z.string()),
-      gcids: import_zod19.z.array(import_zod19.z.string())
-    }).nullable();
-    HarvestPaaOutputSchema = {
-      query: import_zod19.z.string(),
-      location: NullableString,
-      questionCount: import_zod19.z.number().int().min(0),
-      completionStatus: NullableString,
-      questions: import_zod19.z.array(import_zod19.z.object({
-        question: import_zod19.z.string(),
-        answer: NullableString,
-        sourceTitle: NullableString,
-        sourceSite: NullableString
-      })),
-      organicResults: import_zod19.z.array(OrganicResultOutput),
-      aiOverview: AiOverviewOutput,
-      entityIds: EntityIdsOutput,
-      durationMs: import_zod19.z.number().min(0).nullable()
-    };
-    SearchSerpOutputSchema = {
-      query: import_zod19.z.string(),
-      location: NullableString,
-      organicResults: import_zod19.z.array(OrganicResultOutput),
-      localPack: import_zod19.z.array(import_zod19.z.object({
-        position: import_zod19.z.number().int(),
-        name: import_zod19.z.string(),
-        rating: NullableString,
-        reviewCount: NullableString,
-        websiteUrl: NullableString
-      })),
-      aiOverview: AiOverviewOutput,
-      entityIds: EntityIdsOutput
-    };
-    ExtractUrlOutputSchema = {
-      url: import_zod19.z.string(),
-      title: NullableString,
-      headings: import_zod19.z.array(import_zod19.z.object({
-        level: import_zod19.z.number().int(),
-        text: import_zod19.z.string()
-      })),
-      schemaBlockCount: import_zod19.z.number().int().min(0),
-      entityName: NullableString,
-      entityTypes: import_zod19.z.array(import_zod19.z.string()),
-      napScore: import_zod19.z.number().nullable(),
-      missingSchemaFields: import_zod19.z.array(import_zod19.z.string()),
-      screenshotSaved: NullableString
-    };
-    ExtractSiteOutputSchema = {
-      url: import_zod19.z.string(),
-      pageCount: import_zod19.z.number().int().min(0),
-      pages: import_zod19.z.array(import_zod19.z.object({
-        url: import_zod19.z.string(),
-        title: NullableString,
-        schemaTypes: import_zod19.z.array(import_zod19.z.string())
-      })),
-      durationMs: import_zod19.z.number().min(0)
-    };
-    MapsPlaceIntelOutputSchema = {
-      name: import_zod19.z.string(),
-      rating: NullableString,
-      reviewCount: NullableString,
-      category: NullableString,
-      address: NullableString,
-      phone: NullableString,
-      website: NullableString,
-      hoursSummary: NullableString,
-      bookingUrl: NullableString,
-      kgmid: NullableString,
-      cidDecimal: NullableString,
-      cidUrl: NullableString,
-      lat: import_zod19.z.number().nullable(),
-      lng: import_zod19.z.number().nullable(),
-      reviewsStatus: import_zod19.z.string(),
-      reviewsCollected: import_zod19.z.number().int().min(0),
-      reviewTopics: import_zod19.z.array(import_zod19.z.object({
-        label: import_zod19.z.string(),
-        count: import_zod19.z.string()
-      }))
-    };
-    CreditsInfoOutputSchema = {
-      balanceCredits: import_zod19.z.number().nullable(),
-      matchedCost: import_zod19.z.object({
-        label: import_zod19.z.string(),
-        credits: import_zod19.z.number(),
-        unit: import_zod19.z.string(),
-        notes: NullableString
-      }).nullable(),
-      costs: import_zod19.z.array(import_zod19.z.object({
-        key: import_zod19.z.string(),
-        label: import_zod19.z.string(),
-        credits: import_zod19.z.number(),
-        unit: import_zod19.z.string(),
-        notes: NullableString
-      })),
-      ledger: import_zod19.z.array(import_zod19.z.object({
-        createdAt: import_zod19.z.string(),
-        operation: import_zod19.z.string(),
-        credits: import_zod19.z.number(),
-        description: NullableString
-      }))
-    };
-    MapSiteUrlsOutputSchema = {
-      startUrl: import_zod19.z.string(),
-      totalFound: import_zod19.z.number().int().min(0),
-      truncated: import_zod19.z.boolean(),
-      okCount: import_zod19.z.number().int().min(0),
-      redirectCount: import_zod19.z.number().int().min(0),
-      brokenCount: import_zod19.z.number().int().min(0),
-      urls: import_zod19.z.array(import_zod19.z.object({
-        url: import_zod19.z.string(),
-        status: import_zod19.z.number().int().nullable()
-      })),
-      durationMs: import_zod19.z.number().min(0)
-    };
-    YoutubeHarvestOutputSchema = {
-      mode: import_zod19.z.string(),
-      videoCount: import_zod19.z.number().int().min(0),
-      channel: import_zod19.z.object({
-        title: NullableString,
-        subscriberCount: NullableString
-      }).nullable(),
-      videos: import_zod19.z.array(import_zod19.z.object({
-        videoId: import_zod19.z.string(),
-        title: import_zod19.z.string(),
-        channelName: NullableString,
-        views: NullableString,
-        duration: NullableString,
-        url: NullableString
-      }))
-    };
-    FacebookAdSearchOutputSchema = {
-      query: import_zod19.z.string(),
-      advertiserCount: import_zod19.z.number().int().min(0),
-      advertisers: import_zod19.z.array(import_zod19.z.object({
-        name: NullableString,
-        adCount: import_zod19.z.number().int().nullable(),
-        libraryId: NullableString
-      }))
-    };
-    FacebookPageIntelOutputSchema = {
-      advertiserName: NullableString,
-      totalAds: import_zod19.z.number().int().min(0),
-      activeCount: import_zod19.z.number().int().min(0),
-      videoCount: import_zod19.z.number().int().min(0),
-      imageCount: import_zod19.z.number().int().min(0),
-      ads: import_zod19.z.array(import_zod19.z.object({
-        libraryId: NullableString,
-        status: NullableString,
-        creativeType: NullableString,
-        headline: NullableString,
-        cta: NullableString,
-        startDate: NullableString,
-        videoUrl: NullableString,
-        variations: import_zod19.z.number().int().nullable()
-      }))
-    };
-    CreditsInfoInputSchema = {
-      item: import_zod19.z.string().optional().describe('Optional tool, action, or feature to look up, e.g. "maps reviews", "extract_url", or "YouTube transcription"'),
-      includeLedger: import_zod19.z.boolean().default(false).describe("Whether to include recent credit ledger entries")
-    };
-    SearchSerpInputSchema = {
-      query: import_zod19.z.string().min(1).describe('Core search topic only. Separate location when possible. If user says "best dentist in Brooklyn NY serp", use query="best dentist" and location="Brooklyn, NY".'),
-      location: import_zod19.z.string().optional().describe("City, region, or country for geo-targeted results, inferred from user request when present."),
-      gl: import_zod19.z.string().length(2).default("us").describe("Google country code inferred from location or user language."),
-      hl: import_zod19.z.string().default("en").describe("Google interface/content language inferred from user request."),
-      device: import_zod19.z.enum(["desktop", "mobile"]).default("desktop").describe("SERP device context. Use desktop by default; use mobile only when the user asks for mobile rankings."),
-      proxyMode: import_zod19.z.enum(["location", "configured", "none"]).default("location").describe("Proxy targeting mode. Use location by default so city/state searches create or reuse a matching residential proxy. Use configured for the static configured proxy. Use none only for direct-network debugging."),
-      proxyZip: import_zod19.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting. Use only when the user gives a specific ZIP or city-center proxy targeting needs to be forced."),
-      debug: import_zod19.z.boolean().default(false).describe("Include sanitized browser/session/location diagnostics in the response. Use true when debugging localization, CAPTCHA, or proxy behavior."),
-      pages: import_zod19.z.number().int().min(1).max(2).default(1).describe("Number of result pages to fetch (1\u20132)")
-    };
-    CaptureSerpSnapshotInputSchema = {
-      query: import_zod19.z.string().min(1).describe("Core search query to capture as a structured SERP Intelligence snapshot. Separate the place into location when the user gives a city, region, country, or ZIP."),
-      location: import_zod19.z.string().optional().describe("City, region, country, or service area used for localized Google results. MCP Scraper records location evidence; UULE alone is not proof of localization."),
-      gl: import_zod19.z.string().length(2).default("us").describe("Google country code inferred from the requested market, e.g. us, gb, ca, au."),
-      hl: import_zod19.z.string().default("en").describe("Google interface/content language inferred from the user request."),
-      device: import_zod19.z.enum(["desktop", "mobile"]).default("desktop").describe("SERP device context. Use mobile only when the user asks for mobile rankings or mobile SERP evidence."),
-      proxyMode: import_zod19.z.enum(["location", "configured", "none"]).default("location").describe("Proxy behavior for capture. Use location for localized residential proxy targeting, configured for the static residential proxy, and none only for direct-network debugging."),
-      proxyZip: import_zod19.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting when a precise city-center or ZIP proxy is needed."),
-      pages: import_zod19.z.number().int().min(1).max(2).default(1).describe("Number of Google result pages to capture. Use 1 normally and 2 only when the user needs deeper ranking evidence."),
-      debug: import_zod19.z.boolean().default(false).describe("Include sanitized browser, proxy, and location diagnostics. Use true when debugging localization, CAPTCHA, proxy selection, or capture reliability."),
-      includePageSnapshots: import_zod19.z.boolean().default(false).describe("Also capture ranking-page snapshots for selected SERP URLs through the same product capture path."),
-      pageSnapshotLimit: import_zod19.z.number().int().min(0).max(10).default(0).describe("Maximum ranking-page snapshots to capture when includePageSnapshots is true. Use 0 when only SERP evidence is needed.")
-    };
-    ScreenshotInputSchema = {
-      url: import_zod19.z.string().url().describe("URL to capture as a full-page screenshot. Use http or https. Pass allowLocal: true to capture localhost or private-network URLs during development."),
-      device: import_zod19.z.enum(["desktop", "mobile"]).default("desktop").describe("Viewport profile. desktop = 1440\xD7900. mobile = 390\xD7844. Use desktop by default; use mobile when the user asks for a mobile view."),
-      allowLocal: import_zod19.z.boolean().default(false).describe("Allow localhost and private-network URLs (127.x, 192.168.x, 10.x, etc.). For local development only \u2014 not for production use.")
-    };
-    CaptureSerpPageSnapshotsInputSchema = {
-      urls: import_zod19.z.array(import_zod19.z.string().url()).min(1).max(25).describe("Public HTTP/HTTPS URLs to capture as SERP Intelligence page snapshots. Do not pass localhost, private IPs, file URLs, or internal admin URLs."),
-      targets: import_zod19.z.array(import_zod19.z.object({
-        url: import_zod19.z.string().url().describe("Public HTTP/HTTPS URL to capture."),
-        sourceKind: import_zod19.z.enum(["organic", "ai_citation", "local_pack_website", "configured_target", "site_subject"]).default("configured_target").describe("Why this page is being captured for SERP Intelligence evidence."),
-        sourcePosition: import_zod19.z.number().int().min(1).optional().describe("Ranking or citation position when the page came from SERP evidence.")
-      }).strict()).min(1).max(25).optional().describe("Structured page snapshot targets. Use this instead of urls when source kind or position should be preserved."),
-      maxConcurrency: import_zod19.z.number().int().min(1).max(5).default(2).describe("Parallel page captures. Use 2 normally; higher values can increase proxy/browser pressure."),
-      timeoutMs: import_zod19.z.number().int().min(1e3).max(6e4).default(15e3).describe("Per-page capture timeout in milliseconds. Increase for slow pages; timeout artifacts are returned as structured capture failures."),
-      debug: import_zod19.z.boolean().default(false).describe("Include sanitized browser/proxy diagnostics for page snapshot debugging. Use true for capture, network, or proxy troubleshooting.")
-    };
+    PACKAGE_VERSION = "0.2.0";
   }
 });
 
@@ -16461,200 +16162,552 @@ var init_mcp_response_formatter = __esm({
   }
 });
 
-// src/mcp/paa-mcp-server.ts
-function liveWebToolAnnotations(title) {
-  return {
-    title,
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: false,
-    openWorldHint: true
-  };
-}
-function buildPaaExtractorMcpServer(executor, options = {}) {
-  const savesReports = options.savesReportsLocally !== false;
-  const reportNote = savesReports ? " Saves a full Markdown report locally." : " Reports are returned inline; no files are saved on this hosted endpoint.";
-  const withReportNote = (description) => `${description}${reportNote}`;
-  const server = new import_mcp.McpServer({ name: "mcp-scraper", version: PACKAGE_VERSION });
-  server.registerTool("harvest_paa", {
-    title: "Google PAA + SERP Harvest",
-    description: withReportNote('Best default tool for Google search research. Extracts People Also Ask questions plus answers/source URLs, organic SERP, local pack when present, entity IDs (CID/GCID/KG MID), and AI Overview. Infer the user language: split topic from location (e.g. "best hvac company in Denver CO" => query "best hvac company", location "Denver, CO", gl "us", hl "en"). Use maxQuestions 30 normally, 100-150 for "full", "deep", "all", or comprehensive research. Credits are charged by extracted question; unused request hold is refunded.'),
-    inputSchema: HarvestPaaInputSchema,
-    outputSchema: HarvestPaaOutputSchema,
-    annotations: liveWebToolAnnotations("Google PAA + SERP Harvest")
-  }, async (input) => formatHarvestPaa(await executor.harvestPaa(input), input));
-  server.registerTool("search_serp", {
-    title: "Google SERP Lookup",
-    description: withReportNote("Fast Google SERP lookup without PAA expansion. Use when the user asks for rankings, organic results, local pack, quick SERP, or positions. Split topic from location and infer gl/hl from the user request."),
-    inputSchema: SearchSerpInputSchema,
-    outputSchema: SearchSerpOutputSchema,
-    annotations: liveWebToolAnnotations("Google SERP Lookup")
-  }, async (input) => formatSearchSerp(await executor.searchSerp(input), input));
-  server.registerTool("extract_url", {
-    title: "Single URL Extract",
-    description: withReportNote("Extract structured data from one public URL: page content as Markdown, heading structure, JSON-LD schema, entity details, NAP score, metadata, and missing schema fields. Use when the user provides a single URL or asks to inspect/scrape one page."),
-    inputSchema: ExtractUrlInputSchema,
-    outputSchema: ExtractUrlOutputSchema,
-    annotations: liveWebToolAnnotations("Single URL Extract")
-  }, async (input) => formatExtractUrl(await executor.extractUrl(input), input));
-  server.registerTool("map_site_urls", {
-    title: "Site URL Map",
-    description: withReportNote("Map/crawl a public website to build a URL inventory with HTTP status codes, broken links, redirects, and site scope. Use before extract_site for audits or when the user asks for a sitemap/URL inventory."),
-    inputSchema: MapSiteUrlsInputSchema,
-    outputSchema: MapSiteUrlsOutputSchema,
-    annotations: liveWebToolAnnotations("Site URL Map")
-  }, async (input) => formatMapSiteUrls(await executor.mapSiteUrls(input), input));
-  server.registerTool("extract_site", {
-    title: "Multi-Page Site Extract",
-    description: withReportNote("Run multi-page extraction across a public website. Returns per-page titles, H1s, metadata, headings, schema/entity data, canonical URLs, and content. Use for website audits, competitor audits, and full-site extraction."),
-    inputSchema: ExtractSiteInputSchema,
-    outputSchema: ExtractSiteOutputSchema,
-    annotations: liveWebToolAnnotations("Multi-Page Site Extract")
-  }, async (input) => formatExtractSite(await executor.extractSite(input), input));
-  server.registerTool("youtube_harvest", {
-    title: "YouTube Video Harvest",
-    description: withReportNote('Harvest YouTube video metadata by search query or channel handle/ID/URL. Use mode "search" for keyword/topic requests and mode "channel" for @handles, channel IDs, or channel URLs. Returns titles, views, dates, durations, URLs, thumbnails, and videoIds for follow-up transcription.'),
-    inputSchema: YoutubeHarvestInputSchema,
-    outputSchema: YoutubeHarvestOutputSchema,
-    annotations: liveWebToolAnnotations("YouTube Video Harvest")
-  }, async (input) => formatYoutubeHarvest(await executor.youtubeHarvest(input), input));
-  server.registerTool("youtube_transcribe", {
-    title: "YouTube Transcription",
-    description: withReportNote("Fetch and transcribe captions from a YouTube video. Returns full transcript, timestamped chunks, and word count. Pass a videoId from youtube_harvest results or infer it from a YouTube URL if the user provided one."),
-    inputSchema: YoutubeTranscribeInputSchema,
-    annotations: liveWebToolAnnotations("YouTube Transcription")
-  }, async (input) => formatYoutubeTranscribe(await executor.youtubeTranscribe(input), input));
-  server.registerTool("facebook_page_intel", {
-    title: "Facebook Advertiser Ad Intel",
-    description: withReportNote("Harvest ads from a Facebook advertiser. Returns ad copy, headlines, CTAs, creative type, status, landing URLs, and video URLs ready for transcription. Accepts pageId, libraryId, or a brand/advertiser name as query. Use after facebook_ad_search when possible."),
-    inputSchema: FacebookPageIntelInputSchema,
-    outputSchema: FacebookPageIntelOutputSchema,
-    annotations: liveWebToolAnnotations("Facebook Advertiser Ad Intel")
-  }, async (input) => formatFacebookPageIntel(await executor.facebookPageIntel(input), input));
-  server.registerTool("facebook_ad_search", {
-    title: "Facebook Ad Library Search",
-    description: withReportNote("Search Facebook Ad Library by brand, advertiser, competitor, niche, or keyword. Returns advertisers with ad counts and library IDs. Use to discover competitors, then pass libraryId to facebook_page_intel."),
-    inputSchema: FacebookAdSearchInputSchema,
-    outputSchema: FacebookAdSearchOutputSchema,
-    annotations: liveWebToolAnnotations("Facebook Ad Library Search")
-  }, async (input) => formatFacebookAdSearch(await executor.facebookAdSearch(input), input));
-  server.registerTool("facebook_ad_transcribe", {
-    title: "Facebook Ad Transcription",
-    description: "Transcribe audio from a Facebook ad video. Returns full transcript and timestamped chunks. Use the videoUrl value from facebook_page_intel results.",
-    inputSchema: FacebookAdTranscribeInputSchema,
-    annotations: liveWebToolAnnotations("Facebook Ad Transcription")
-  }, async (input) => formatFacebookAdTranscribe(await executor.facebookAdTranscribe(input), input));
-  server.registerTool("maps_place_intel", {
-    title: "Google Maps Business Profile Details",
-    description: withReportNote('Extract Google Maps business intelligence for one known/named business: rating, review count, category, address, phone, website, hours, booking URL, review histogram, review topics, about attributes, entity IDs, and optional review cards. Do not use this for category searches, local market prospect lists, or requests for multiple GMB/GBP profiles; use maps_search first for those. Split business name from location (e.g. "Elite Roofing Denver CO" => businessName "Elite Roofing", location "Denver, CO"). Pass includeReviews true when the user asks for reviews/customer pain.'),
-    inputSchema: MapsPlaceIntelInputSchema,
-    outputSchema: MapsPlaceIntelOutputSchema,
-    annotations: liveWebToolAnnotations("Google Maps Business Profile Details")
-  }, async (input) => formatMapsPlaceIntel(await executor.mapsPlaceIntel(input), input));
-  server.registerTool("maps_search", {
-    title: "Google Maps Business Search",
-    description: withReportNote('Search Google Maps for multiple businesses/profiles by category, niche, keyword, or local market. Use this when the user asks for several Google Business Profiles, GMBs, GBPs, leads, prospects, competitors, or "more than the 3-pack." Returns up to 50 candidates with names, place URLs, CIDs when available, ratings, review counts, and profile metadata. Default maxResults is 10; maximum is 50. Use maps_place_intel afterward only when a selected business needs full details and reviews.'),
-    inputSchema: MapsSearchInputSchema,
-    outputSchema: MapsSearchOutputSchema,
-    annotations: liveWebToolAnnotations("Google Maps Business Search")
-  }, async (input) => formatMapsSearch(await executor.mapsSearch(input), input));
-  server.registerTool("credits_info", {
-    title: "MCP Scraper Credits & Costs",
-    description: "Answer questions about MCP Scraper credits: current credit balance, what a specific tool/action costs, the full cost table, and optionally recent credit ledger entries. Does not expose payment methods or credit card information.",
-    inputSchema: CreditsInfoInputSchema,
-    outputSchema: CreditsInfoOutputSchema,
-    annotations: {
-      title: "MCP Scraper Credits & Costs",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false
-    }
-  }, async (input) => formatCreditsInfo(await executor.creditsInfo(input), input));
-  return server;
-}
-var import_mcp;
-var init_paa_mcp_server = __esm({
-  "src/mcp/paa-mcp-server.ts"() {
-    "use strict";
-    import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
-    init_version();
-    init_mcp_tool_schemas();
-    init_mcp_response_formatter();
-  }
-});
-
-// src/mcp/http-mcp-tool-executor.ts
-var HttpMcpToolExecutor;
-var init_http_mcp_tool_executor = __esm({
-  "src/mcp/http-mcp-tool-executor.ts"() {
+// src/mcp/mcp-tool-schemas.ts
+var import_zod19, HarvestPaaInputSchema, ExtractUrlInputSchema, MapSiteUrlsInputSchema, ExtractSiteInputSchema, YoutubeHarvestInputSchema, YoutubeTranscribeInputSchema, FacebookPageIntelInputSchema, FacebookAdSearchInputSchema, FacebookAdTranscribeInputSchema, MapsPlaceIntelInputSchema, MapsSearchInputSchema, NullableString, MapsSearchOutputSchema, OrganicResultOutput, AiOverviewOutput, EntityIdsOutput, HarvestPaaOutputSchema, SearchSerpOutputSchema, ExtractUrlOutputSchema, ExtractSiteOutputSchema, MapsPlaceIntelOutputSchema, CreditsInfoOutputSchema, MapSiteUrlsOutputSchema, YoutubeHarvestOutputSchema, FacebookAdSearchOutputSchema, FacebookPageIntelOutputSchema, CreditsInfoInputSchema, SearchSerpInputSchema, CaptureSerpSnapshotInputSchema, ScreenshotInputSchema, CaptureSerpPageSnapshotsInputSchema;
+var init_mcp_tool_schemas = __esm({
+  "src/mcp/mcp-tool-schemas.ts"() {
     "use strict";
-    init_harvest_timeout();
-    HttpMcpToolExecutor = class {
-      baseUrl;
-      apiKey;
-      timeoutMs;
-      httpTimeoutOverrideMs;
-      serpIntelligenceTimeoutMs;
-      constructor(baseUrl, apiKey) {
-        this.baseUrl = baseUrl.replace(/\/$/, "");
-        this.apiKey = apiKey;
-        const rawOverride = process.env.MCP_SCRAPER_HTTP_TIMEOUT_MS;
-        const parsedOverride = rawOverride === void 0 ? NaN : Number(rawOverride);
-        this.httpTimeoutOverrideMs = Number.isFinite(parsedOverride) && parsedOverride > 0 ? parsedOverride : null;
-        this.timeoutMs = this.httpTimeoutOverrideMs ?? 11e4;
-        const configuredSerpIntelligenceTimeoutMs = Number(process.env.MCP_SCRAPER_SERP_INTELLIGENCE_HTTP_TIMEOUT_MS ?? this.timeoutMs);
-        this.serpIntelligenceTimeoutMs = Number.isFinite(configuredSerpIntelligenceTimeoutMs) && configuredSerpIntelligenceTimeoutMs > 0 ? configuredSerpIntelligenceTimeoutMs : this.timeoutMs;
-      }
-      async call(path6, body, timeoutMs = this.timeoutMs) {
-        try {
-          const res = await fetch(`${this.baseUrl}${path6}`, {
-            method: "POST",
-            headers: {
-              "Content-Type": "application/json",
-              "x-api-key": this.apiKey
-            },
-            body: JSON.stringify(body),
-            signal: AbortSignal.timeout(timeoutMs)
-          });
-          const data = await res.json();
-          if (!res.ok) {
-            return { content: [{ type: "text", text: JSON.stringify(data) }], isError: true };
-          }
-          return { content: [{ type: "text", text: JSON.stringify(data) }] };
-        } catch (err) {
-          const msg = err instanceof Error ? err.message : String(err);
-          if (err instanceof DOMException && err.name === "TimeoutError") {
-            return {
-              content: [{
-                type: "text",
-                text: JSON.stringify({
-                  error: "mcp_request_timeout",
-                  error_type: "timeout",
-                  retryable: true,
-                  path: path6,
-                  timeoutMs,
-                  message: `MCP Scraper request exceeded ${Math.round(timeoutMs / 1e3)}s and was cancelled. Retry with fewer results or use the async API for deep harvests.`
-                })
-              }],
-              isError: true
-            };
-          }
-          return { content: [{ type: "text", text: msg }], isError: true };
-        }
-      }
-      harvestPaa(input) {
-        const timeoutMs = this.httpTimeoutOverrideMs ?? harvestTimeoutBudget(input.maxQuestions ?? 30).clientMs;
-        return this.call("/harvest/sync", input, timeoutMs);
-      }
-      searchSerp(input) {
-        const timeoutMs = this.httpTimeoutOverrideMs ?? harvestTimeoutBudget(0, true).clientMs;
-        return this.call("/harvest/sync", { ...input, serpOnly: true }, timeoutMs);
-      }
-      extractUrl(input) {
-        return this.call("/extract-url", input);
-      }
-      mapSiteUrls(input) {
+    import_zod19 = require("zod");
+    HarvestPaaInputSchema = {
+      query: import_zod19.z.string().min(1).describe('Core search topic only. If the user says "best hvac company in Denver CO", use query="best hvac company" and location="Denver, CO". Do not include the location in query when it can be separated.'),
+      location: import_zod19.z.string().optional().describe('City, region, or country for geo-targeted results, inferred from the user request when present, e.g. "Denver, CO", "Tokyo, Japan", "London, UK".'),
+      maxQuestions: import_zod19.z.number().int().min(1).max(200).default(30).describe("Number of PAA questions to extract. Default 30. Maximum 200. Use 10 for quick probes, 30 for normal research, 100-200 when the user asks for everything/full/deep research. Larger harvests get a longer server time budget (151-200 questions \u2192 up to 280s). Credits are charged by extracted question; unused request hold is refunded."),
+      gl: import_zod19.z.string().length(2).default("us").describe("Google country code inferred from location or user language. Examples: United States us, United Kingdom gb, Japan jp, Canada ca, Australia au."),
+      hl: import_zod19.z.string().default("en").describe("Google interface/content language inferred from the user request. Use en unless the user asks for another language or locale."),
+      device: import_zod19.z.enum(["desktop", "mobile"]).default("desktop").describe("SERP device context. Use desktop by default; use mobile only when the user asks for mobile rankings."),
+      proxyMode: import_zod19.z.enum(["location", "configured", "none"]).default("location").describe("Proxy targeting mode. Use location by default so city/state searches create or reuse a matching residential proxy. Use configured for the static configured proxy. Use none only for direct-network debugging."),
+      proxyZip: import_zod19.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting. Use only when the user gives a specific ZIP or city-center proxy targeting needs to be forced."),
+      debug: import_zod19.z.boolean().default(false).describe("Include sanitized browser/session/location diagnostics in the response. Use true when debugging localization, CAPTCHA, or proxy behavior.")
+    };
+    ExtractUrlInputSchema = {
+      url: import_zod19.z.string().url().describe("Public http/https URL to extract. Use this when the user provides one specific page URL."),
+      screenshot: import_zod19.z.boolean().default(false).describe("Also capture a full-page screenshot of the URL. Saved to ~/Downloads/mcp-scraper/screenshots/ and returned inline. Use when the user asks to see or capture the page visually."),
+      screenshotDevice: import_zod19.z.enum(["desktop", "mobile"]).default("desktop").describe("Viewport for screenshot. desktop = 1440\xD7900. mobile = 390\xD7844. Default desktop."),
+      extractBranding: import_zod19.z.boolean().default(false).describe("Extract brand colors, fonts, logo, and favicon using a rendered browser session. Returns colorScheme (light/dark), colors (primary/accent/background/text/heading as hex), fonts (heading/body family names), and assets (logo URL, favicon URL). Use when the user asks about brand colors, site theme, or brand assets."),
+      downloadMedia: import_zod19.z.boolean().default(false).describe("Extract and download all page media (images, video, audio) to ~/Downloads/mcp-scraper/media/. Ad networks, tracking pixels, and noise URLs are filtered automatically. Use when the user asks to download or harvest assets from a page."),
+      mediaTypes: import_zod19.z.array(import_zod19.z.enum(["image", "video", "audio"])).default(["image", "video", "audio"]).describe("Which media types to download. Default all three."),
+      allowLocal: import_zod19.z.boolean().default(false).describe("Allow localhost and private-network URLs. For local development only.")
+    };
+    MapSiteUrlsInputSchema = {
+      url: import_zod19.z.string().url().describe("Public website URL or domain to crawl for internal URLs. Use before extract_site when the user asks to audit/map/crawl a site."),
+      maxUrls: import_zod19.z.number().int().min(1).max(500).optional().describe("Maximum URLs to discover. Use 100 for normal maps, higher when the user asks for a full inventory.")
+    };
+    ExtractSiteInputSchema = {
+      url: import_zod19.z.string().url().describe("Public website URL or domain to extract across multiple pages. Use when the user asks for a site audit, website crawl, or full-site content/schema extraction."),
+      maxPages: import_zod19.z.number().int().min(1).max(50).optional().describe("Maximum pages to extract. Use 50 when the user asks for full results or a complete crawl within MCP limits.")
+    };
+    YoutubeHarvestInputSchema = {
+      mode: import_zod19.z.enum(["search", "channel"]).describe("Use search for topic/keyword requests. Use channel when the user provides @handle, channel ID, or channel URL."),
+      query: import_zod19.z.string().optional().describe("Required when mode is search. The YouTube search topic in the user\u2019s words."),
+      channelHandle: import_zod19.z.string().optional().describe("YouTube channel handle, channel ID, or URL. Examples: @mkbhd, UC..., https://youtube.com/@mkbhd."),
+      maxVideos: import_zod19.z.number().int().min(1).max(500).default(50).describe("Number of videos to return. Default 50. Increase when user asks for full channel/history.")
+    };
+    YoutubeTranscribeInputSchema = {
+      videoId: import_zod19.z.string().min(1).describe("YouTube video ID, e.g. dQw4w9WgXcQ")
+    };
+    FacebookPageIntelInputSchema = {
+      pageId: import_zod19.z.string().optional(),
+      libraryId: import_zod19.z.string().optional(),
+      query: import_zod19.z.string().optional().describe("Advertiser or brand name when pageId/libraryId is not known. One of pageId, libraryId, or query is required."),
+      maxAds: import_zod19.z.number().int().min(1).max(200).default(50),
+      country: import_zod19.z.string().length(2).default("US")
+    };
+    FacebookAdSearchInputSchema = {
+      query: import_zod19.z.string().min(1).describe("Advertiser, brand, competitor, niche, or keyword to search in Facebook Ad Library."),
+      country: import_zod19.z.string().length(2).default("US"),
+      maxResults: import_zod19.z.number().int().min(1).max(20).default(10)
+    };
+    FacebookAdTranscribeInputSchema = {
+      videoUrl: import_zod19.z.string().url().describe("Facebook CDN video URL from a facebook_page_intel result")
+    };
+    MapsPlaceIntelInputSchema = {
+      businessName: import_zod19.z.string().min(1).describe('Business name only. If user says "Elite Roofing Denver CO", use businessName="Elite Roofing" and location="Denver, CO".'),
+      location: import_zod19.z.string().min(1).describe('City/region/country where the business should be searched, e.g. "Denver, CO". Infer from the user request when possible.'),
+      gl: import_zod19.z.string().length(2).default("us").describe("Google country code inferred from location."),
+      hl: import_zod19.z.string().length(2).default("en").describe("Language inferred from user request."),
+      includeReviews: import_zod19.z.boolean().default(false).describe("Whether to fetch individual review cards"),
+      maxReviews: import_zod19.z.number().int().min(1).max(500).default(50).describe("Max review cards to return (requires includeReviews: true)")
+    };
+    MapsSearchInputSchema = {
+      query: import_zod19.z.string().min(1).describe('Business category, niche, keyword, or search term. If the user says "roofers in Denver CO", use query="roofers" and location="Denver, CO". Do not put the location here when it can be separated.'),
+      location: import_zod19.z.string().optional().describe('City, region, country, or service area for the Maps search, e.g. "Denver, CO". Infer from the user request when present.'),
+      gl: import_zod19.z.string().length(2).default("us").describe("Google country code inferred from location."),
+      hl: import_zod19.z.string().length(2).default("en").describe("Language inferred from user request."),
+      maxResults: import_zod19.z.number().int().min(1).max(50).default(10).describe("Number of Google Maps business/profile candidates to return. Default 10. Maximum 50. Use 10 unless the user asks for more.")
+    };
+    NullableString = import_zod19.z.string().nullable();
+    MapsSearchOutputSchema = {
+      query: import_zod19.z.string(),
+      location: import_zod19.z.string().nullable(),
+      searchQuery: import_zod19.z.string(),
+      searchUrl: import_zod19.z.string().url(),
+      extractedAt: import_zod19.z.string(),
+      requestedMaxResults: import_zod19.z.number().int().min(1).max(50),
+      resultCount: import_zod19.z.number().int().min(0).max(50),
+      results: import_zod19.z.array(import_zod19.z.object({
+        position: import_zod19.z.number().int().min(1),
+        name: import_zod19.z.string(),
+        placeUrl: import_zod19.z.string().url(),
+        cid: NullableString,
+        cidDecimal: NullableString,
+        rating: NullableString,
+        reviewCount: NullableString,
+        category: NullableString,
+        address: NullableString,
+        websiteUrl: NullableString,
+        directionsUrl: NullableString,
+        metadata: import_zod19.z.array(import_zod19.z.string())
+      })),
+      durationMs: import_zod19.z.number().int().min(0)
+    };
+    OrganicResultOutput = import_zod19.z.object({
+      position: import_zod19.z.number().int(),
+      title: import_zod19.z.string(),
+      url: import_zod19.z.string(),
+      domain: import_zod19.z.string(),
+      snippet: NullableString
+    });
+    AiOverviewOutput = import_zod19.z.object({
+      detected: import_zod19.z.boolean(),
+      text: NullableString
+    }).nullable();
+    EntityIdsOutput = import_zod19.z.object({
+      kgIds: import_zod19.z.array(import_zod19.z.string()),
+      cids: import_zod19.z.array(import_zod19.z.string()),
+      gcids: import_zod19.z.array(import_zod19.z.string())
+    }).nullable();
+    HarvestPaaOutputSchema = {
+      query: import_zod19.z.string(),
+      location: NullableString,
+      questionCount: import_zod19.z.number().int().min(0),
+      completionStatus: NullableString,
+      questions: import_zod19.z.array(import_zod19.z.object({
+        question: import_zod19.z.string(),
+        answer: NullableString,
+        sourceTitle: NullableString,
+        sourceSite: NullableString
+      })),
+      organicResults: import_zod19.z.array(OrganicResultOutput),
+      aiOverview: AiOverviewOutput,
+      entityIds: EntityIdsOutput,
+      durationMs: import_zod19.z.number().min(0).nullable()
+    };
+    SearchSerpOutputSchema = {
+      query: import_zod19.z.string(),
+      location: NullableString,
+      organicResults: import_zod19.z.array(OrganicResultOutput),
+      localPack: import_zod19.z.array(import_zod19.z.object({
+        position: import_zod19.z.number().int(),
+        name: import_zod19.z.string(),
+        rating: NullableString,
+        reviewCount: NullableString,
+        websiteUrl: NullableString
+      })),
+      aiOverview: AiOverviewOutput,
+      entityIds: EntityIdsOutput
+    };
+    ExtractUrlOutputSchema = {
+      url: import_zod19.z.string(),
+      title: NullableString,
+      headings: import_zod19.z.array(import_zod19.z.object({
+        level: import_zod19.z.number().int(),
+        text: import_zod19.z.string()
+      })),
+      schemaBlockCount: import_zod19.z.number().int().min(0),
+      entityName: NullableString,
+      entityTypes: import_zod19.z.array(import_zod19.z.string()),
+      napScore: import_zod19.z.number().nullable(),
+      missingSchemaFields: import_zod19.z.array(import_zod19.z.string()),
+      screenshotSaved: NullableString
+    };
+    ExtractSiteOutputSchema = {
+      url: import_zod19.z.string(),
+      pageCount: import_zod19.z.number().int().min(0),
+      pages: import_zod19.z.array(import_zod19.z.object({
+        url: import_zod19.z.string(),
+        title: NullableString,
+        schemaTypes: import_zod19.z.array(import_zod19.z.string())
+      })),
+      durationMs: import_zod19.z.number().min(0)
+    };
+    MapsPlaceIntelOutputSchema = {
+      name: import_zod19.z.string(),
+      rating: NullableString,
+      reviewCount: NullableString,
+      category: NullableString,
+      address: NullableString,
+      phone: NullableString,
+      website: NullableString,
+      hoursSummary: NullableString,
+      bookingUrl: NullableString,
+      kgmid: NullableString,
+      cidDecimal: NullableString,
+      cidUrl: NullableString,
+      lat: import_zod19.z.number().nullable(),
+      lng: import_zod19.z.number().nullable(),
+      reviewsStatus: import_zod19.z.string(),
+      reviewsCollected: import_zod19.z.number().int().min(0),
+      reviewTopics: import_zod19.z.array(import_zod19.z.object({
+        label: import_zod19.z.string(),
+        count: import_zod19.z.string()
+      }))
+    };
+    CreditsInfoOutputSchema = {
+      balanceCredits: import_zod19.z.number().nullable(),
+      matchedCost: import_zod19.z.object({
+        label: import_zod19.z.string(),
+        credits: import_zod19.z.number(),
+        unit: import_zod19.z.string(),
+        notes: NullableString
+      }).nullable(),
+      costs: import_zod19.z.array(import_zod19.z.object({
+        key: import_zod19.z.string(),
+        label: import_zod19.z.string(),
+        credits: import_zod19.z.number(),
+        unit: import_zod19.z.string(),
+        notes: NullableString
+      })),
+      ledger: import_zod19.z.array(import_zod19.z.object({
+        createdAt: import_zod19.z.string(),
+        operation: import_zod19.z.string(),
+        credits: import_zod19.z.number(),
+        description: NullableString
+      }))
+    };
+    MapSiteUrlsOutputSchema = {
+      startUrl: import_zod19.z.string(),
+      totalFound: import_zod19.z.number().int().min(0),
+      truncated: import_zod19.z.boolean(),
+      okCount: import_zod19.z.number().int().min(0),
+      redirectCount: import_zod19.z.number().int().min(0),
+      brokenCount: import_zod19.z.number().int().min(0),
+      urls: import_zod19.z.array(import_zod19.z.object({
+        url: import_zod19.z.string(),
+        status: import_zod19.z.number().int().nullable()
+      })),
+      durationMs: import_zod19.z.number().min(0)
+    };
+    YoutubeHarvestOutputSchema = {
+      mode: import_zod19.z.string(),
+      videoCount: import_zod19.z.number().int().min(0),
+      channel: import_zod19.z.object({
+        title: NullableString,
+        subscriberCount: NullableString
+      }).nullable(),
+      videos: import_zod19.z.array(import_zod19.z.object({
+        videoId: import_zod19.z.string(),
+        title: import_zod19.z.string(),
+        channelName: NullableString,
+        views: NullableString,
+        duration: NullableString,
+        url: NullableString
+      }))
+    };
+    FacebookAdSearchOutputSchema = {
+      query: import_zod19.z.string(),
+      advertiserCount: import_zod19.z.number().int().min(0),
+      advertisers: import_zod19.z.array(import_zod19.z.object({
+        name: NullableString,
+        adCount: import_zod19.z.number().int().nullable(),
+        libraryId: NullableString
+      }))
+    };
+    FacebookPageIntelOutputSchema = {
+      advertiserName: NullableString,
+      totalAds: import_zod19.z.number().int().min(0),
+      activeCount: import_zod19.z.number().int().min(0),
+      videoCount: import_zod19.z.number().int().min(0),
+      imageCount: import_zod19.z.number().int().min(0),
+      ads: import_zod19.z.array(import_zod19.z.object({
+        libraryId: NullableString,
+        status: NullableString,
+        creativeType: NullableString,
+        headline: NullableString,
+        cta: NullableString,
+        startDate: NullableString,
+        videoUrl: NullableString,
+        variations: import_zod19.z.number().int().nullable()
+      }))
+    };
+    CreditsInfoInputSchema = {
+      item: import_zod19.z.string().optional().describe('Optional tool, action, or feature to look up, e.g. "maps reviews", "extract_url", or "YouTube transcription"'),
+      includeLedger: import_zod19.z.boolean().default(false).describe("Whether to include recent credit ledger entries")
+    };
+    SearchSerpInputSchema = {
+      query: import_zod19.z.string().min(1).describe('Core search topic only. Separate location when possible. If user says "best dentist in Brooklyn NY serp", use query="best dentist" and location="Brooklyn, NY".'),
+      location: import_zod19.z.string().optional().describe("City, region, or country for geo-targeted results, inferred from user request when present."),
+      gl: import_zod19.z.string().length(2).default("us").describe("Google country code inferred from location or user language."),
+      hl: import_zod19.z.string().default("en").describe("Google interface/content language inferred from user request."),
+      device: import_zod19.z.enum(["desktop", "mobile"]).default("desktop").describe("SERP device context. Use desktop by default; use mobile only when the user asks for mobile rankings."),
+      proxyMode: import_zod19.z.enum(["location", "configured", "none"]).default("location").describe("Proxy targeting mode. Use location by default so city/state searches create or reuse a matching residential proxy. Use configured for the static configured proxy. Use none only for direct-network debugging."),
+      proxyZip: import_zod19.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting. Use only when the user gives a specific ZIP or city-center proxy targeting needs to be forced."),
+      debug: import_zod19.z.boolean().default(false).describe("Include sanitized browser/session/location diagnostics in the response. Use true when debugging localization, CAPTCHA, or proxy behavior."),
+      pages: import_zod19.z.number().int().min(1).max(2).default(1).describe("Number of result pages to fetch (1\u20132)")
+    };
+    CaptureSerpSnapshotInputSchema = {
+      query: import_zod19.z.string().min(1).describe("Core search query to capture as a structured SERP Intelligence snapshot. Separate the place into location when the user gives a city, region, country, or ZIP."),
+      location: import_zod19.z.string().optional().describe("City, region, country, or service area used for localized Google results. MCP Scraper records location evidence; UULE alone is not proof of localization."),
+      gl: import_zod19.z.string().length(2).default("us").describe("Google country code inferred from the requested market, e.g. us, gb, ca, au."),
+      hl: import_zod19.z.string().default("en").describe("Google interface/content language inferred from the user request."),
+      device: import_zod19.z.enum(["desktop", "mobile"]).default("desktop").describe("SERP device context. Use mobile only when the user asks for mobile rankings or mobile SERP evidence."),
+      proxyMode: import_zod19.z.enum(["location", "configured", "none"]).default("location").describe("Proxy behavior for capture. Use location for localized residential proxy targeting, configured for the static residential proxy, and none only for direct-network debugging."),
+      proxyZip: import_zod19.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting when a precise city-center or ZIP proxy is needed."),
+      pages: import_zod19.z.number().int().min(1).max(2).default(1).describe("Number of Google result pages to capture. Use 1 normally and 2 only when the user needs deeper ranking evidence."),
+      debug: import_zod19.z.boolean().default(false).describe("Include sanitized browser, proxy, and location diagnostics. Use true when debugging localization, CAPTCHA, proxy selection, or capture reliability."),
+      includePageSnapshots: import_zod19.z.boolean().default(false).describe("Also capture ranking-page snapshots for selected SERP URLs through the same product capture path."),
+      pageSnapshotLimit: import_zod19.z.number().int().min(0).max(10).default(0).describe("Maximum ranking-page snapshots to capture when includePageSnapshots is true. Use 0 when only SERP evidence is needed.")
+    };
+    ScreenshotInputSchema = {
+      url: import_zod19.z.string().url().describe("URL to capture as a full-page screenshot. Use http or https. Pass allowLocal: true to capture localhost or private-network URLs during development."),
+      device: import_zod19.z.enum(["desktop", "mobile"]).default("desktop").describe("Viewport profile. desktop = 1440\xD7900. mobile = 390\xD7844. Use desktop by default; use mobile when the user asks for a mobile view."),
+      allowLocal: import_zod19.z.boolean().default(false).describe("Allow localhost and private-network URLs (127.x, 192.168.x, 10.x, etc.). For local development only \u2014 not for production use.")
+    };
+    CaptureSerpPageSnapshotsInputSchema = {
+      urls: import_zod19.z.array(import_zod19.z.string().url()).min(1).max(25).describe("Public HTTP/HTTPS URLs to capture as SERP Intelligence page snapshots. Do not pass localhost, private IPs, file URLs, or internal admin URLs."),
+      targets: import_zod19.z.array(import_zod19.z.object({
+        url: import_zod19.z.string().url().describe("Public HTTP/HTTPS URL to capture."),
+        sourceKind: import_zod19.z.enum(["organic", "ai_citation", "local_pack_website", "configured_target", "site_subject"]).default("configured_target").describe("Why this page is being captured for SERP Intelligence evidence."),
+        sourcePosition: import_zod19.z.number().int().min(1).optional().describe("Ranking or citation position when the page came from SERP evidence.")
+      }).strict()).min(1).max(25).optional().describe("Structured page snapshot targets. Use this instead of urls when source kind or position should be preserved."),
+      maxConcurrency: import_zod19.z.number().int().min(1).max(5).default(2).describe("Parallel page captures. Use 2 normally; higher values can increase proxy/browser pressure."),
+      timeoutMs: import_zod19.z.number().int().min(1e3).max(6e4).default(15e3).describe("Per-page capture timeout in milliseconds. Increase for slow pages; timeout artifacts are returned as structured capture failures."),
+      debug: import_zod19.z.boolean().default(false).describe("Include sanitized browser/proxy diagnostics for page snapshot debugging. Use true for capture, network, or proxy troubleshooting.")
+    };
+  }
+});
+
+// src/mcp/paa-mcp-server.ts
+function liveWebToolAnnotations(title) {
+  return {
+    title,
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: false,
+    openWorldHint: true
+  };
+}
+function listSavedReports() {
+  try {
+    const dir = outputBaseDir();
+    return (0, import_node_fs5.readdirSync)(dir).filter((f) => f.endsWith(".md")).map((f) => ({ filename: f, mtimeMs: (0, import_node_fs5.statSync)((0, import_node_path7.join)(dir, f)).mtimeMs })).sort((a, b) => b.mtimeMs - a.mtimeMs).slice(0, 100);
+  } catch {
+    return [];
+  }
+}
+function registerSavedReportResources(server) {
+  server.registerResource(
+    "saved-report",
+    new import_mcp.ResourceTemplate("report://{filename}", {
+      list: () => ({
+        resources: listSavedReports().map((r) => ({
+          uri: `report://${encodeURIComponent(r.filename)}`,
+          name: r.filename,
+          mimeType: "text/markdown"
+        }))
+      })
+    }),
+    {
+      title: "Saved MCP Scraper Reports",
+      description: "Markdown research reports saved by previous MCP Scraper tool calls. Read a report to reuse prior research without re-scraping or spending credits.",
+      mimeType: "text/markdown"
+    },
+    async (uri, variables) => {
+      const requested = Array.isArray(variables.filename) ? variables.filename[0] : variables.filename;
+      const filename = (0, import_node_path7.basename)(decodeURIComponent(String(requested ?? "")));
+      if (!filename.endsWith(".md")) throw new Error("Only saved .md reports can be read");
+      const text = (0, import_node_fs5.readFileSync)((0, import_node_path7.join)(outputBaseDir(), filename), "utf8");
+      return { contents: [{ uri: uri.href, mimeType: "text/markdown", text }] };
+    }
+  );
+}
+function buildPaaExtractorMcpServer(executor, options = {}) {
+  const savesReports = options.savesReportsLocally !== false;
+  const reportNote = savesReports ? " Saves a full Markdown report locally." : " Reports are returned inline; no files are saved on this hosted endpoint.";
+  const withReportNote = (description) => `${description}${reportNote}`;
+  const server = new import_mcp.McpServer({ name: "mcp-scraper", version: PACKAGE_VERSION });
+  if (savesReports) registerSavedReportResources(server);
+  server.registerTool("harvest_paa", {
+    title: "Google PAA + SERP Harvest",
+    description: withReportNote('Best default tool for Google search research. Extracts People Also Ask questions plus answers/source URLs, organic SERP, local pack when present, entity IDs (CID/GCID/KG MID), and AI Overview. Infer the user language: split topic from location (e.g. "best hvac company in Denver CO" => query "best hvac company", location "Denver, CO", gl "us", hl "en"). Use maxQuestions 30 normally, 100-200 for "full", "deep", "all", or comprehensive research. Deep harvests above 100 questions can run for several minutes with no interim progress \u2014 warn the user before starting one and keep maxQuestions at or below 100 unless they explicitly want a deep harvest. Credits are charged by extracted question; unused request hold is refunded.'),
+    inputSchema: HarvestPaaInputSchema,
+    outputSchema: HarvestPaaOutputSchema,
+    annotations: liveWebToolAnnotations("Google PAA + SERP Harvest")
+  }, async (input) => formatHarvestPaa(await executor.harvestPaa(input), input));
+  server.registerTool("search_serp", {
+    title: "Google SERP Lookup",
+    description: withReportNote("Fast Google SERP lookup without PAA expansion. Use when the user asks for rankings, organic results, local pack, quick SERP, or positions. Split topic from location and infer gl/hl from the user request."),
+    inputSchema: SearchSerpInputSchema,
+    outputSchema: SearchSerpOutputSchema,
+    annotations: liveWebToolAnnotations("Google SERP Lookup")
+  }, async (input) => formatSearchSerp(await executor.searchSerp(input), input));
+  server.registerTool("extract_url", {
+    title: "Single URL Extract",
+    description: withReportNote("Extract structured data from one public URL: page content as Markdown, heading structure, JSON-LD schema, entity details, NAP score, metadata, and missing schema fields. Use when the user provides a single URL or asks to inspect/scrape one page."),
+    inputSchema: ExtractUrlInputSchema,
+    outputSchema: ExtractUrlOutputSchema,
+    annotations: liveWebToolAnnotations("Single URL Extract")
+  }, async (input) => formatExtractUrl(await executor.extractUrl(input), input));
+  server.registerTool("map_site_urls", {
+    title: "Site URL Map",
+    description: withReportNote("Map/crawl a public website to build a URL inventory with HTTP status codes, broken links, redirects, and site scope. Use before extract_site for audits or when the user asks for a sitemap/URL inventory."),
+    inputSchema: MapSiteUrlsInputSchema,
+    outputSchema: MapSiteUrlsOutputSchema,
+    annotations: liveWebToolAnnotations("Site URL Map")
+  }, async (input) => formatMapSiteUrls(await executor.mapSiteUrls(input), input));
+  server.registerTool("extract_site", {
+    title: "Multi-Page Site Extract",
+    description: withReportNote("Run multi-page extraction across a public website. Returns per-page titles, H1s, metadata, headings, schema/entity data, canonical URLs, and content. Use for website audits, competitor audits, and full-site extraction."),
+    inputSchema: ExtractSiteInputSchema,
+    outputSchema: ExtractSiteOutputSchema,
+    annotations: liveWebToolAnnotations("Multi-Page Site Extract")
+  }, async (input) => formatExtractSite(await executor.extractSite(input), input));
+  server.registerTool("youtube_harvest", {
+    title: "YouTube Video Harvest",
+    description: withReportNote('Harvest YouTube video metadata by search query or channel handle/ID/URL. Use mode "search" for keyword/topic requests and mode "channel" for @handles, channel IDs, or channel URLs. Returns titles, views, dates, durations, URLs, thumbnails, and videoIds for follow-up transcription.'),
+    inputSchema: YoutubeHarvestInputSchema,
+    outputSchema: YoutubeHarvestOutputSchema,
+    annotations: liveWebToolAnnotations("YouTube Video Harvest")
+  }, async (input) => formatYoutubeHarvest(await executor.youtubeHarvest(input), input));
+  server.registerTool("youtube_transcribe", {
+    title: "YouTube Transcription",
+    description: withReportNote("Fetch and transcribe captions from a YouTube video. Returns full transcript, timestamped chunks, and word count. Pass a videoId from youtube_harvest results or infer it from a YouTube URL if the user provided one."),
+    inputSchema: YoutubeTranscribeInputSchema,
+    annotations: liveWebToolAnnotations("YouTube Transcription")
+  }, async (input) => formatYoutubeTranscribe(await executor.youtubeTranscribe(input), input));
+  server.registerTool("facebook_page_intel", {
+    title: "Facebook Advertiser Ad Intel",
+    description: withReportNote("Harvest ads from a Facebook advertiser. Returns ad copy, headlines, CTAs, creative type, status, landing URLs, and video URLs ready for transcription. Accepts pageId, libraryId, or a brand/advertiser name as query. Use after facebook_ad_search when possible."),
+    inputSchema: FacebookPageIntelInputSchema,
+    outputSchema: FacebookPageIntelOutputSchema,
+    annotations: liveWebToolAnnotations("Facebook Advertiser Ad Intel")
+  }, async (input) => formatFacebookPageIntel(await executor.facebookPageIntel(input), input));
+  server.registerTool("facebook_ad_search", {
+    title: "Facebook Ad Library Search",
+    description: withReportNote("Search Facebook Ad Library by brand, advertiser, competitor, niche, or keyword. Returns advertisers with ad counts and library IDs. Use to discover competitors, then pass libraryId to facebook_page_intel."),
+    inputSchema: FacebookAdSearchInputSchema,
+    outputSchema: FacebookAdSearchOutputSchema,
+    annotations: liveWebToolAnnotations("Facebook Ad Library Search")
+  }, async (input) => formatFacebookAdSearch(await executor.facebookAdSearch(input), input));
+  server.registerTool("facebook_ad_transcribe", {
+    title: "Facebook Ad Transcription",
+    description: "Transcribe audio from a Facebook ad video. Returns full transcript and timestamped chunks. Use the videoUrl value from facebook_page_intel results.",
+    inputSchema: FacebookAdTranscribeInputSchema,
+    annotations: liveWebToolAnnotations("Facebook Ad Transcription")
+  }, async (input) => formatFacebookAdTranscribe(await executor.facebookAdTranscribe(input), input));
+  server.registerTool("maps_place_intel", {
+    title: "Google Maps Business Profile Details",
+    description: withReportNote('Extract Google Maps business intelligence for one known/named business: rating, review count, category, address, phone, website, hours, booking URL, review histogram, review topics, about attributes, entity IDs, and optional review cards. Do not use this for category searches, local market prospect lists, or requests for multiple GMB/GBP profiles; use maps_search first for those. Split business name from location (e.g. "Elite Roofing Denver CO" => businessName "Elite Roofing", location "Denver, CO"). Pass includeReviews true when the user asks for reviews/customer pain.'),
+    inputSchema: MapsPlaceIntelInputSchema,
+    outputSchema: MapsPlaceIntelOutputSchema,
+    annotations: liveWebToolAnnotations("Google Maps Business Profile Details")
+  }, async (input) => formatMapsPlaceIntel(await executor.mapsPlaceIntel(input), input));
+  server.registerTool("maps_search", {
+    title: "Google Maps Business Search",
+    description: withReportNote('Search Google Maps for multiple businesses/profiles by category, niche, keyword, or local market. Use this when the user asks for several Google Business Profiles, GMBs, GBPs, leads, prospects, competitors, or "more than the 3-pack." Returns up to 50 candidates with names, place URLs, CIDs when available, ratings, review counts, and profile metadata. Default maxResults is 10; maximum is 50. Use maps_place_intel afterward only when a selected business needs full details and reviews.'),
+    inputSchema: MapsSearchInputSchema,
+    outputSchema: MapsSearchOutputSchema,
+    annotations: liveWebToolAnnotations("Google Maps Business Search")
+  }, async (input) => formatMapsSearch(await executor.mapsSearch(input), input));
+  server.registerTool("credits_info", {
+    title: "MCP Scraper Credits & Costs",
+    description: "Answer questions about MCP Scraper credits: current credit balance, what a specific tool/action costs, the full cost table, and optionally recent credit ledger entries. Does not expose payment methods or credit card information.",
+    inputSchema: CreditsInfoInputSchema,
+    outputSchema: CreditsInfoOutputSchema,
+    annotations: {
+      title: "MCP Scraper Credits & Costs",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    }
+  }, async (input) => formatCreditsInfo(await executor.creditsInfo(input), input));
+  return server;
+}
+var import_mcp, import_node_fs5, import_node_path7;
+var init_paa_mcp_server = __esm({
+  "src/mcp/paa-mcp-server.ts"() {
+    "use strict";
+    import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
+    import_node_fs5 = require("fs");
+    import_node_path7 = require("path");
+    init_version();
+    init_mcp_response_formatter();
+    init_mcp_tool_schemas();
+    init_mcp_response_formatter();
+  }
+});
+
+// src/mcp/http-mcp-tool-executor.ts
+var HttpMcpToolExecutor;
+var init_http_mcp_tool_executor = __esm({
+  "src/mcp/http-mcp-tool-executor.ts"() {
+    "use strict";
+    init_harvest_timeout();
+    HttpMcpToolExecutor = class {
+      baseUrl;
+      apiKey;
+      timeoutMs;
+      httpTimeoutOverrideMs;
+      serpIntelligenceTimeoutMs;
+      constructor(baseUrl, apiKey) {
+        this.baseUrl = baseUrl.replace(/\/$/, "");
+        this.apiKey = apiKey;
+        const rawOverride = process.env.MCP_SCRAPER_HTTP_TIMEOUT_MS;
+        const parsedOverride = rawOverride === void 0 ? NaN : Number(rawOverride);
+        this.httpTimeoutOverrideMs = Number.isFinite(parsedOverride) && parsedOverride > 0 ? parsedOverride : null;
+        this.timeoutMs = this.httpTimeoutOverrideMs ?? 11e4;
+        const configuredSerpIntelligenceTimeoutMs = Number(process.env.MCP_SCRAPER_SERP_INTELLIGENCE_HTTP_TIMEOUT_MS ?? this.timeoutMs);
+        this.serpIntelligenceTimeoutMs = Number.isFinite(configuredSerpIntelligenceTimeoutMs) && configuredSerpIntelligenceTimeoutMs > 0 ? configuredSerpIntelligenceTimeoutMs : this.timeoutMs;
+      }
+      async call(path6, body, timeoutMs = this.timeoutMs) {
+        try {
+          const res = await fetch(`${this.baseUrl}${path6}`, {
+            method: "POST",
+            headers: {
+              "Content-Type": "application/json",
+              "x-api-key": this.apiKey
+            },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(timeoutMs)
+          });
+          const data = await res.json();
+          if (!res.ok) {
+            return { content: [{ type: "text", text: JSON.stringify(data) }], isError: true };
+          }
+          return { content: [{ type: "text", text: JSON.stringify(data) }] };
+        } catch (err) {
+          const msg = err instanceof Error ? err.message : String(err);
+          if (err instanceof DOMException && err.name === "TimeoutError") {
+            return {
+              content: [{
+                type: "text",
+                text: JSON.stringify({
+                  error: "mcp_request_timeout",
+                  error_type: "timeout",
+                  retryable: true,
+                  path: path6,
+                  timeoutMs,
+                  message: `MCP Scraper request exceeded ${Math.round(timeoutMs / 1e3)}s and was cancelled. Retry with fewer results or use the async API for deep harvests.`
+                })
+              }],
+              isError: true
+            };
+          }
+          return { content: [{ type: "text", text: msg }], isError: true };
+        }
+      }
+      harvestPaa(input) {
+        const timeoutMs = this.httpTimeoutOverrideMs ?? harvestTimeoutBudget(input.maxQuestions ?? 30).clientMs;
+        return this.call("/harvest/sync", input, timeoutMs);
+      }
+      searchSerp(input) {
+        const timeoutMs = this.httpTimeoutOverrideMs ?? harvestTimeoutBudget(0, true).clientMs;
+        return this.call("/harvest/sync", { ...input, serpOnly: true }, timeoutMs);
+      }
+      extractUrl(input) {
+        return this.call("/extract-url", input);
+      }
+      mapSiteUrls(input) {
         return this.call("/map-urls", input);
       }
       extractSite(input) {
@@ -16706,7 +16759,10 @@ function mcpAuthError() {
   });
   return new Response(body, {
     status: 401,
-    headers: { "Content-Type": "application/json" }
+    headers: {
+      "Content-Type": "application/json",
+      "WWW-Authenticate": 'Bearer realm="mcp-scraper", error="invalid_token", error_description="Pass an MCP Scraper API key as x-api-key or Bearer token"'
+    }
   });
 }
 async function requireMcpCallerKey(c) {
@@ -16768,17 +16824,802 @@ var init_mcp_routes = __esm({
   }
 });
 
+// src/api/browser-agent-db.ts
+async function migrateBrowserAgent() {
+  if (_ready) return;
+  const db = getDb();
+  await db.execute(`
+    CREATE TABLE IF NOT EXISTS browser_agent_sessions (
+      id                  TEXT PRIMARY KEY,
+      runtime_session_id  TEXT NOT NULL,
+      live_view_url       TEXT,
+      cdp_ws_url          TEXT NOT NULL,
+      status              TEXT NOT NULL DEFAULT 'open',
+      label               TEXT,
+      user_id             INTEGER,
+      created_at          TEXT NOT NULL DEFAULT (datetime('now')),
+      closed_at           TEXT,
+      last_action_at      TEXT,
+      active_ms           INTEGER NOT NULL DEFAULT 0,
+      billed_mc           INTEGER NOT NULL DEFAULT 0
+    )
+  `);
+  await db.execute(`CREATE INDEX IF NOT EXISTS browser_agent_sessions_status ON browser_agent_sessions(status)`);
+  await db.execute(`CREATE INDEX IF NOT EXISTS browser_agent_sessions_user ON browser_agent_sessions(user_id)`);
+  await db.execute(`
+    CREATE TABLE IF NOT EXISTS browser_agent_actions (
+      id          TEXT PRIMARY KEY,
+      session_id  TEXT NOT NULL,
+      type        TEXT NOT NULL,
+      params_json TEXT,
+      ok          INTEGER NOT NULL DEFAULT 1,
+      error       TEXT,
+      created_at  TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+  await db.execute(`CREATE INDEX IF NOT EXISTS browser_agent_actions_session ON browser_agent_actions(session_id)`);
+  await db.execute(`
+    CREATE TABLE IF NOT EXISTS browser_agent_replays (
+      replay_id  TEXT PRIMARY KEY,
+      session_id TEXT NOT NULL,
+      view_url   TEXT,
+      label      TEXT,
+      started_at TEXT NOT NULL DEFAULT (datetime('now')),
+      stopped_at TEXT
+    )
+  `);
+  await db.execute(`CREATE INDEX IF NOT EXISTS browser_agent_replays_session ON browser_agent_replays(session_id)`);
+  _ready = true;
+}
+async function createSessionRow(input) {
+  const db = getDb();
+  const id = `bas_${(0, import_node_crypto3.randomUUID)().replace(/-/g, "").slice(0, 20)}`;
+  await db.execute({
+    sql: `INSERT INTO browser_agent_sessions (id, runtime_session_id, live_view_url, cdp_ws_url, status, label, user_id, last_action_at)
+          VALUES (?, ?, ?, ?, 'open', ?, ?, datetime('now'))`,
+    args: [id, input.runtimeSessionId, input.liveViewUrl, input.cdpWsUrl, input.label, input.userId]
+  });
+  const row = await getSessionRow(id);
+  if (!row) throw new Error("session insert failed");
+  return row;
+}
+async function getSessionRow(id) {
+  const db = getDb();
+  const res = await db.execute({ sql: `SELECT * FROM browser_agent_sessions WHERE id = ?`, args: [id] });
+  return res.rows[0] ?? null;
+}
+async function listSessionRows(userId, includeClosed = false) {
+  const db = getDb();
+  const clauses = [];
+  const args = [];
+  if (userId != null) {
+    clauses.push("(user_id = ? OR user_id IS NULL)");
+    args.push(userId);
+  }
+  if (!includeClosed) clauses.push(`status = 'open'`);
+  const where = clauses.length ? `WHERE ${clauses.join(" AND ")}` : "";
+  const res = await db.execute({
+    sql: `SELECT * FROM browser_agent_sessions ${where} ORDER BY created_at DESC LIMIT 100`,
+    args
+  });
+  return res.rows;
+}
+async function addActiveMs(id, deltaMs) {
+  const db = getDb();
+  await db.execute({
+    sql: `UPDATE browser_agent_sessions SET active_ms = active_ms + ?, last_action_at = datetime('now') WHERE id = ?`,
+    args: [Math.max(0, Math.round(deltaMs)), id]
+  });
+  const res = await db.execute({ sql: `SELECT active_ms, billed_mc FROM browser_agent_sessions WHERE id = ?`, args: [id] });
+  const row = res.rows[0];
+  return { active_ms: Number(row?.active_ms ?? 0), billed_mc: Number(row?.billed_mc ?? 0) };
+}
+async function setBilledMc(id, billedMc) {
+  const db = getDb();
+  await db.execute({
+    sql: `UPDATE browser_agent_sessions SET billed_mc = ? WHERE id = ?`,
+    args: [Math.round(billedMc), id]
+  });
+}
+async function markSessionClosed(id) {
+  const db = getDb();
+  await db.execute({
+    sql: `UPDATE browser_agent_sessions SET status = 'closed', closed_at = datetime('now') WHERE id = ?`,
+    args: [id]
+  });
+}
+async function recordAction(input) {
+  const db = getDb();
+  await db.execute({
+    sql: `INSERT INTO browser_agent_actions (id, session_id, type, params_json, ok, error)
+          VALUES (?, ?, ?, ?, ?, ?)`,
+    args: [
+      `baa_${(0, import_node_crypto3.randomUUID)().replace(/-/g, "").slice(0, 20)}`,
+      input.sessionId,
+      input.type,
+      input.params == null ? null : JSON.stringify(input.params),
+      input.ok ? 1 : 0,
+      input.error ?? null
+    ]
+  });
+}
+async function recordReplayStart(input) {
+  const db = getDb();
+  await db.execute({
+    sql: `INSERT INTO browser_agent_replays (replay_id, session_id, view_url, label)
+          VALUES (?, ?, ?, ?)`,
+    args: [input.replayId, input.sessionId, input.viewUrl, input.label]
+  });
+}
+async function recordReplayStop(replayId, viewUrl) {
+  const db = getDb();
+  await db.execute({
+    sql: `UPDATE browser_agent_replays SET stopped_at = datetime('now'), view_url = COALESCE(?, view_url) WHERE replay_id = ?`,
+    args: [viewUrl, replayId]
+  });
+}
+async function listReplayRows(sessionId) {
+  const db = getDb();
+  const res = await db.execute({
+    sql: `SELECT * FROM browser_agent_replays WHERE session_id = ? ORDER BY started_at DESC`,
+    args: [sessionId]
+  });
+  return res.rows;
+}
+var import_node_crypto3, _ready;
+var init_browser_agent_db = __esm({
+  "src/api/browser-agent-db.ts"() {
+    "use strict";
+    import_node_crypto3 = require("crypto");
+    init_db();
+    _ready = false;
+  }
+});
+
+// src/services/browser-agent/browser-agent-service.ts
+function client() {
+  const apiKey = browserServiceApiKey();
+  if (!apiKey) throw new Error("Browser backend API key is required");
+  return new import_sdk6.default({ apiKey });
+}
+async function createSession(opts = {}) {
+  const k = client();
+  const resolvedProxyId = opts.proxyId ?? browserServiceProxyId();
+  const browser = await k.browsers.create({
+    stealth: opts.stealth ?? true,
+    timeout_seconds: opts.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS,
+    ...resolvedProxyId ? { proxy_id: resolvedProxyId } : {},
+    ...opts.profileName ? { profile: { name: opts.profileName } } : {}
+  });
+  const runtimeSessionId = browser.session_id;
+  if (opts.disableDefaultProxy) {
+    try {
+      await k.browsers.update(runtimeSessionId, { disable_default_proxy: true });
+    } catch {
+    }
+  }
+  if (opts.viewport) {
+    try {
+      await k.browsers.update(runtimeSessionId, { viewport: opts.viewport });
+    } catch {
+    }
+  }
+  return {
+    runtimeSessionId,
+    liveViewUrl: browser.browser_live_view_url ?? null,
+    cdpWsUrl: browser.cdp_ws_url
+  };
+}
+async function closeSession(runtimeSessionId) {
+  const k = client();
+  await k.browsers.deleteByID(runtimeSessionId);
+}
+async function screenshot(runtimeSessionId) {
+  const k = client();
+  const res = await k.browsers.computer.captureScreenshot(runtimeSessionId);
+  const buf = Buffer.from(await res.arrayBuffer());
+  return { base64: buf.toString("base64"), mimeType: "image/png" };
+}
+async function click(runtimeSessionId, x, y, opts = {}) {
+  const k = client();
+  await k.browsers.computer.clickMouse(runtimeSessionId, {
+    x,
+    y,
+    button: opts.button ?? "left",
+    ...opts.numClicks ? { num_clicks: opts.numClicks } : {}
+  });
+}
+async function typeText(runtimeSessionId, text, delayMs) {
+  const k = client();
+  await k.browsers.computer.typeText(runtimeSessionId, {
+    text,
+    ...typeof delayMs === "number" ? { delay: delayMs } : {}
+  });
+}
+async function scroll(runtimeSessionId, x, y, deltaX, deltaY) {
+  const k = client();
+  await k.browsers.computer.scroll(runtimeSessionId, { x, y, delta_x: deltaX, delta_y: deltaY });
+}
+async function pressKeys(runtimeSessionId, keys) {
+  const k = client();
+  await k.browsers.computer.pressKey(runtimeSessionId, { keys });
+}
+async function goto(cdpWsUrl, url) {
+  const browser = await import_playwright4.chromium.connectOverCDP(cdpWsUrl);
+  try {
+    const context = browser.contexts()[0] ?? await browser.newContext();
+    const page = context.pages()[0] ?? await context.newPage();
+    await page.goto(url, { waitUntil: "domcontentloaded", timeout: 45e3 });
+    return { url: page.url(), title: await page.title() };
+  } finally {
+    await browser.close().catch(() => {
+    });
+  }
+}
+async function readPage(cdpWsUrl) {
+  const browser = await import_playwright4.chromium.connectOverCDP(cdpWsUrl);
+  try {
+    const context = browser.contexts()[0] ?? await browser.newContext();
+    const page = context.pages()[0] ?? await context.newPage();
+    const url = page.url();
+    const title = await page.title().catch(() => "");
+    const data = await page.evaluate(() => {
+      const SEL = 'a[href], button, input, textarea, select, [role="button"], [role="link"], [role="tab"], [onclick]';
+      const out = [];
+      const nodes = Array.from(document.querySelectorAll(SEL)).slice(0, 120);
+      for (const el2 of nodes) {
+        const r = el2.getBoundingClientRect();
+        if (r.width < 1 || r.height < 1) continue;
+        if (r.bottom < 0 || r.top > window.innerHeight) continue;
+        const e = el2;
+        const name = (e.getAttribute("aria-label") || e.placeholder || e.innerText || e.getAttribute("value") || e.getAttribute("title") || "").trim().replace(/\s+/g, " ").slice(0, 80);
+        out.push({
+          role: el2.getAttribute("role") || el2.tagName.toLowerCase(),
+          name,
+          x: Math.round(r.left + r.width / 2),
+          y: Math.round(r.top + r.height / 2)
+        });
+      }
+      const text = (document.body?.innerText || "").replace(/\n{3,}/g, "\n\n").trim().slice(0, 6e3);
+      return { text, els: out };
+    });
+    return {
+      url,
+      title,
+      text: data.text,
+      elements: data.els.map((e, i) => ({ ref: i + 1, role: e.role, name: e.name, x: e.x, y: e.y }))
+    };
+  } finally {
+    await browser.close().catch(() => {
+    });
+  }
+}
+async function replayStart(runtimeSessionId) {
+  const k = client();
+  const res = await k.browsers.replays.start(runtimeSessionId);
+  return { replayId: res.replay_id, viewUrl: res.replay_view_url ?? null };
+}
+async function replayStop(runtimeSessionId, replayId) {
+  const k = client();
+  await k.browsers.replays.stop(replayId, { id: runtimeSessionId });
+}
+async function replayList(runtimeSessionId) {
+  const k = client();
+  const res = await k.browsers.replays.list(runtimeSessionId);
+  return res.map((r) => ({
+    replayId: r.replay_id,
+    viewUrl: r.replay_view_url ?? null,
+    startedAt: r.started_at ?? null,
+    finishedAt: r.finished_at ?? null
+  }));
+}
+var import_sdk6, import_playwright4, DEFAULT_TIMEOUT_SECONDS;
+var init_browser_agent_service = __esm({
+  "src/services/browser-agent/browser-agent-service.ts"() {
+    "use strict";
+    import_sdk6 = __toESM(require("@onkernel/sdk"), 1);
+    import_playwright4 = require("playwright");
+    init_browser_service_env();
+    DEFAULT_TIMEOUT_SECONDS = 600;
+  }
+});
+
+// src/api/browser-agent-routes.ts
+async function charge(sessionId, userId, startedAtMs) {
+  const elapsedMs = Date.now() - startedAtMs;
+  const { active_ms, billed_mc } = await addActiveMs(sessionId, elapsedMs);
+  const owed = browserActiveCostMc(active_ms);
+  const delta = owed - billed_mc;
+  if (delta > 0) {
+    const res = await debitMc(userId, delta, LedgerOperation.BROWSER_SESSION, sessionId);
+    if (res.ok) await setBilledMc(sessionId, owed);
+  }
+}
+function publicSession(row) {
+  return {
+    session_id: row.id,
+    status: row.status,
+    label: row.label,
+    created_at: row.created_at,
+    last_action_at: row.last_action_at,
+    closed_at: row.closed_at,
+    active_seconds: Math.round((row.active_ms ?? 0) / 1e3),
+    credits_used: Math.round((row.billed_mc ?? 0) / 10) / 100
+  };
+}
+function failure(err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  return { error: sanitizeVendorName(msg) };
+}
+async function loadOpenSession(id, userId) {
+  const row = await getSessionRow(id);
+  if (!row) return null;
+  if (row.user_id != null && row.user_id !== userId) return null;
+  return row;
+}
+function buildBrowserAgentRoutes() {
+  const app2 = new import_hono8.Hono();
+  app2.use("*", async (c, next) => {
+    await migrateBrowserAgent();
+    return next();
+  });
+  app2.use("*", auth);
+  app2.post("/sessions", async (c) => {
+    const user = c.get("user");
+    if (Number(user.balance_mc ?? 0) < BROWSER_OPEN_MIN_BALANCE_MC) {
+      return c.json(insufficientBalanceResponse(Number(user.balance_mc ?? 0), BROWSER_OPEN_MIN_BALANCE_MC), 402);
+    }
+    const body = await c.req.json().catch(() => ({}));
+    try {
+      const created = await createSession({
+        timeoutSeconds: typeof body.timeout_seconds === "number" ? body.timeout_seconds : void 0,
+        proxyId: typeof body.proxy_id === "string" ? body.proxy_id : void 0,
+        profileName: typeof body.profile === "string" ? body.profile : void 0,
+        disableDefaultProxy: body.disable_default_proxy === true,
+        viewport: body.viewport && typeof body.viewport === "object" ? body.viewport : void 0
+      });
+      const row = await createSessionRow({
+        runtimeSessionId: created.runtimeSessionId,
+        liveViewUrl: created.liveViewUrl,
+        cdpWsUrl: created.cdpWsUrl,
+        label: typeof body.label === "string" ? body.label : null,
+        userId: user.id
+      });
+      return c.json({ ...publicSession(row), watch_url: `/console/${row.id}` });
+    } catch (err) {
+      return c.json(failure(err), 502);
+    }
+  });
+  app2.get("/sessions", async (c) => {
+    const user = c.get("user");
+    const includeClosed = c.req.query("all") === "1";
+    const rows = await listSessionRows(user.id, includeClosed);
+    return c.json({ sessions: rows.map(publicSession) });
+  });
+  app2.get("/sessions/:id", async (c) => {
+    const user = c.get("user");
+    const row = await loadOpenSession(c.req.param("id"), user.id);
+    if (!row) return c.json({ error: "not found" }, 404);
+    return c.json({ ...publicSession(row), watch_url: `/console/${row.id}` });
+  });
+  app2.get("/sessions/:id/live-view", async (c) => {
+    const user = c.get("user");
+    const row = await loadOpenSession(c.req.param("id"), user.id);
+    if (!row) return c.json({ error: "not found" }, 404);
+    return c.json({ live_view_url: row.live_view_url });
+  });
+  app2.delete("/sessions/:id", async (c) => {
+    const user = c.get("user");
+    const row = await loadOpenSession(c.req.param("id"), user.id);
+    if (!row) return c.json({ error: "not found" }, 404);
+    try {
+      await closeSession(row.runtime_session_id);
+    } catch {
+    }
+    await markSessionClosed(row.id);
+    return c.json({ ok: true });
+  });
+  app2.post("/sessions/:id/goto", async (c) => {
+    const user = c.get("user");
+    const row = await loadOpenSession(c.req.param("id"), user.id);
+    if (!row) return c.json({ error: "not found" }, 404);
+    const body = await c.req.json().catch(() => ({}));
+    const url = typeof body.url === "string" ? body.url : "";
+    if (!url) return c.json({ error: "url is required" }, 400);
+    const t0 = Date.now();
+    try {
+      const result = await goto(row.cdp_ws_url, url);
+      await charge(row.id, user.id, t0);
+      await recordAction({ sessionId: row.id, type: "goto", params: { url }, ok: true });
+      return c.json(result);
+    } catch (err) {
+      await charge(row.id, user.id, t0);
+      await recordAction({ sessionId: row.id, type: "goto", params: { url }, ok: false, error: String(err) });
+      return c.json(failure(err), 502);
+    }
+  });
+  app2.post("/sessions/:id/screenshot", async (c) => {
+    const user = c.get("user");
+    const row = await loadOpenSession(c.req.param("id"), user.id);
+    if (!row) return c.json({ error: "not found" }, 404);
+    const t0 = Date.now();
+    try {
+      const shot = await screenshot(row.runtime_session_id);
+      let page = null;
+      try {
+        page = await readPage(row.cdp_ws_url);
+      } catch {
+        page = null;
+      }
+      await charge(row.id, user.id, t0);
+      await recordAction({ sessionId: row.id, type: "screenshot", params: null, ok: true });
+      return c.json({
+        image_base64: shot.base64,
+        mime_type: shot.mimeType,
+        url: page?.url ?? null,
+        title: page?.title ?? null,
+        elements: page?.elements ?? [],
+        text: page?.text ?? null
+      });
+    } catch (err) {
+      await charge(row.id, user.id, t0);
+      await recordAction({ sessionId: row.id, type: "screenshot", params: null, ok: false, error: String(err) });
+      return c.json(failure(err), 502);
+    }
+  });
+  app2.post("/sessions/:id/read", async (c) => {
+    const user = c.get("user");
+    const row = await loadOpenSession(c.req.param("id"), user.id);
+    if (!row) return c.json({ error: "not found" }, 404);
+    const t0 = Date.now();
+    try {
+      const page = await readPage(row.cdp_ws_url);
+      await charge(row.id, user.id, t0);
+      await recordAction({ sessionId: row.id, type: "read", params: null, ok: true });
+      return c.json(page);
+    } catch (err) {
+      await charge(row.id, user.id, t0);
+      return c.json(failure(err), 502);
+    }
+  });
+  app2.post("/sessions/:id/click", async (c) => {
+    const user = c.get("user");
+    const row = await loadOpenSession(c.req.param("id"), user.id);
+    if (!row) return c.json({ error: "not found" }, 404);
+    const body = await c.req.json().catch(() => ({}));
+    const x = Number(body.x);
+    const y = Number(body.y);
+    if (!Number.isFinite(x) || !Number.isFinite(y)) return c.json({ error: "x and y are required" }, 400);
+    const t0 = Date.now();
+    try {
+      await click(row.runtime_session_id, x, y, {
+        button: body.button === "right" || body.button === "middle" ? body.button : "left",
+        numClicks: typeof body.num_clicks === "number" ? body.num_clicks : void 0
+      });
+      await charge(row.id, user.id, t0);
+      await recordAction({ sessionId: row.id, type: "click", params: { x, y }, ok: true });
+      return c.json({ ok: true });
+    } catch (err) {
+      await charge(row.id, user.id, t0);
+      await recordAction({ sessionId: row.id, type: "click", params: { x, y }, ok: false, error: String(err) });
+      return c.json(failure(err), 502);
+    }
+  });
+  app2.post("/sessions/:id/type", async (c) => {
+    const user = c.get("user");
+    const row = await loadOpenSession(c.req.param("id"), user.id);
+    if (!row) return c.json({ error: "not found" }, 404);
+    const body = await c.req.json().catch(() => ({}));
+    const text = typeof body.text === "string" ? body.text : "";
+    if (!text) return c.json({ error: "text is required" }, 400);
+    const t0 = Date.now();
+    try {
+      await typeText(row.runtime_session_id, text, typeof body.delay === "number" ? body.delay : void 0);
+      await charge(row.id, user.id, t0);
+      await recordAction({ sessionId: row.id, type: "type", params: { length: text.length }, ok: true });
+      return c.json({ ok: true });
+    } catch (err) {
+      await charge(row.id, user.id, t0);
+      return c.json(failure(err), 502);
+    }
+  });
+  app2.post("/sessions/:id/scroll", async (c) => {
+    const user = c.get("user");
+    const row = await loadOpenSession(c.req.param("id"), user.id);
+    if (!row) return c.json({ error: "not found" }, 404);
+    const body = await c.req.json().catch(() => ({}));
+    const x = typeof body.x === "number" ? body.x : 640;
+    const y = typeof body.y === "number" ? body.y : 400;
+    const deltaX = typeof body.delta_x === "number" ? body.delta_x : 0;
+    const deltaY = typeof body.delta_y === "number" ? body.delta_y : 5;
+    const t0 = Date.now();
+    try {
+      await scroll(row.runtime_session_id, x, y, deltaX, deltaY);
+      await charge(row.id, user.id, t0);
+      await recordAction({ sessionId: row.id, type: "scroll", params: { deltaX, deltaY }, ok: true });
+      return c.json({ ok: true });
+    } catch (err) {
+      await charge(row.id, user.id, t0);
+      return c.json(failure(err), 502);
+    }
+  });
+  app2.post("/sessions/:id/press", async (c) => {
+    const user = c.get("user");
+    const row = await loadOpenSession(c.req.param("id"), user.id);
+    if (!row) return c.json({ error: "not found" }, 404);
+    const body = await c.req.json().catch(() => ({}));
+    const keys = Array.isArray(body.keys) ? body.keys.map(String) : [];
+    if (!keys.length) return c.json({ error: "keys is required" }, 400);
+    const t0 = Date.now();
+    try {
+      await pressKeys(row.runtime_session_id, keys);
+      await charge(row.id, user.id, t0);
+      await recordAction({ sessionId: row.id, type: "press", params: { keys }, ok: true });
+      return c.json({ ok: true });
+    } catch (err) {
+      await charge(row.id, user.id, t0);
+      return c.json(failure(err), 502);
+    }
+  });
+  app2.post("/sessions/:id/replay/start", async (c) => {
+    const user = c.get("user");
+    const row = await loadOpenSession(c.req.param("id"), user.id);
+    if (!row) return c.json({ error: "not found" }, 404);
+    const body = await c.req.json().catch(() => ({}));
+    try {
+      const started = await replayStart(row.runtime_session_id);
+      await recordReplayStart({
+        sessionId: row.id,
+        replayId: started.replayId,
+        viewUrl: started.viewUrl,
+        label: typeof body.label === "string" ? body.label : null
+      });
+      return c.json({ replay_id: started.replayId });
+    } catch (err) {
+      return c.json(failure(err), 502);
+    }
+  });
+  app2.post("/sessions/:id/replay/stop", async (c) => {
+    const user = c.get("user");
+    const row = await loadOpenSession(c.req.param("id"), user.id);
+    if (!row) return c.json({ error: "not found" }, 404);
+    const body = await c.req.json().catch(() => ({}));
+    const replayId = typeof body.replay_id === "string" ? body.replay_id : "";
+    if (!replayId) return c.json({ error: "replay_id is required" }, 400);
+    try {
+      await replayStop(row.runtime_session_id, replayId);
+      let viewUrl = null;
+      try {
+        const all = await replayList(row.runtime_session_id);
+        viewUrl = all.find((r) => r.replayId === replayId)?.viewUrl ?? null;
+      } catch {
+        viewUrl = null;
+      }
+      await recordReplayStop(replayId, viewUrl);
+      return c.json({ ok: true });
+    } catch (err) {
+      return c.json(failure(err), 502);
+    }
+  });
+  app2.get("/sessions/:id/replays", async (c) => {
+    const user = c.get("user");
+    const row = await loadOpenSession(c.req.param("id"), user.id);
+    if (!row) return c.json({ error: "not found" }, 404);
+    const rows = await listReplayRows(row.id);
+    return c.json({
+      replays: rows.map((r) => ({
+        replay_id: r.replay_id,
+        view_url: r.view_url,
+        label: r.label,
+        started_at: r.started_at,
+        stopped_at: r.stopped_at
+      }))
+    });
+  });
+  return app2;
+}
+var import_hono8, auth;
+var init_browser_agent_routes = __esm({
+  "src/api/browser-agent-routes.ts"() {
+    "use strict";
+    import_hono8 = require("hono");
+    init_api_auth();
+    init_errors();
+    init_db();
+    init_rates();
+    init_browser_agent_db();
+    init_browser_agent_service();
+    auth = createApiKeyAuth();
+  }
+});
+
+// src/api/browser-agent-console.ts
+function renderConsoleHtml(initialSessionId) {
+  const initial = JSON.stringify(initialSessionId ?? "");
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<title>Browser Agent Console</title>
+<style>
+  :root { color-scheme: dark; }
+  :where(*) { box-sizing: border-box; }
+  body { margin: 0; font: 14px/1.5 ui-sans-serif, system-ui, -apple-system, sans-serif; background: #0b0e14; color: #d7dce5; }
+  header { display: flex; align-items: center; gap: 12px; padding: 10px 16px; border-bottom: 1px solid #1c2230; background: #0f131c; }
+  header h1 { font-size: 15px; margin: 0; font-weight: 600; color: #fff; letter-spacing: .2px; }
+  header .spacer { flex: 1; }
+  input, button, select { font: inherit; }
+  input[type=text], input[type=password], input[type=url] { background: #141925; border: 1px solid #232b3a; color: #e6eaf2; border-radius: 7px; padding: 7px 10px; }
+  button { background: #2b6cff; border: 0; color: #fff; border-radius: 7px; padding: 7px 12px; cursor: pointer; font-weight: 500; }
+  button.ghost { background: #1a2030; color: #cdd5e4; border: 1px solid #28303f; }
+  button:disabled { opacity: .5; cursor: default; }
+  .layout { display: grid; grid-template-columns: 280px 1fr; height: calc(100vh - 53px); }
+  aside { border-right: 1px solid #1c2230; overflow-y: auto; padding: 12px; }
+  aside h2 { font-size: 11px; text-transform: uppercase; letter-spacing: .08em; color: #6b7689; margin: 4px 4px 10px; }
+  .sess { padding: 9px 10px; border-radius: 8px; border: 1px solid #1c2230; margin-bottom: 8px; cursor: pointer; }
+  .sess:hover { border-color: #2b6cff; }
+  .sess.active { border-color: #2b6cff; background: #131b2e; }
+  .sess .id { font-family: ui-monospace, monospace; font-size: 12px; color: #aeb8cc; }
+  .sess .meta { font-size: 11px; color: #6b7689; margin-top: 3px; }
+  .dot { display: inline-block; width: 7px; height: 7px; border-radius: 50%; margin-right: 5px; }
+  .dot.open { background: #36d399; } .dot.closed { background: #5a6677; }
+  main { display: flex; flex-direction: column; overflow: hidden; }
+  .toolbar { display: flex; align-items: center; gap: 10px; padding: 10px 16px; border-bottom: 1px solid #1c2230; }
+  .toolbar label { font-size: 13px; color: #aeb8cc; display: flex; align-items: center; gap: 6px; }
+  .stage { flex: 1; position: relative; background: #05070b; overflow: auto; }
+  .stage iframe { width: 100%; height: 100%; border: 0; display: block; }
+  .empty { display: flex; align-items: center; justify-content: center; height: 100%; color: #5a6677; flex-direction: column; gap: 10px; }
+  .replays { border-top: 1px solid #1c2230; padding: 10px 16px; max-height: 200px; overflow-y: auto; }
+  .replays h3 { font-size: 11px; text-transform: uppercase; letter-spacing: .08em; color: #6b7689; margin: 0 0 8px; }
+  .replay { display: flex; align-items: center; gap: 10px; padding: 6px 0; font-size: 13px; }
+  .replay a { color: #7aa2ff; }
+  .gate { max-width: 380px; margin: 80px auto; padding: 24px; border: 1px solid #1c2230; border-radius: 12px; background: #0f131c; }
+  .gate h2 { margin: 0 0 6px; font-size: 16px; color: #fff; }
+  .gate p { color: #8893a7; margin: 0 0 16px; }
+  .gate input { width: 100%; margin-bottom: 12px; }
+  .gate button { width: 100%; }
+  .muted { color: #6b7689; font-size: 12px; }
+</style>
+</head>
+<body>
+<div id="app"></div>
+<script>
+const INITIAL_SESSION = ${initial};
+const KEY_STORE = 'browser_agent_api_key';
+let state = { key: localStorage.getItem(KEY_STORE) || '', sessions: [], current: INITIAL_SESSION || null, readOnly: true, liveUrl: null, replays: [] };
+
+function api(method, path, body) {
+  return fetch('/agent' + path, {
+    method,
+    headers: { 'Content-Type': 'application/json', 'x-api-key': state.key },
+    body: body ? JSON.stringify(body) : undefined,
+  }).then(async r => ({ ok: r.ok, data: await r.json().catch(() => ({})) }));
+}
+
+async function refreshSessions() {
+  const r = await api('GET', '/sessions?all=1');
+  if (r.ok) { state.sessions = r.data.sessions || []; render(); }
+}
+
+async function selectSession(id) {
+  state.current = id; state.liveUrl = null; state.replays = [];
+  history.replaceState(null, '', '/console/' + id);
+  render();
+  const live = await api('GET', '/sessions/' + id + '/live-view');
+  state.liveUrl = live.ok ? live.data.live_view_url : null;
+  const reps = await api('GET', '/sessions/' + id + '/replays');
+  state.replays = reps.ok ? (reps.data.replays || []) : [];
+  render();
+}
+
+async function openSession() {
+  const r = await api('POST', '/sessions', { label: 'console' });
+  if (r.ok) { await refreshSessions(); selectSession(r.data.session_id); }
+  else alert('Open failed: ' + JSON.stringify(r.data));
+}
+
+async function closeCurrent() {
+  if (!state.current) return;
+  await api('DELETE', '/sessions/' + state.current);
+  await refreshSessions();
+}
+
+function frameSrc() {
+  if (!state.liveUrl) return null;
+  const sep = state.liveUrl.includes('?') ? '&' : '?';
+  return state.readOnly ? state.liveUrl + sep + 'readOnly=true' : state.liveUrl;
+}
+
+function saveKey(v) { state.key = v.trim(); localStorage.setItem(KEY_STORE, state.key); render(); if (state.key) { refreshSessions(); if (state.current) selectSession(state.current); } }
+
+function h(html) { const t = document.createElement('template'); t.innerHTML = html.trim(); return t.content.firstChild; }
+function esc(s) { return String(s == null ? '' : s).replace(/[&<>"]/g, c => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c])); }
+
+function render() {
+  const app = document.getElementById('app');
+  app.innerHTML = '';
+  if (!state.key) {
+    app.appendChild(h('<div class="gate"><h2>Browser Agent Console</h2><p>Paste your API key to watch and control browser sessions.</p><input id="k" type="password" placeholder="API key" /><button id="kb">Continue</button></div>'));
+    document.getElementById('kb').onclick = () => saveKey(document.getElementById('k').value);
+    document.getElementById('k').onkeydown = e => { if (e.key === 'Enter') saveKey(e.target.value); };
+    return;
+  }
+  const header = h('<header><h1>Browser Agent</h1><span class="muted">live control + replays</span><span class="spacer"></span><button id="open">+ New Session</button><button class="ghost" id="logout">Forget key</button></header>');
+  app.appendChild(header);
+  document.getElementById('open').onclick = openSession;
+  document.getElementById('logout').onclick = () => saveKey('');
+
+  const layout = h('<div class="layout"></div>');
+  const aside = h('<aside><h2>Sessions</h2></aside>');
+  if (!state.sessions.length) aside.appendChild(h('<div class="muted" style="padding:4px">No sessions yet.</div>'));
+  for (const s of state.sessions) {
+    const el = h('<div class="sess ' + (s.session_id === state.current ? 'active' : '') + '"><div class="id">' + esc(s.session_id) + '</div><div class="meta"><span class="dot ' + esc(s.status) + '"></span>' + esc(s.status) + (s.label ? ' \xB7 ' + esc(s.label) : '') + '</div></div>');
+    el.onclick = () => selectSession(s.session_id);
+    aside.appendChild(el);
+  }
+  layout.appendChild(aside);
+
+  const main = h('<main></main>');
+  if (!state.current) {
+    main.appendChild(h('<div class="empty"><div>Select or open a session to watch.</div></div>'));
+  } else {
+    const tb = h('<div class="toolbar"><label><input type="checkbox" id="ro" ' + (state.readOnly ? 'checked' : '') + ' /> Read-only (uncheck to take control)</label><span class="spacer"></span><button class="ghost" id="reload">Reload view</button><button class="ghost" id="close">Close session</button></div>');
+    main.appendChild(tb);
+    const stage = h('<div class="stage"></div>');
+    const src = frameSrc();
+    if (src) {
+      const f = h('<iframe allow="autoplay; clipboard-read; clipboard-write" src="' + esc(src) + '"></iframe>');
+      stage.appendChild(f);
+    } else {
+      stage.appendChild(h('<div class="empty"><div>Live view unavailable for this session.</div><div class="muted">It may be closed or still starting.</div></div>'));
+    }
+    main.appendChild(stage);
+
+    const rep = h('<div class="replays"><h3>Replays</h3></div>');
+    if (!state.replays.length) rep.appendChild(h('<div class="muted">No replays recorded.</div>'));
+    for (const r of state.replays) {
+      const status = r.stopped_at ? 'ready' : 'recording\u2026';
+      const link = r.view_url ? '<a href="' + esc(r.view_url) + '" target="_blank" rel="noopener">view mp4</a>' : '<span class="muted">' + status + '</span>';
+      rep.appendChild(h('<div class="replay"><span class="muted">' + esc(r.started_at || '') + '</span><span class="spacer"></span>' + link + '</div>'));
+    }
+    main.appendChild(rep);
+
+    layout.appendChild(main);
+  }
+  app.appendChild(layout);
+
+  const ro = document.getElementById('ro');
+  if (ro) ro.onchange = e => { state.readOnly = e.target.checked; render(); };
+  const reload = document.getElementById('reload');
+  if (reload) reload.onclick = () => selectSession(state.current);
+  const close = document.getElementById('close');
+  if (close) close.onclick = closeCurrent;
+}
+
+render();
+if (state.key) { refreshSessions(); if (state.current) selectSession(state.current); }
+</script>
+</body>
+</html>`;
+}
+var init_browser_agent_console = __esm({
+  "src/api/browser-agent-console.ts"() {
+    "use strict";
+  }
+});
+
 // src/api/stripe-routes.ts
-var import_stripe, import_hono8, stripe, stripeApp;
+var import_stripe, import_hono9, stripe, stripeApp;
 var init_stripe_routes = __esm({
   "src/api/stripe-routes.ts"() {
     "use strict";
     import_stripe = __toESM(require("stripe"), 1);
-    import_hono8 = require("hono");
+    import_hono9 = require("hono");
     init_db();
     init_rates();
     stripe = new import_stripe.default(process.env.STRIPE_SECRET_KEY, { apiVersion: "2026-02-25.clover" });
-    stripeApp = new import_hono8.Hono();
+    stripeApp = new import_hono9.Hono();
     stripeApp.post("/webhooks", async (c) => {
       const sig = c.req.header("stripe-signature");
       const body = await c.req.text();
@@ -17065,14 +17906,14 @@ function getSessionSecret() {
 function safeEqualHex(a, b) {
   if (a.length !== b.length) return false;
   try {
-    return (0, import_node_crypto3.timingSafeEqual)(Buffer.from(a, "hex"), Buffer.from(b, "hex"));
+    return (0, import_node_crypto4.timingSafeEqual)(Buffer.from(a, "hex"), Buffer.from(b, "hex"));
   } catch {
     return false;
   }
 }
 function signSession(userId) {
   const payload = String(userId);
-  const sig = (0, import_node_crypto3.createHmac)("sha256", secret()).update(payload).digest("hex");
+  const sig = (0, import_node_crypto4.createHmac)("sha256", secret()).update(payload).digest("hex");
   return `${payload}.${sig}`;
 }
 function verifySession(token) {
@@ -17080,16 +17921,16 @@ function verifySession(token) {
   if (dot === -1) return null;
   const payload = token.slice(0, dot);
   const sig = token.slice(dot + 1);
-  const expected = (0, import_node_crypto3.createHmac)("sha256", secret()).update(payload).digest("hex");
+  const expected = (0, import_node_crypto4.createHmac)("sha256", secret()).update(payload).digest("hex");
   if (!safeEqualHex(sig, expected)) return null;
   const id = parseInt(payload);
   return isNaN(id) ? null : id;
 }
-var import_node_crypto3, isProduction, secret;
+var import_node_crypto4, isProduction, secret;
 var init_session = __esm({
   "src/api/session.ts"() {
     "use strict";
-    import_node_crypto3 = require("crypto");
+    import_node_crypto4 = require("crypto");
     isProduction = () => process.env.NODE_ENV === "production" || process.env.VERCEL === "1";
     secret = () => getSessionSecret();
   }
@@ -17305,7 +18146,7 @@ async function checkHarvestLimits(userId, email, extraSlots = 0) {
   if (active >= limit) return { error: `You have ${active} job${active !== 1 ? "s" : ""} running. Your account allows ${limit} concurrent job${limit !== 1 ? "s" : ""}. Wait for one to finish or add a concurrency slot at mcpscraper.dev/billing.` };
   return null;
 }
-var import_resend, import_hono9, import_hono10, import_factory6, import_cookie, import_stripe2, secureCookies, isProduction2, sessionCookieOptions, requireAllowedOrigin, auth, adminAuth, sessionAuth, app, STRIPE_API_VERSION, BYPASS_EMAILS, SYNC_HARVEST_TIMEOUT_OVERRIDE_MS;
+var import_resend, import_hono10, import_hono11, import_factory6, import_cookie, import_stripe2, secureCookies, isProduction2, sessionCookieOptions, requireAllowedOrigin, auth2, adminAuth, sessionAuth, app, STRIPE_API_VERSION, BYPASS_EMAILS, SYNC_HARVEST_TIMEOUT_OVERRIDE_MS;
 var init_server = __esm({
   "src/api/server.ts"() {
     "use strict";
@@ -17322,8 +18163,8 @@ var init_server = __esm({
     init_media_extractor();
     init_site_mapper();
     init_site_extractor();
-    import_hono9 = require("hono");
-    import_hono10 = require("inngest/hono");
+    import_hono10 = require("hono");
+    import_hono11 = require("inngest/hono");
     init_client();
     init_site_audit();
     init_site_audit_routes();
@@ -17333,6 +18174,8 @@ var init_server = __esm({
     init_maps_routes();
     init_serp_intelligence_routes();
     init_mcp_routes();
+    init_browser_agent_routes();
+    init_browser_agent_console();
     init_stripe_routes();
     init_site_audit_worker();
     import_factory6 = require("hono/factory");
@@ -17362,7 +18205,7 @@ var init_server = __esm({
       if (!configuredOrigins().has(origin)) return c.json({ error: "Origin not allowed" }, 403);
       return next();
     });
-    auth = (0, import_factory6.createMiddleware)(async (c, next) => {
+    auth2 = (0, import_factory6.createMiddleware)(async (c, next) => {
       const key = c.req.header("x-api-key");
       if (!key) return c.json({ error: "Missing API key" }, 401);
       const user = await getUserByApiKey(key);
@@ -17391,7 +18234,7 @@ var init_server = __esm({
       c.set("sessionUser", { ...refreshed, balance_mc: balanceMc });
       return next();
     });
-    app = new import_hono9.Hono();
+    app = new import_hono10.Hono();
     STRIPE_API_VERSION = "2026-02-25.clover";
     app.use("*", async (c, next) => {
       await next();
@@ -17551,7 +18394,7 @@ var init_server = __esm({
       const parsed = raw === void 0 ? NaN : Number(raw);
       return Number.isFinite(parsed) && parsed > 0 ? parsed : null;
     })();
-    app.post("/harvest", auth, async (c) => {
+    app.post("/harvest", auth2, async (c) => {
       const user = c.get("user");
       const raw = await c.req.json().catch(() => ({}));
       const bodyResult = HarvestBodySchema.safeParse(raw);
@@ -17593,7 +18436,7 @@ var init_server = __esm({
       }
       return c.json({ job_id: jobId, status: "pending" }, 202);
     });
-    app.post("/harvest/sync", auth, async (c) => {
+    app.post("/harvest/sync", auth2, async (c) => {
       const user = c.get("user");
       const raw = await c.req.json().catch(() => ({}));
       const bodyResult = HarvestBodySchema.safeParse(raw);
@@ -17658,17 +18501,17 @@ var init_server = __esm({
         return c.json({ job_id: jobId, status: "failed", ...response, attempts: sanitizeAttempts(attempts) }, problem.httpStatus);
       }
     });
-    app.get("/jobs/:id", auth, async (c) => {
+    app.get("/jobs/:id", auth2, async (c) => {
       const job = await getJob(c.req.param("id"), c.get("user").id);
       if (!job) return c.json({ error: "Job not found" }, 404);
       const attempts = await listHarvestAttempts(job.id, c.get("user").id);
       const safeResult = job.result && typeof job.result === "object" ? sanitizeHarvestResult(job.result) : job.result;
       return c.json({ ...job, result: safeResult, attempts: sanitizeAttempts(attempts) });
     });
-    app.get("/jobs", auth, async (c) => {
+    app.get("/jobs", auth2, async (c) => {
       return c.json(await listJobs(c.get("user").id));
     });
-    app.get("/history", auth, async (c) => {
+    app.get("/history", auth2, async (c) => {
       const userId = c.get("user").id;
       const [jobs, events] = await Promise.all([
         listJobs(userId),
@@ -17698,7 +18541,7 @@ var init_server = __esm({
       const rows = [...jobRows, ...eventRows].sort((a, b) => String(b.ts).localeCompare(String(a.ts)));
       return c.json(rows.slice(0, 100));
     });
-    app.get("/ledger", auth, async (c) => {
+    app.get("/ledger", auth2, async (c) => {
       return c.json(await getLedger(c.get("user").id, 100));
     });
     app.post("/admin/users", adminAuth, async (c) => {
@@ -17736,11 +18579,11 @@ var init_server = __esm({
       }
       return c.json({ processed, credited, skipped, users_credited });
     });
-    app.post("/extract-url", auth, async (c) => {
+    app.post("/extract-url", auth2, async (c) => {
       const raw = await c.req.json().catch(() => ({}));
       const bodyResult = ExtractUrlBodySchema.safeParse(raw);
       if (!bodyResult.success) return c.json({ error: bodyResult.error.issues[0]?.message ?? "Invalid request" }, 400);
-      const { url, screenshot, screenshotDevice, extractBranding, downloadMedia, mediaTypes, allowLocal } = bodyResult.data;
+      const { url, screenshot: screenshot2, screenshotDevice, extractBranding, downloadMedia, mediaTypes, allowLocal } = bodyResult.data;
       if (!allowLocal) {
         const checked = await validatePublicHttpUrl(url, { field: "URL" });
         if (checked.error || !checked.parsed) return c.json({ error: checked.error ?? "Invalid URL" }, 400);
@@ -17766,7 +18609,7 @@ var init_server = __esm({
         const device = screenshotDevice === "mobile" ? "mobile" : "desktop";
         const [result, pageData] = await Promise.all([
           extractKpo({ url: canonicalUrl, kernelApiKey }),
-          screenshot || extractBranding ? capturePageData(canonicalUrl, { kernelApiKey, device, screenshot: !!screenshot, branding: !!extractBranding }).catch(() => null) : null
+          screenshot2 || extractBranding ? capturePageData(canonicalUrl, { kernelApiKey, device, screenshot: !!screenshot2, branding: !!extractBranding }).catch(() => null) : null
         ]);
         const screenshotBuf = pageData?.screenshot ?? null;
         const brandingData = pageData?.branding ?? null;
@@ -17784,7 +18627,7 @@ var init_server = __esm({
         return c.json({ error: msg }, 500);
       }
     });
-    app.post("/map-urls", auth, async (c) => {
+    app.post("/map-urls", auth2, async (c) => {
       const raw = await c.req.json().catch(() => ({}));
       const bodyResult = MapUrlsBodySchema.safeParse(raw);
       if (!bodyResult.success) return c.json({ error: bodyResult.error.issues[0]?.message ?? "Invalid request" }, 400);
@@ -17824,7 +18667,7 @@ var init_server = __esm({
         return c.json({ error: msg }, 500);
       }
     });
-    app.post("/extract-site", auth, async (c) => {
+    app.post("/extract-site", auth2, async (c) => {
       const raw = await c.req.json().catch(() => ({}));
       const bodyResult = ExtractSiteBodySchema.safeParse(raw);
       if (!bodyResult.success) return c.json({ error: bodyResult.error.issues[0]?.message ?? "Invalid request" }, 400);
@@ -17946,7 +18789,7 @@ var init_server = __esm({
       await setConcurrencySubId(user.id, null);
       return c.json({ ok: true, concurrency_limit: user.extra_concurrency_slots });
     });
-    app.get("/billing/balance", auth, async (c) => {
+    app.get("/billing/balance", auth2, async (c) => {
       const user = c.get("user");
       const balanceMc = await reconcileBalanceMc(user.id);
       const ledger = await getLedger(user.id, 20);
@@ -17958,7 +18801,7 @@ var init_server = __esm({
         ledger
       });
     });
-    app.post("/billing/credits", auth, async (c) => {
+    app.post("/billing/credits", auth2, async (c) => {
       const user = c.get("user");
       const balanceMc = await reconcileBalanceMc(user.id);
       const body = await c.req.json().catch(() => ({}));
@@ -17995,7 +18838,7 @@ var init_server = __esm({
       ]);
       return c.json({ drained: results.length, results, sweepResult });
     });
-    app.on(["GET", "POST", "PUT"], "/api/inngest", (0, import_hono10.serve)({ client: inngest, functions: [siteAuditFn] }));
+    app.on(["GET", "POST", "PUT"], "/api/inngest", (0, import_hono11.serve)({ client: inngest, functions: [siteAuditFn] }));
     app.route("/api/internal/site-architecture-auditor", siteAuditApp);
     app.route("/youtube", youtubeApp);
     app.route("/screenshot", screenshotApp);
@@ -18003,6 +18846,9 @@ var init_server = __esm({
     app.route("/maps", mapsApp);
     app.route("/serp-intelligence", serpIntelligenceApp);
     app.route("/mcp", mcpApp);
+    app.route("/agent", buildBrowserAgentRoutes());
+    app.get("/console", (c) => c.html(renderConsoleHtml()));
+    app.get("/console/:id", (c) => c.html(renderConsoleHtml(c.req.param("id"))));
     app.route("/stripe", stripeApp);
     if (!process.env.INNGEST_EVENT_KEY) {
       startSiteAuditWorker();
@@ -18110,10 +18956,10 @@ var init_server = __esm({
 });
 
 // bin/api-server.ts
-var import_node_fs5 = require("fs");
+var import_node_fs6 = require("fs");
 function loadDotEnv() {
   try {
-    for (const line of (0, import_node_fs5.readFileSync)(".env", "utf8").split("\n")) {
+    for (const line of (0, import_node_fs6.readFileSync)(".env", "utf8").split("\n")) {
       const eq = line.indexOf("=");
       if (eq < 1 || line.trimStart().startsWith("#")) continue;
       const k = line.slice(0, eq).trim();