mcp-scraper 0.2.23 → 0.2.24

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

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   buildBrowserAgentMcpServer
-} from "../chunk-IXUMOR3H.js";
+} from "../chunk-4TNQUYP7.js";
 import "../chunk-WN7PBKMV.js";
 import "../chunk-DUEW4EOO.js";
-import "../chunk-TEBDAK63.js";
+import "../chunk-ISIITOAL.js";
 
 // bin/browser-agent-stdio-server.ts
 import { readFileSync } from "fs";

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

@@ -8,7 +8,7 @@ var import_promises6 = require("fs/promises");
 var import_node_path5 = require("path");
 
 // src/version.ts
-var PACKAGE_VERSION = "0.2.23";
+var PACKAGE_VERSION = "0.2.24";
 
 // src/lib/chrome-profiles.ts
 var import_promises = require("fs/promises");
@@ -256,6 +256,22 @@ function renderClaudeCommand(options = {}) {
     `  -- npx ${combinedNpxArgs(options).join(" ")}`
   ].join(" \\\n");
 }
+function claudeMcpRemoveArgs() {
+  return ["mcp", "remove", "mcp-scraper", "-s", "user"];
+}
+function claudeMcpAddArgs(options = {}) {
+  const args = ["mcp", "add", "mcp-scraper", "--scope", "user"];
+  for (const [key, value] of Object.entries(envConfig(options))) {
+    args.push("--env", `${key}=${value}`);
+  }
+  args.push("--", "npx", ...combinedNpxArgs(options));
+  return args;
+}
+function normalizeAgentHost(host) {
+  if (host === "claude-code") return "claude";
+  if (host === "claude" || host === "codex" || host === "claude-desktop") return host;
+  throw new Error('Unknown host "' + host + '". Use: codex, claude, claude-code, or claude-desktop');
+}
 function renderClaudeDesktopConfig(options = {}) {
   return JSON.stringify({
     mcpServers: {
@@ -268,8 +284,10 @@ function renderClaudeDesktopConfig(options = {}) {
   }, null, 2);
 }
 function renderAgentInstall(host, options = {}) {
+  const normalizedHost = normalizeAgentHost(host);
   const restart = "Restart the MCP client so it starts a fresh npx process.";
-  if (host === "codex") {
+  const applyCommand = `MCP_SCRAPER_API_KEY=${apiKeyValue(options)} npx -y -p mcp-scraper@latest mcp-scraper-cli agent install claude --apply`;
+  if (normalizedHost === "codex") {
     return [
       "# Codex MCP config",
       renderCodexConfig(options),
@@ -277,11 +295,14 @@ function renderAgentInstall(host, options = {}) {
       restart
     ].join("\n");
   }
-  if (host === "claude") {
+  if (normalizedHost === "claude") {
     return [
       "# Claude Code command",
       renderClaudeCommand(options),
       "",
+      "# One-command Claude Code setup",
+      applyCommand,
+      "",
       restart
     ].join("\n");
   }
@@ -2239,6 +2260,34 @@ function writeOutput(data, json) {
 `);
   }
 }
+function maskSecrets(value) {
+  return value.replace(/sk_[A-Za-z0-9_-]+/g, "sk_***");
+}
+function runLocalCommand(command, args) {
+  return new Promise((resolve) => {
+    const child = (0, import_node_child_process2.spawn)(command, args, { stdio: ["ignore", "pipe", "pipe"] });
+    const stdout = [];
+    const stderr = [];
+    let settled = false;
+    const done = (result) => {
+      if (settled) return;
+      settled = true;
+      resolve(result);
+    };
+    child.stdout.on("data", (chunk) => stdout.push(Buffer.from(chunk)));
+    child.stderr.on("data", (chunk) => stderr.push(Buffer.from(chunk)));
+    child.on("error", (err) => {
+      done({ code: 127, stdout: "", stderr: err.message });
+    });
+    child.on("close", (code) => {
+      done({
+        code: typeof code === "number" ? code : 1,
+        stdout: Buffer.concat(stdout).toString("utf8"),
+        stderr: Buffer.concat(stderr).toString("utf8")
+      });
+    });
+  });
+}
 function cadenceOpt(opts) {
   if (opts.daily) return "daily";
   if (opts.monthly) return "monthly";
@@ -2340,8 +2389,8 @@ function buildHumanCli() {
       "",
       "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>"
+      "Then apply Claude Code config with:",
+      "  MCP_SCRAPER_API_KEY=sk_live_your_key mcp-scraper-cli agent install claude --apply --browser-mode local --browser-profile <suggested profile name>"
     ];
     writeOutput(lines.join("\n"), false);
   });
@@ -2365,9 +2414,9 @@ function buildHumanCli() {
       `Managed user data dir: ${result.profile.userDataDir}`,
       "",
       "Install/config command:",
-      `  mcp-scraper-cli agent install codex --browser-mode local --browser-profile ${result.profile.name}`,
+      `  MCP_SCRAPER_API_KEY=sk_live_your_key mcp-scraper-cli agent install claude --apply --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."
+      "Fully exit Claude Code and start a new Claude terminal after applying 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) => {
@@ -2387,11 +2436,62 @@ function buildHumanCli() {
     ].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("--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(", ")}`);
+  agent.command("install <host>").description("Print or apply install/config instructions for codex, claude/claude-code, 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("--apply", "Apply the config to the local client when supported. For Claude Code, this upserts the user-scope mcp-scraper server.").option("--json", "Print machine-readable JSON").action(async (hostInput, opts) => {
+    const host = normalizeAgentHost(hostInput);
     const browserMode = String(opts.browserMode ?? "hosted");
     if (!["hosted", "local"].includes(browserMode)) throw new Error("Unknown browser mode. Use: hosted or local");
+    const apiKey = opts.apiKey ?? process.env.MCP_SCRAPER_API_KEY;
+    if (opts.apply) {
+      if (host !== "claude") throw new Error('--apply is currently supported for Claude Code only. Use host "claude" or "claude-code".');
+      if (!apiKey?.trim()) {
+        throw new Error("MCP_SCRAPER_API_KEY is required for --apply. Set it in the environment or pass --api-key.");
+      }
+      const configOptions = {
+        apiKey,
+        packageSpec: opts.package,
+        browserMode,
+        browserProfileName: opts.browserProfile,
+        browserProfileSaveChanges: opts.saveBrowserProfileChanges,
+        browserExecutablePath: opts.browserExecutable
+      };
+      const remove = await runLocalCommand("claude", claudeMcpRemoveArgs());
+      const add = await runLocalCommand("claude", claudeMcpAddArgs(configOptions));
+      if (add.code !== 0) {
+        const reason = maskSecrets([add.stderr, add.stdout].filter(Boolean).join("\n").trim());
+        throw new Error([
+          "Claude Code MCP registration failed.",
+          reason || "No error output returned.",
+          "Make sure Claude Code is installed and the `claude` command is on PATH."
+        ].join("\n"));
+      }
+      const list = await runLocalCommand("claude", ["mcp", "list"]);
+      const result = {
+        host: "claude",
+        applied: true,
+        replacedExisting: remove.code === 0,
+        command: "npx",
+        args: ["-y", "-p", opts.package, "mcp-scraper-combined"],
+        nextStep: "Fully exit Claude Code, start a new Claude terminal, then run: claude mcp list",
+        list: maskSecrets([list.stdout, list.stderr].filter(Boolean).join("\n").trim())
+      };
+      if (opts.json) {
+        writeOutput(result, true);
+        return;
+      }
+      writeOutput([
+        "Applied Claude Code MCP config: mcp-scraper",
+        remove.code === 0 ? "Replaced existing mcp-scraper entry." : "No existing mcp-scraper entry found; added a new one.",
+        "Command: npx -y -p " + opts.package + " mcp-scraper-combined",
+        browserMode === "local" && opts.browserProfile ? `Local browser profile: ${opts.browserProfile}` : "",
+        "",
+        "Next step: fully exit Claude Code, start a new Claude terminal, then run:",
+        "  claude mcp list",
+        "",
+        result.list ? `Current Claude MCP list:
+${result.list}` : ""
+      ].filter(Boolean).join("\n"), false);
+      return;
+    }
     const text = renderAgentInstall(host, {
       apiKey: opts.apiKey,
       packageSpec: opts.package,