mcp-scraper 0.2.20 → 0.2.21

package/dist/bin/browser-agent-stdio-server.js

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
 import {
   buildBrowserAgentMcpServer
-} from "../chunk-L4OWOUGR.js";
+} from "../chunk-HS6OKELW.js";
+import "../chunk-WN7PBKMV.js";
+import "../chunk-DUEW4EOO.js";
 import "../chunk-XKUDVN2E.js";
 
 // bin/browser-agent-stdio-server.ts

package/dist/bin/browser-agent-stdio-server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../bin/browser-agent-stdio-server.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { buildBrowserAgentMcpServer } from '../src/mcp/browser-agent-mcp-server.js'\n\nfunction readApiKeyFile(): string | undefined {\n  const explicitPath = process.env.MCP_SCRAPER_KEY_PATH?.trim()\n  const paths = [explicitPath, join(homedir(), '.mcp-scraper-key')].filter(Boolean) as string[]\n  for (const path of paths) {\n    try {\n      const value = readFileSync(path, 'utf8').trim()\n      if (value) return value\n    } catch {\n      void 0\n    }\n  }\n  return undefined\n}\n\nconst apiKey = (\n  process.env.MCP_SCRAPER_API_KEY ??\n  process.env.MCP_SCRAPER_KEY ??\n  process.env.MCP_API_KEY ??\n  readApiKeyFile()\n)?.trim()\nif (!apiKey) {\n  process.stderr.write('MCP_SCRAPER_API_KEY env var or ~/.mcp-scraper-key is required\\n')\n  process.exit(1)\n}\n\nconst baseUrl = process.env.MCP_SCRAPER_BASE_URL?.trim() || process.env.MCP_BASE_URL?.trim() || 'https://mcpscraper.dev'\nconst consoleBaseUrl = process.env.BROWSER_AGENT_CONSOLE_URL?.trim() || baseUrl\nconst server = buildBrowserAgentMcpServer({ baseUrl, apiKey, consoleBaseUrl })\nconst transport = new StdioServerTransport()\n\nasync function main() {\n  await server.connect(transport)\n}\n\nmain().catch(err => {\n  process.stderr.write(`${err instanceof Error ? err.message : String(err)}\\n`)\n  process.exit(1)\n})\n"],"mappings":";;;;;;;AACA,SAAS,oBAAoB;AAC7B,SAAS,eAAe;AACxB,SAAS,YAAY;AACrB,SAAS,4BAA4B;AAGrC,SAAS,iBAAqC;AAC5C,QAAM,eAAe,QAAQ,IAAI,sBAAsB,KAAK;AAC5D,QAAM,QAAQ,CAAC,cAAc,KAAK,QAAQ,GAAG,kBAAkB,CAAC,EAAE,OAAO,OAAO;AAChF,aAAW,QAAQ,OAAO;AACxB,QAAI;AACF,YAAM,QAAQ,aAAa,MAAM,MAAM,EAAE,KAAK;AAC9C,UAAI,MAAO,QAAO;AAAA,IACpB,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO;AACT;AAEA,IAAM,UACJ,QAAQ,IAAI,uBACZ,QAAQ,IAAI,mBACZ,QAAQ,IAAI,eACZ,eAAe,IACd,KAAK;AACR,IAAI,CAAC,QAAQ;AACX,UAAQ,OAAO,MAAM,iEAAiE;AACtF,UAAQ,KAAK,CAAC;AAChB;AAEA,IAAM,UAAU,QAAQ,IAAI,sBAAsB,KAAK,KAAK,QAAQ,IAAI,cAAc,KAAK,KAAK;AAChG,IAAM,iBAAiB,QAAQ,IAAI,2BAA2B,KAAK,KAAK;AACxE,IAAM,SAAS,2BAA2B,EAAE,SAAS,QAAQ,eAAe,CAAC;AAC7E,IAAM,YAAY,IAAI,qBAAqB;AAE3C,eAAe,OAAO;AACpB,QAAM,OAAO,QAAQ,SAAS;AAChC;AAEA,KAAK,EAAE,MAAM,SAAO;AAClB,UAAQ,OAAO,MAAM,GAAG,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA,CAAI;AAC5E,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":[]}
+{"version":3,"sources":["../../bin/browser-agent-stdio-server.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { buildBrowserAgentMcpServer } from '../src/mcp/browser-agent-mcp-server.js'\n\nfunction readApiKeyFile(): string | undefined {\n  const explicitPath = process.env.MCP_SCRAPER_KEY_PATH?.trim()\n  const paths = [explicitPath, join(homedir(), '.mcp-scraper-key')].filter(Boolean) as string[]\n  for (const path of paths) {\n    try {\n      const value = readFileSync(path, 'utf8').trim()\n      if (value) return value\n    } catch {\n      void 0\n    }\n  }\n  return undefined\n}\n\nconst apiKey = (\n  process.env.MCP_SCRAPER_API_KEY ??\n  process.env.MCP_SCRAPER_KEY ??\n  process.env.MCP_API_KEY ??\n  readApiKeyFile()\n)?.trim()\nif (!apiKey) {\n  process.stderr.write('MCP_SCRAPER_API_KEY env var or ~/.mcp-scraper-key is required\\n')\n  process.exit(1)\n}\n\nconst baseUrl = process.env.MCP_SCRAPER_BASE_URL?.trim() || process.env.MCP_BASE_URL?.trim() || 'https://mcpscraper.dev'\nconst consoleBaseUrl = process.env.BROWSER_AGENT_CONSOLE_URL?.trim() || baseUrl\nconst server = buildBrowserAgentMcpServer({ baseUrl, apiKey, consoleBaseUrl })\nconst transport = new StdioServerTransport()\n\nasync function main() {\n  await server.connect(transport)\n}\n\nmain().catch(err => {\n  process.stderr.write(`${err instanceof Error ? err.message : String(err)}\\n`)\n  process.exit(1)\n})\n"],"mappings":";;;;;;;;;AACA,SAAS,oBAAoB;AAC7B,SAAS,eAAe;AACxB,SAAS,YAAY;AACrB,SAAS,4BAA4B;AAGrC,SAAS,iBAAqC;AAC5C,QAAM,eAAe,QAAQ,IAAI,sBAAsB,KAAK;AAC5D,QAAM,QAAQ,CAAC,cAAc,KAAK,QAAQ,GAAG,kBAAkB,CAAC,EAAE,OAAO,OAAO;AAChF,aAAW,QAAQ,OAAO;AACxB,QAAI;AACF,YAAM,QAAQ,aAAa,MAAM,MAAM,EAAE,KAAK;AAC9C,UAAI,MAAO,QAAO;AAAA,IACpB,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO;AACT;AAEA,IAAM,UACJ,QAAQ,IAAI,uBACZ,QAAQ,IAAI,mBACZ,QAAQ,IAAI,eACZ,eAAe,IACd,KAAK;AACR,IAAI,CAAC,QAAQ;AACX,UAAQ,OAAO,MAAM,iEAAiE;AACtF,UAAQ,KAAK,CAAC;AAChB;AAEA,IAAM,UAAU,QAAQ,IAAI,sBAAsB,KAAK,KAAK,QAAQ,IAAI,cAAc,KAAK,KAAK;AAChG,IAAM,iBAAiB,QAAQ,IAAI,2BAA2B,KAAK,KAAK;AACxE,IAAM,SAAS,2BAA2B,EAAE,SAAS,QAAQ,eAAe,CAAC;AAC7E,IAAM,YAAY,IAAI,qBAAqB;AAE3C,eAAe,OAAO;AACpB,QAAM,OAAO,QAAQ,SAAS;AAChC;AAEA,KAAK,EAAE,MAAM,SAAO;AAClB,UAAQ,OAAO,MAAM,GAAG,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA,CAAI;AAC5E,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":[]}

package/dist/bin/mcp-scraper-cli.cjs

@@ -4,12 +4,214 @@
 // src/cli/human-cli.ts
 var import_commander = require("commander");
 var import_node_child_process2 = require("child_process");
-var import_promises4 = require("fs/promises");
-var import_node_path3 = require("path");
+var import_promises6 = require("fs/promises");
+var import_node_path5 = require("path");
 
 // src/version.ts
 var PACKAGE_VERSION = "0.2.20";
 
+// src/lib/chrome-profiles.ts
+var import_promises = require("fs/promises");
+var import_node_os = require("os");
+var import_node_path = require("path");
+function defaultChromeUserDataDir() {
+  if (process.platform === "darwin") return (0, import_node_path.join)((0, import_node_os.homedir)(), "Library", "Application Support", "Google", "Chrome");
+  if (process.platform === "win32") {
+    return (0, import_node_path.join)(process.env.LOCALAPPDATA ?? (0, import_node_path.join)((0, import_node_os.homedir)(), "AppData", "Local"), "Google", "Chrome", "User Data");
+  }
+  return (0, import_node_path.join)(process.env.XDG_CONFIG_HOME ?? (0, import_node_path.join)((0, import_node_os.homedir)(), ".config"), "google-chrome");
+}
+function recommendedKernelProfileName(value) {
+  return value.trim().toLowerCase().replace(/@/g, "-").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80) || "browser-profile";
+}
+async function listLocalChromeProfiles(userDataDir = defaultChromeUserDataDir(), emailFilter) {
+  const raw = await (0, import_promises.readFile)((0, import_node_path.join)(userDataDir, "Local State"), "utf8");
+  const localState = JSON.parse(raw);
+  const wanted = emailFilter?.trim().toLowerCase();
+  return Object.entries(localState.profile?.info_cache ?? {}).map(([directory, info]) => {
+    const email = (info.user_name ?? "").trim();
+    const displayName = (info.name ?? info.shortcut_name ?? "").trim();
+    const labelSource = email || displayName || directory;
+    return {
+      email,
+      displayName,
+      chromeProfileDirectory: directory,
+      chromeProfilePath: (0, import_node_path.join)(userDataDir, directory),
+      recommendedKernelProfileName: recommendedKernelProfileName(labelSource)
+    };
+  }).filter((row) => !wanted || row.email.toLowerCase() === wanted || row.displayName.toLowerCase().includes(wanted));
+}
+
+// src/lib/local-browser-profiles.ts
+var import_node_fs = require("fs");
+var import_promises2 = require("fs/promises");
+var import_node_os2 = require("os");
+var import_node_path2 = require("path");
+var EXCLUDED_PROFILE_NAMES = [
+  "Cache",
+  "Code Cache",
+  "Crashpad",
+  "DawnCache",
+  "DawnGraphiteCache",
+  "DawnWebGPUCache",
+  "GPUCache",
+  "GrShaderCache",
+  "ShaderCache",
+  "Shared Dictionary"
+];
+function defaultImportedBrowserProfilesDir() {
+  return process.env.MCP_SCRAPER_BROWSER_PROFILE_BASE_DIR?.trim() || (0, import_node_path2.join)((0, import_node_os2.homedir)(), ".mcp-scraper", "browser-profiles");
+}
+function defaultChromeExecutablePath() {
+  const envPath = process.env.MCP_SCRAPER_BROWSER_EXECUTABLE?.trim() || process.env.CHROME_PATH?.trim();
+  if (envPath) return envPath;
+  const candidates = process.platform === "darwin" ? ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"] : process.platform === "win32" ? [
+    (0, import_node_path2.join)(process.env.PROGRAMFILES ?? "C:\\Program Files", "Google", "Chrome", "Application", "chrome.exe"),
+    (0, import_node_path2.join)(process.env["PROGRAMFILES(X86)"] ?? "C:\\Program Files (x86)", "Google", "Chrome", "Application", "chrome.exe")
+  ] : ["/usr/bin/google-chrome", "/usr/bin/google-chrome-stable", "/usr/bin/chromium-browser", "/usr/bin/chromium"];
+  return candidates.find((candidate) => (0, import_node_fs.existsSync)(candidate));
+}
+function importedProfileName(value) {
+  return recommendedKernelProfileName(value);
+}
+function importedProfileRoot(name, outputDir = defaultImportedBrowserProfilesDir()) {
+  return (0, import_node_path2.join)(outputDir, importedProfileName(name));
+}
+function importedProfileManifestPath(name, outputDir = defaultImportedBrowserProfilesDir()) {
+  return (0, import_node_path2.join)(importedProfileRoot(name, outputDir), "manifest.json");
+}
+function importedProfileUserDataDir(name, outputDir = defaultImportedBrowserProfilesDir()) {
+  return (0, import_node_path2.join)(importedProfileRoot(name, outputDir), "user-data");
+}
+async function readExistingManifest(path) {
+  try {
+    return JSON.parse(await (0, import_promises2.readFile)(path, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function isExcludedProfilePath(sourceRoot, sourcePath) {
+  const rel = (0, import_node_path2.relative)(sourceRoot, sourcePath);
+  if (!rel) return false;
+  const parts = rel.split(import_node_path2.sep).filter(Boolean);
+  const last = parts[parts.length - 1] ?? "";
+  if (last.startsWith("Singleton")) return true;
+  if (last === "LOCK" || last.endsWith(".lock")) return true;
+  if (parts.some((part) => EXCLUDED_PROFILE_NAMES.includes(part))) return true;
+  if (parts.includes("Service Worker") && parts.includes("CacheStorage")) return true;
+  return false;
+}
+async function copyProfileTree(sourceProfilePath, destinationProfilePath) {
+  await (0, import_promises2.cp)(sourceProfilePath, destinationProfilePath, {
+    recursive: true,
+    force: true,
+    errorOnExist: false,
+    dereference: false,
+    filter: (source) => !isExcludedProfilePath(sourceProfilePath, source)
+  });
+}
+function selectProfile(profiles, options) {
+  const requestedDirectory = options.chromeProfileDirectory?.trim();
+  const requestedEmail = options.email?.trim().toLowerCase();
+  const exactDirectory = requestedDirectory ? profiles.find((profile) => profile.chromeProfileDirectory === requestedDirectory) : void 0;
+  if (exactDirectory) return exactDirectory;
+  const exactEmail = requestedEmail ? profiles.find((profile) => profile.email.toLowerCase() === requestedEmail) : void 0;
+  if (exactEmail) return exactEmail;
+  const first = profiles[0];
+  if (first) return first;
+  const hint = requestedDirectory ? `Chrome profile directory "${requestedDirectory}"` : requestedEmail ? `Chrome account "${requestedEmail}"` : "Chrome profile";
+  throw new Error(`${hint} was not found in ${options.sourceUserDataDir ?? defaultChromeUserDataDir()}`);
+}
+async function ensureProfilePathExists(profile) {
+  const details = await (0, import_promises2.stat)(profile.chromeProfilePath).catch(() => null);
+  if (!details?.isDirectory()) {
+    throw new Error(`Chrome profile path does not exist or is not a directory: ${profile.chromeProfilePath}`);
+  }
+}
+async function writeNormalizedLocalState(sourceLocalStatePath, destinationLocalStatePath, sourceProfileDirectory) {
+  const raw = await (0, import_promises2.readFile)(sourceLocalStatePath, "utf8");
+  const localState = JSON.parse(raw);
+  const selectedInfo = localState.profile?.info_cache?.[sourceProfileDirectory] ?? localState.profile?.info_cache?.Default ?? {};
+  localState.profile = {
+    ...localState.profile ?? {},
+    info_cache: { Default: selectedInfo },
+    last_used: "Default",
+    last_active_profiles: ["Default"]
+  };
+  await (0, import_promises2.writeFile)(destinationLocalStatePath, `${JSON.stringify(localState, null, 2)}
+`);
+}
+async function importChromeProfile(options = {}) {
+  const sourceUserDataDir = options.sourceUserDataDir?.trim() || defaultChromeUserDataDir();
+  const profiles = await listLocalChromeProfiles(sourceUserDataDir, options.email);
+  const sourceProfile = selectProfile(profiles, { ...options, sourceUserDataDir });
+  await ensureProfilePathExists(sourceProfile);
+  const name = importedProfileName(options.name?.trim() || sourceProfile.recommendedKernelProfileName);
+  const outputDir = options.outputDir?.trim() || defaultImportedBrowserProfilesDir();
+  const profileRoot = importedProfileRoot(name, outputDir);
+  const manifestPath = importedProfileManifestPath(name, outputDir);
+  const userDataDir = importedProfileUserDataDir(name, outputDir);
+  const existingManifest = await readExistingManifest(manifestPath);
+  const existing = (0, import_node_fs.existsSync)(profileRoot);
+  if (existing && !options.overwrite) {
+    throw new Error(`Imported browser profile "${name}" already exists at ${profileRoot}. Re-run with --overwrite to refresh it.`);
+  }
+  if (existing) await (0, import_promises2.rm)(profileRoot, { recursive: true, force: true });
+  await (0, import_promises2.mkdir)((0, import_node_path2.join)(userDataDir, "Default"), { recursive: true });
+  await writeNormalizedLocalState(
+    (0, import_node_path2.join)(sourceUserDataDir, "Local State"),
+    (0, import_node_path2.join)(userDataDir, "Local State"),
+    sourceProfile.chromeProfileDirectory
+  );
+  await copyProfileTree(sourceProfile.chromeProfilePath, (0, import_node_path2.join)(userDataDir, "Default"));
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const manifest = {
+    layoutVersion: 1,
+    name,
+    profileRoot,
+    userDataDir,
+    browserExecutablePath: options.browserExecutablePath?.trim() || defaultChromeExecutablePath() || null,
+    sourceUserDataDir,
+    sourceProfileDirectory: sourceProfile.chromeProfileDirectory,
+    sourceProfilePath: sourceProfile.chromeProfilePath,
+    email: sourceProfile.email,
+    displayName: sourceProfile.displayName,
+    createdAt: existingManifest?.createdAt ?? now,
+    updatedAt: now,
+    copyMode: "chrome-profile-clone"
+  };
+  await (0, import_promises2.writeFile)(manifestPath, `${JSON.stringify(manifest, null, 2)}
+`);
+  return {
+    profile: manifest,
+    sourceProfile,
+    excludedNames: EXCLUDED_PROFILE_NAMES
+  };
+}
+async function loadImportedBrowserProfile(name = process.env.MCP_SCRAPER_BROWSER_PROFILE?.trim() || "default", outputDir = defaultImportedBrowserProfilesDir()) {
+  const profileName = importedProfileName(name);
+  const manifestPath = importedProfileManifestPath(profileName, outputDir);
+  const manifest = await readExistingManifest(manifestPath);
+  if (!manifest) {
+    throw new Error(
+      `Imported browser profile "${profileName}" was not found. Run: mcp-scraper-cli browser import-chrome --name ${profileName}`
+    );
+  }
+  return manifest;
+}
+async function syncImportedChromeProfile(name, options = {}) {
+  const outputDir = options.outputDir?.trim() || defaultImportedBrowserProfilesDir();
+  const manifest = await loadImportedBrowserProfile(name, outputDir);
+  return importChromeProfile({
+    name: manifest.name,
+    sourceUserDataDir: manifest.sourceUserDataDir,
+    chromeProfileDirectory: manifest.sourceProfileDirectory,
+    outputDir,
+    overwrite: true,
+    browserExecutablePath: options.browserExecutablePath ?? manifest.browserExecutablePath ?? void 0
+  });
+}
+
 // src/cli/agent-config.ts
 function apiKeyValue(options) {
   return options.apiKey?.trim() || "sk_live_your_key";
@@ -20,18 +222,37 @@ function packageSpec(options) {
 function combinedNpxArgs(options = {}) {
   return ["-y", "-p", packageSpec(options), "mcp-scraper-combined"];
 }
+function envConfig(options) {
+  const env = { MCP_SCRAPER_API_KEY: apiKeyValue(options) };
+  const profileName = options.browserProfileName?.trim();
+  if (options.browserMode === "local") {
+    env.MCP_SCRAPER_BROWSER_MODE = "local";
+    if (profileName) env.MCP_SCRAPER_BROWSER_PROFILE = profileName;
+    const executablePath = options.browserExecutablePath?.trim();
+    if (executablePath) env.MCP_SCRAPER_BROWSER_EXECUTABLE = executablePath;
+  } else {
+    if (profileName) env.BROWSER_AGENT_PROFILE_NAME = profileName;
+    if (options.browserProfileSaveChanges === true) env.BROWSER_AGENT_PROFILE_SAVE_CHANGES = "true";
+  }
+  return env;
+}
+function tomlInlineTable(value) {
+  const entries = Object.entries(value).map(([key, item]) => `${key} = ${JSON.stringify(item)}`);
+  return `{ ${entries.join(", ")} }`;
+}
 function renderCodexConfig(options = {}) {
   return [
     "[mcp_servers.mcp-scraper]",
     'command = "npx"',
     `args = ${JSON.stringify(combinedNpxArgs(options))}`,
-    `env = { MCP_SCRAPER_API_KEY = "${apiKeyValue(options)}" }`
+    `env = ${tomlInlineTable(envConfig(options))}`
   ].join("\n");
 }
 function renderClaudeCommand(options = {}) {
+  const env = Object.entries(envConfig(options)).map(([key, value]) => `  --env ${key}=${value}`);
   return [
     "claude mcp add mcp-scraper --scope user",
-    `  --env MCP_SCRAPER_API_KEY=${apiKeyValue(options)}`,
+    ...env,
     `  -- npx ${combinedNpxArgs(options).join(" ")}`
   ].join(" \\\n");
 }
@@ -41,9 +262,7 @@ function renderClaudeDesktopConfig(options = {}) {
       "mcp-scraper": {
         command: "npx",
         args: combinedNpxArgs(options),
-        env: {
-          MCP_SCRAPER_API_KEY: apiKeyValue(options)
-        }
+        env: envConfig(options)
       }
     }
   }, null, 2);
@@ -76,9 +295,9 @@ function renderAgentInstall(host, options = {}) {
 }
 
 // src/cli/doctor.ts
-var import_promises = require("fs/promises");
-var import_node_os = require("os");
-var import_node_path = require("path");
+var import_promises3 = require("fs/promises");
+var import_node_os3 = require("os");
+var import_node_path3 = require("path");
 function status(ok, warn = false) {
   if (ok) return "pass";
   return warn ? "warn" : "fail";
@@ -87,9 +306,9 @@ function parseMajor(version) {
   return Number(version.replace(/^v/, "").split(".")[0] ?? 0);
 }
 async function readKeyFile() {
-  const path = process.env.MCP_SCRAPER_KEY_PATH?.trim() || (0, import_node_path.join)((0, import_node_os.homedir)(), ".mcp-scraper-key");
+  const path = process.env.MCP_SCRAPER_KEY_PATH?.trim() || (0, import_node_path3.join)((0, import_node_os3.homedir)(), ".mcp-scraper-key");
   try {
-    const value = (await (0, import_promises.readFile)(path, "utf8")).trim();
+    const value = (await (0, import_promises3.readFile)(path, "utf8")).trim();
     return value || null;
   } catch {
     return null;
@@ -110,7 +329,7 @@ async function npmLatest(fetchImpl) {
 async function runDoctor(options = {}) {
   const fetchImpl = options.fetchImpl ?? fetch;
   const apiUrl = (options.apiUrl ?? process.env.MCP_SCRAPER_API_URL ?? "https://mcpscraper.dev").replace(/\/$/, "");
-  const outputDir = options.outputDir ?? process.env.MCP_SCRAPER_OUTPUT_DIR ?? (0, import_node_path.join)((0, import_node_os.homedir)(), "Downloads", "mcp-scraper");
+  const outputDir = options.outputDir ?? process.env.MCP_SCRAPER_OUTPUT_DIR ?? (0, import_node_path3.join)((0, import_node_os3.homedir)(), "Downloads", "mcp-scraper");
   const configuredKey = options.apiKey?.trim() || process.env.MCP_SCRAPER_API_KEY?.trim() || await readKeyFile();
   const latest = await npmLatest(fetchImpl);
   const checks = [];
@@ -137,8 +356,8 @@ async function runDoctor(options = {}) {
     fix: configuredKey ? void 0 : "Set MCP_SCRAPER_API_KEY or pass --api-key."
   });
   try {
-    await (0, import_promises.mkdir)(outputDir, { recursive: true });
-    await (0, import_promises.access)(outputDir);
+    await (0, import_promises3.mkdir)(outputDir, { recursive: true });
+    await (0, import_promises3.access)(outputDir);
     checks.push({ id: "output_dir", label: "Output directory", status: "pass", detail: outputDir });
   } catch (err) {
     checks.push({
@@ -284,10 +503,10 @@ function renderPrompt(name) {
 }
 
 // src/workflows/artifact-writer.ts
-var import_promises2 = require("fs/promises");
-var import_node_fs = require("fs");
-var import_node_os2 = require("os");
-var import_node_path2 = require("path");
+var import_promises4 = require("fs/promises");
+var import_node_fs2 = require("fs");
+var import_node_os4 = require("os");
+var import_node_path4 = require("path");
 var import_node_child_process = require("child_process");
 
 // src/directory/csv.ts
@@ -310,7 +529,7 @@ function slugify(s) {
 
 // src/workflows/artifact-writer.ts
 function workflowOutputBaseDir(outputDir) {
-  return outputDir?.trim() || process.env.MCP_SCRAPER_OUTPUT_DIR?.trim() || (0, import_node_path2.join)((0, import_node_os2.homedir)(), "Downloads", "mcp-scraper");
+  return outputDir?.trim() || process.env.MCP_SCRAPER_OUTPUT_DIR?.trim() || (0, import_node_path4.join)((0, import_node_os4.homedir)(), "Downloads", "mcp-scraper");
 }
 function timestamp() {
   return (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
@@ -341,31 +560,31 @@ var ArtifactWriter = class _ArtifactWriter {
     const runId = forcedRunId?.trim() || `${timestamp()}-${safeSlug(workflowId)}-${Math.random().toString(36).slice(2, 8)}`;
     const nameSource = String(input.keyword ?? input.query ?? input.domain ?? input.state ?? workflowId);
     const baseDir = workflowOutputBaseDir(outputDir);
-    const runDir = (0, import_node_path2.join)(baseDir, "workflows", workflowId, `${timestamp()}-${safeSlug(nameSource)}-${safeSlug(runId).slice(0, 20)}`);
-    await (0, import_promises2.mkdir)(runDir, { recursive: true });
+    const runDir = (0, import_node_path4.join)(baseDir, "workflows", workflowId, `${timestamp()}-${safeSlug(nameSource)}-${safeSlug(runId).slice(0, 20)}`);
+    await (0, import_promises4.mkdir)(runDir, { recursive: true });
     return new _ArtifactWriter(workflowId, title, runId, baseDir, runDir, startedAt, input);
   }
   async remember(kind, label, path, rows) {
-    const size = await (0, import_promises2.stat)(path).then((s) => s.size).catch(() => void 0);
+    const size = await (0, import_promises4.stat)(path).then((s) => s.size).catch(() => void 0);
     this.artifacts.push({ kind, label, path, bytes: size, rows });
     return path;
   }
   async writeJson(label, relativePath, data) {
-    const path = (0, import_node_path2.join)(this.runDir, relativePath);
-    await (0, import_promises2.mkdir)((0, import_node_path2.dirname)(path), { recursive: true });
-    await (0, import_promises2.writeFile)(path, JSON.stringify(data, null, 2), "utf8");
+    const path = (0, import_node_path4.join)(this.runDir, relativePath);
+    await (0, import_promises4.mkdir)((0, import_node_path4.dirname)(path), { recursive: true });
+    await (0, import_promises4.writeFile)(path, JSON.stringify(data, null, 2), "utf8");
     return this.remember("json", label, path);
   }
   async writeText(label, relativePath, text, kind = "markdown") {
-    const path = (0, import_node_path2.join)(this.runDir, relativePath);
-    await (0, import_promises2.mkdir)((0, import_node_path2.dirname)(path), { recursive: true });
-    await (0, import_promises2.writeFile)(path, text, "utf8");
+    const path = (0, import_node_path4.join)(this.runDir, relativePath);
+    await (0, import_promises4.mkdir)((0, import_node_path4.dirname)(path), { recursive: true });
+    await (0, import_promises4.writeFile)(path, text, "utf8");
     return this.remember(kind, label, path);
   }
   async writeCsv(label, relativePath, headers, rows) {
-    const path = (0, import_node_path2.join)(this.runDir, relativePath);
-    await (0, import_promises2.mkdir)((0, import_node_path2.dirname)(path), { recursive: true });
-    await (0, import_promises2.writeFile)(path, rowsToCsv(headers, rows), "utf8");
+    const path = (0, import_node_path4.join)(this.runDir, relativePath);
+    await (0, import_promises4.mkdir)((0, import_node_path4.dirname)(path), { recursive: true });
+    await (0, import_promises4.writeFile)(path, rowsToCsv(headers, rows), "utf8");
     return this.remember("csv", label, path, rows.length);
   }
   async writeHtml(label, relativePath, html) {
@@ -385,20 +604,20 @@ var ArtifactWriter = class _ArtifactWriter {
       errors,
       counts
     };
-    const path = (0, import_node_path2.join)(this.runDir, "manifest.json");
-    await (0, import_promises2.writeFile)(path, JSON.stringify(manifest, null, 2), "utf8");
+    const path = (0, import_node_path4.join)(this.runDir, "manifest.json");
+    await (0, import_promises4.writeFile)(path, JSON.stringify(manifest, null, 2), "utf8");
     await updateWorkflowIndex(manifest, path, this.baseDir);
     return path;
   }
 };
 function indexPath(baseDir = workflowOutputBaseDir()) {
-  return (0, import_node_path2.join)(baseDir, "workflows", "index.json");
+  return (0, import_node_path4.join)(baseDir, "workflows", "index.json");
 }
 async function readIndex(baseDir) {
   const path = indexPath(baseDir);
-  if (!(0, import_node_fs.existsSync)(path)) return { runs: [] };
+  if (!(0, import_node_fs2.existsSync)(path)) return { runs: [] };
   try {
-    return JSON.parse(await (0, import_promises2.readFile)(path, "utf8"));
+    return JSON.parse(await (0, import_promises4.readFile)(path, "utf8"));
   } catch {
     return { runs: [] };
   }
@@ -418,8 +637,8 @@ async function updateWorkflowIndex(manifest, manifestPath, baseDir) {
     summary: `${manifest.title} (${manifest.status})`
   };
   index.runs = [entry, ...index.runs.filter((r) => r.runId !== manifest.runId)].slice(0, 200);
-  await (0, import_promises2.mkdir)((0, import_node_path2.dirname)(path), { recursive: true });
-  await (0, import_promises2.writeFile)(path, JSON.stringify(index, null, 2), "utf8");
+  await (0, import_promises4.mkdir)((0, import_node_path4.dirname)(path), { recursive: true });
+  await (0, import_promises4.writeFile)(path, JSON.stringify(index, null, 2), "utf8");
 }
 async function listWorkflowReports(outputDir) {
   return (await readIndex(workflowOutputBaseDir(outputDir))).runs;
@@ -432,7 +651,7 @@ async function findWorkflowReport(id, outputDir) {
 async function openWorkflowReport(id, outputDir) {
   const run = await findWorkflowReport(id, outputDir);
   if (!run?.reportPath) throw new Error(`No report found for "${id}"`);
-  if ((0, import_node_os2.platform)() === "darwin") {
+  if ((0, import_node_os4.platform)() === "darwin") {
     await new Promise((resolve, reject) => {
       (0, import_node_child_process.execFile)("open", [run.reportPath], (err) => err ? reject(err) : resolve());
     });
@@ -441,7 +660,7 @@ async function openWorkflowReport(id, outputDir) {
 }
 
 // src/workflows/registry.ts
-var import_promises3 = require("fs/promises");
+var import_promises5 = require("fs/promises");
 var import_zod6 = require("zod");
 
 // src/workflows/http-client.ts
@@ -2100,11 +2319,87 @@ function buildHumanCli() {
       result.next_step ?? "Complete checkout, then retry the MCP request."
     ].join("\n"), false);
   });
+  const browser = program.command("browser").description("Inspect and manage browser-agent profile setup helpers.");
+  browser.command("profiles").description("List local Chrome profiles and suggested managed browser profile names.").option("--email <email>", "Filter by Chrome account email or displayed profile name").option("--user-data-dir <path>", "Chrome user data directory").option("--json", "Print machine-readable JSON").action(async (opts) => {
+    const profiles = await listLocalChromeProfiles(opts.userDataDir, opts.email);
+    if (opts.json) {
+      writeOutput({ profiles }, true);
+      return;
+    }
+    if (!profiles.length) {
+      writeOutput("No matching Chrome profiles found.", false);
+      return;
+    }
+    const lines = [
+      "Local Chrome profiles:",
+      ...profiles.map((profile) => [
+        `${profile.email || "(no email)"}	${profile.chromeProfileDirectory}	${profile.displayName}`,
+        `  suggested profile name: ${profile.recommendedKernelProfileName}`,
+        `  local Chrome path: ${profile.chromeProfilePath}`
+      ].join("\n")),
+      "",
+      "To clone a real local Chrome profile for MCP local browser mode:",
+      "  mcp-scraper-cli browser import-chrome --email you@example.com --name <suggested profile name>",
+      "Then generate config with:",
+      "  mcp-scraper-cli agent install claude-desktop --browser-mode local --browser-profile <suggested profile name>"
+    ];
+    writeOutput(lines.join("\n"), false);
+  });
+  browser.command("import-chrome").description("Clone a local Chrome profile into MCP Scraper managed local browser storage.").option("--email <email>", "Chrome account email or displayed profile name to import").option("--name <name>", "Managed MCP Scraper browser profile name").option("--chrome-profile <directory>", "Chrome profile directory, for example Default or Profile 1").option("--user-data-dir <path>", "Source Chrome user data directory").option("--output-dir <path>", "Managed profile base directory").option("--browser-executable <path>", "Chrome executable path for local launches").option("--overwrite", "Overwrite an existing managed profile clone").option("--json", "Print machine-readable JSON").action(async (opts) => {
+    const result = await importChromeProfile({
+      email: opts.email,
+      name: opts.name,
+      chromeProfileDirectory: opts.chromeProfile,
+      sourceUserDataDir: opts.userDataDir,
+      outputDir: opts.outputDir,
+      browserExecutablePath: opts.browserExecutable,
+      overwrite: opts.overwrite
+    });
+    if (opts.json) {
+      writeOutput(result, true);
+      return;
+    }
+    writeOutput([
+      `Imported Chrome profile: ${result.profile.name}`,
+      `Source: ${result.sourceProfile.email || result.sourceProfile.displayName || result.sourceProfile.chromeProfileDirectory} (${result.sourceProfile.chromeProfileDirectory})`,
+      `Managed user data dir: ${result.profile.userDataDir}`,
+      "",
+      "Install/config command:",
+      `  mcp-scraper-cli agent install codex --browser-mode local --browser-profile ${result.profile.name}`,
+      "",
+      "Restart the MCP client after updating config. Re-run sync-profile after signing into new sites in normal Chrome."
+    ].join("\n"), false);
+  });
+  browser.command("sync-profile <name>").description("Refresh a managed local browser profile from its recorded source Chrome profile.").option("--output-dir <path>", "Managed profile base directory").option("--browser-executable <path>", "Chrome executable path for local launches").option("--json", "Print machine-readable JSON").action(async (name, opts) => {
+    const result = await syncImportedChromeProfile(name, {
+      outputDir: opts.outputDir,
+      browserExecutablePath: opts.browserExecutable
+    });
+    if (opts.json) {
+      writeOutput(result, true);
+      return;
+    }
+    writeOutput([
+      `Synced Chrome profile: ${result.profile.name}`,
+      `Source: ${result.sourceProfile.email || result.sourceProfile.displayName || result.sourceProfile.chromeProfileDirectory} (${result.sourceProfile.chromeProfileDirectory})`,
+      `Managed user data dir: ${result.profile.userDataDir}`,
+      "Restart any local browser sessions that were using this profile."
+    ].join("\n"), false);
+  });
   const agent = program.command("agent").description("Generate AI-agent install configs and workflow prompts.");
-  agent.command("install <host>").description("Print install/config instructions for codex, claude, or claude-desktop.").option("--api-key <key>", "API key to place in generated config").option("--package <spec>", "npm package spec", "mcp-scraper@latest").option("--json", "Print machine-readable JSON").action((host, opts) => {
+  agent.command("install <host>").description("Print install/config instructions for codex, claude, or claude-desktop.").option("--api-key <key>", "API key to place in generated config").option("--package <spec>", "npm package spec", "mcp-scraper@latest").option("--browser-mode <mode>", "Browser mode: hosted or local", "hosted").option("--browser-profile <name>", "Default browser profile for browser_open sessions. In local mode this is a managed MCP Scraper profile name; in hosted mode it is a Kernel profile name.").option("--browser-executable <path>", "Chrome executable path for local browser mode").option("--save-browser-profile-changes", "Persist cookies/local storage back to the named browser profile when sessions close").option("--json", "Print machine-readable JSON").action((host, opts) => {
     const valid = ["codex", "claude", "claude-desktop"];
     if (!valid.includes(host)) throw new Error(`Unknown host "${host}". Use: ${valid.join(", ")}`);
-    const text = renderAgentInstall(host, { apiKey: opts.apiKey, packageSpec: opts.package });
+    const browserMode = String(opts.browserMode ?? "hosted");
+    if (!["hosted", "local"].includes(browserMode)) throw new Error("Unknown browser mode. Use: hosted or local");
+    const text = renderAgentInstall(host, {
+      apiKey: opts.apiKey,
+      packageSpec: opts.package,
+      browserMode,
+      browserProfileName: opts.browserProfile,
+      browserProfileSaveChanges: opts.saveBrowserProfileChanges,
+      browserExecutablePath: opts.browserExecutable
+    });
     writeOutput(opts.json ? { host, text } : text, opts.json);
   });
   agent.command("prompt [name]").description("Print an agent prompt template.").option("--json", "Print machine-readable JSON").action((name, opts) => {
@@ -2191,14 +2486,14 @@ ${summary.warnings.map((w) => `- ${w}`).join("\n")}` : ""
   runs.command("download <id>").description("Download hosted workflow run artifacts.").option("--api-key <key>", "MCP Scraper API key").option("--api-url <url>", "MCP Scraper API URL", "https://mcpscraper.dev").option("--output-dir <path>", "Download directory").option("--json", "Print machine-readable JSON").action(async (id, opts) => {
     const result = await apiRequest(`/workflows/runs/${id}`, "GET", opts);
     const { apiUrl, apiKey } = apiOptions(opts);
-    const outDir = (0, import_node_path3.join)(opts.outputDir ?? workflowOutputBaseDir(), "workflow-downloads", id);
-    await (0, import_promises4.mkdir)(outDir, { recursive: true });
+    const outDir = (0, import_node_path5.join)(opts.outputDir ?? workflowOutputBaseDir(), "workflow-downloads", id);
+    await (0, import_promises6.mkdir)(outDir, { recursive: true });
     const downloaded = [];
     for (const artifact of result.run.artifacts ?? []) {
       const res = await fetch(`${apiUrl}/workflows/runs/${id}/artifacts/${artifact.id}`, { headers: { "x-api-key": apiKey } });
       if (!res.ok) throw new Error(`Failed to download ${artifact.label}: HTTP ${res.status}`);
-      const file = (0, import_node_path3.join)(outDir, (0, import_node_path3.basename)(artifact.path));
-      await (0, import_promises4.writeFile)(file, Buffer.from(await res.arrayBuffer()));
+      const file = (0, import_node_path5.join)(outDir, (0, import_node_path5.basename)(artifact.path));
+      await (0, import_promises6.writeFile)(file, Buffer.from(await res.arrayBuffer()));
       downloaded.push(file);
     }
     writeOutput(opts.json ? { runId: id, files: downloaded } : downloaded.join("\n"), opts.json);