mcp-scraper 0.88.2 → 0.89.0

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

@@ -1,757 +1,40 @@
 #!/usr/bin/env node
-import {
-  findWorkflowReport,
-  listWorkflowDefinitions,
-  listWorkflowReports,
-  openWorkflowReport,
-  runWorkflow,
-  workflowOutputBaseDir
-} from "../chunk-UZPTGUDV.js";
-import "../chunk-RJ7JVYKU.js";
-import "../chunk-GXBZXWXB.js";
-import {
-  XRAY_INSTALL_CONTRACT,
-  XRAY_INSTALL_PROTOCOL_DIGEST,
-  XRAY_INSTALL_PROTOCOL_VERSION,
-  renderXraySetupPrompt,
-  xrayHostRecipe
-} from "../chunk-P7FWOMU7.js";
-import "../chunk-GGZEC22A.js";
-import {
-  PACKAGE_VERSION
-} from "../chunk-K45K75OF.js";
-
-// src/cli/human-cli.ts
-import { Command } from "commander";
-import { spawn } from "child_process";
-import { mkdir as mkdir2, writeFile } from "fs/promises";
-import { basename, join as join2 } from "path";
-
-// src/cli/agent-config.ts
-function apiKeyValue(options) {
-  return options.apiKey?.trim() || "sk_live_your_key";
-}
-function packageSpec(options) {
-  return options.packageSpec?.trim() || "mcp-scraper@latest";
-}
-function combinedNpxArgs(options = {}) {
-  return ["-y", "--package", packageSpec(options), "mcp-scraper"];
-}
-function envConfig(options) {
-  const env = { MCP_SCRAPER_API_KEY: apiKeyValue(options) };
-  const profileName = options.browserProfileName?.trim();
-  if (profileName) env.BROWSER_AGENT_PROFILE_NAME = profileName;
-  if (options.browserProfileSaveChanges === true) env.BROWSER_AGENT_PROFILE_SAVE_CHANGES = "true";
-  return env;
-}
-function claudeMcpRemoveArgs() {
-  return ["mcp", "remove", "mcp-scraper", "-s", "user"];
-}
-function claudeMcpGetArgs() {
-  return ["mcp", "get", "mcp-scraper"];
-}
-function parseClaudeMcpGet(stdout) {
-  const command = stdout.match(/^\s*Command:\s*(.+?)\s*$/m)?.[1];
-  if (!command) return null;
-  const argLine = stdout.match(/^\s*Args:\s*(.*?)\s*$/m)?.[1] ?? "";
-  const args = argLine.length ? argLine.split(/\s+/) : [];
-  const env = {};
-  const envBlock = stdout.split(/^\s*Environment:\s*$/m)[1];
-  if (envBlock) {
-    for (const line of envBlock.split("\n")) {
-      const pair = line.match(/^\s{2,}([A-Za-z_][A-Za-z0-9_]*)=(.*)$/);
-      if (!pair) {
-        if (line.trim().length && !/^\s{2,}/.test(line)) break;
-        continue;
-      }
-      env[pair[1]] = pair[2];
-    }
-  }
-  return { command, args, env };
-}
-function claudeMcpRestoreArgs(snapshot) {
-  const args = ["mcp", "add", "mcp-scraper", "--scope", "user"];
-  for (const [key, value] of Object.entries(snapshot.env)) {
-    args.push("--env", `${key}=${value}`);
-  }
-  args.push("--", snapshot.command, ...snapshot.args);
-  return args;
-}
-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" || XRAY_INSTALL_CONTRACT.hosts.some((candidate) => candidate.id === host)) return host;
-  throw new Error('Unknown host "' + host + '". Use: codex, claude, claude-code, claude-desktop, cursor, windsurf, cline, or user-action-only');
-}
-function agentHostCapability(host) {
-  return xrayHostRecipe(host === "claude" ? "claude-code" : host);
-}
-function renderAgentInstall(host, _options = {}) {
-  const normalizedHost = normalizeAgentHost(host);
-  const recipe = agentHostCapability(normalizedHost);
-  const restart = "Restart the MCP client so it starts a fresh npx process.";
-  const applyCommand = 'MCP_SCRAPER_API_KEY="$MCP_SCRAPER_API_KEY" npx -y -p mcp-scraper@latest mcp-scraper-cli agent install claude --apply';
-  const protocol = `X-Ray install protocol: ${XRAY_INSTALL_PROTOCOL_VERSION} (${XRAY_INSTALL_PROTOCOL_DIGEST})`;
-  if (normalizedHost === "codex") {
-    return [
-      "# Codex MCP config",
-      protocol,
-      recipe.exactConfig,
-      "",
-      `Continuation: ${recipe.continuation}`,
-      `Rollback: ${recipe.rollback}`,
-      "",
-      restart
-    ].join("\n");
-  }
-  if (normalizedHost === "claude") {
-    return [
-      "# Claude Code command",
-      protocol,
-      recipe.exactConfig,
-      "",
-      "# One-command Claude Code setup",
-      applyCommand,
-      "",
-      `Continuation: ${recipe.continuation}`,
-      `Rollback: ${recipe.rollback}`,
-      "",
-      restart
-    ].join("\n");
-  }
-  if (normalizedHost === "claude-desktop") {
-    return [
-      "# Claude Desktop config",
-      protocol,
-      recipe.exactConfig,
-      "",
-      "Desktop Extension: https://mcpscraper.dev/downloads/mcp-scraper.mcpb",
-      `Continuation: ${recipe.continuation}`,
-      `Rollback: ${recipe.rollback}`,
-      restart
-    ].join("\n");
-  }
-  return [
-    `# ${recipe.label} MCP config`,
-    protocol,
-    recipe.exactConfig,
-    "",
-    `Continuation: ${recipe.continuation}`,
-    `Rollback: ${recipe.rollback}`,
-    ...recipe.restartRequired ? ["", restart] : []
-  ].join("\n");
-}
-
-// src/cli/doctor.ts
-import { access, mkdir, readFile } from "fs/promises";
-import { homedir } from "os";
-import { join } from "path";
-function status(ok, warn = false) {
-  if (ok) return "pass";
-  return warn ? "warn" : "fail";
-}
-function parseMajor(version) {
-  return Number(version.replace(/^v/, "").split(".")[0] ?? 0);
-}
-async function readKeyFile() {
-  const path = process.env.MCP_SCRAPER_KEY_PATH?.trim() || join(homedir(), ".mcp-scraper-key");
-  try {
-    const value = (await readFile(path, "utf8")).trim();
-    return value || null;
-  } catch {
-    return null;
-  }
-}
-async function npmLatest(fetchImpl) {
-  try {
-    const res = await fetchImpl("https://registry.npmjs.org/mcp-scraper/latest", {
-      signal: AbortSignal.timeout(5e3)
-    });
-    if (!res.ok) return null;
-    const data = await res.json();
-    return data.version ?? null;
-  } catch {
-    return null;
-  }
-}
-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 ?? join(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 = [];
-  const nodeMajor = parseMajor(process.version);
-  checks.push({
-    id: "node",
-    label: "Node.js",
-    status: status(nodeMajor >= 20),
-    detail: process.version,
-    fix: nodeMajor >= 20 ? void 0 : "Install Node.js 20 or newer."
-  });
-  checks.push({
-    id: "package_version",
-    label: "Local package",
-    status: latest && latest !== PACKAGE_VERSION ? "warn" : "pass",
-    detail: latest ? `local ${PACKAGE_VERSION}, npm latest ${latest}` : `local ${PACKAGE_VERSION}, npm latest unavailable`,
-    fix: latest && latest !== PACKAGE_VERSION ? "Use mcp-scraper@latest and restart the MCP client." : void 0
-  });
-  checks.push({
-    id: "api_key",
-    label: "API key",
-    status: configuredKey ? "pass" : "warn",
-    detail: configuredKey ? "configured" : "not configured",
-    fix: configuredKey ? void 0 : "Set MCP_SCRAPER_API_KEY or pass --api-key."
-  });
-  try {
-    await mkdir(outputDir, { recursive: true });
-    await access(outputDir);
-    checks.push({ id: "output_dir", label: "Output directory", status: "pass", detail: outputDir });
-  } catch (err) {
-    checks.push({
-      id: "output_dir",
-      label: "Output directory",
-      status: "fail",
-      detail: outputDir,
-      fix: err instanceof Error ? err.message : "Create a writable output directory."
-    });
-  }
-  if (configuredKey) {
-    try {
-      const res = await fetchImpl(`${apiUrl}/me`, {
-        headers: { "x-api-key": configuredKey },
-        signal: AbortSignal.timeout(8e3)
-      });
-      checks.push({
-        id: "api_reachability",
-        label: "Hosted API",
-        status: res.ok ? "pass" : "fail",
-        detail: `${apiUrl}/me returned ${res.status}`,
-        fix: res.ok ? void 0 : "Verify the API key and account status."
-      });
-    } catch (err) {
-      checks.push({
-        id: "api_reachability",
-        label: "Hosted API",
-        status: "fail",
-        detail: err instanceof Error ? err.message : String(err),
-        fix: "Check network access and MCP_SCRAPER_API_URL."
-      });
-    }
-  } else {
-    checks.push({
-      id: "api_reachability",
-      label: "Hosted API",
-      status: "skip",
-      detail: "skipped because no API key is configured"
-    });
-  }
-  checks.push({
-    id: "mcp_config",
-    label: "MCP command",
-    status: "pass",
-    detail: `npx ${combinedNpxArgs().join(" ")}`,
-    fix: "Restart the MCP client after package updates."
-  });
-  return {
-    ok: checks.every((check) => check.status === "pass" || check.status === "skip"),
-    version: PACKAGE_VERSION,
-    npmLatest: latest,
-    checks,
-    recommendedConfig: {
-      command: "npx",
-      args: combinedNpxArgs(),
-      env: { MCP_SCRAPER_API_KEY: configuredKey ? "$MCP_SCRAPER_API_KEY" : "sk_live_your_key" }
-    }
-  };
-}
-function renderDoctor(output) {
-  const icon = { pass: "PASS", warn: "WARN", fail: "FAIL", skip: "SKIP" };
-  const lines = [
-    `mcp-scraper doctor v${output.version}`,
-    "",
-    ...output.checks.map((check) => {
-      const fix = check.fix ? `
-    Fix: ${check.fix}` : "";
-      return `[${icon[check.status]}] ${check.label}: ${check.detail}${fix}`;
-    }),
-    "",
-    `Recommended MCP command: npx ${output.recommendedConfig.args.join(" ")}`
-  ];
-  return lines.join("\n");
-}
-
-// src/cli/prompts.ts
-var AGENT_PROMPTS = {
-  "xray-setup": renderXraySetupPrompt(),
-  "agent-packet": [
-    "# MCP Scraper Agent Packet Prompt",
-    "",
-    "Use MCP Scraper as the evidence layer. Run the agent-packet workflow for the target keyword/domain, then treat `evidence.json`, `sources.csv`, and `competitors.csv` as source of truth.",
-    "",
-    "Do not invent citations. If a recommendation is not supported by the packet, mark it as an assumption. Turn the evidence into a concise SEO brief, an implementation task list, and content recommendations tied to source rows."
-  ].join("\n"),
-  "local-competitive-audit": [
-    "# MCP Scraper Local Competitive Audit Prompt",
-    "",
-    "Run the local-competitive-audit workflow for the niche and markets. Use the city summary, competitor CSV, and review-insight CSV to identify market difficulty, review themes, GBP category patterns, and weak competitors.",
-    "",
-    "Ground recommendations in Maps rank position, review count, star rating, categories, profile details, and review topics. Do not overstate heuristic opportunity scores."
-  ].join("\n"),
-  "directory-workflow": [
-    "# MCP Scraper Directory Workflow Prompt",
-    "",
-    "Use directory_workflow when the user wants cities selected by population and Google Maps candidates per city. Keep query and location separate. Preserve result_position, source_location, review stars/count, categories, and profile URLs for downstream CSV or directory use."
-  ].join("\n"),
-  "map-comparison": [
-    "# MCP Scraper Maps Comparison Prompt",
-    "",
-    "Run the map-comparison workflow when the user wants to compare local Maps competitors in a city or across selected markets. Use `maps-results.csv`, `map-comparison.csv`, and `profile-insights.csv` as source of truth.",
-    "",
-    "Ground recommendations in result_position, review_stars, review_count, category, website presence, review topics, and profile attributes. Treat review gaps and missing websites as opportunity signals, not guaranteed ranking factors."
-  ].join("\n"),
-  "serp-comparison": [
-    "# MCP Scraper SERP Comparison Prompt",
-    "",
-    "Run the serp-comparison workflow when the user wants to know why competitors outrank a page or what the SERP rewards. Use organic results, extracted page headings, PAA questions, and AI Overview citations before making recommendations.",
-    "",
-    "Tie each recommendation to `content-gaps.csv`, `page-comparison.csv`, `paa-questions.csv`, or `ai-overview-citations.csv`. Do not invent missing sections or citations."
-  ].join("\n"),
-  "paa-expansion-brief": [
-    "# MCP Scraper PAA Expansion Brief Prompt",
-    "",
-    "Run the paa-expansion-brief workflow when the user wants to figure out what to write from People Also Ask expansion. Use `section-map.csv` to structure the brief and `paa-questions.csv` for exact customer-language headings.",
-    "",
-    "Answer the highest-priority questions directly, preserve source URLs when present, and separate evidence-backed sections from assumptions."
-  ].join("\n"),
-  "ai-overview-language": [
-    "# MCP Scraper AI Overview Language Prompt",
-    "",
-    "Run the ai-overview-language workflow when the user wants to know how to phrase content for AI Overview inclusion. Use `claim-patterns.csv`, `language-guidance.csv`, `ai-overview-citations.csv`, and PAA follow-ups as evidence.",
-    "",
-    "Recommend concise answer blocks, criteria/step language, citation hooks, and follow-up sections. Do not claim the target will be cited; frame the output as evidence-based language guidance."
-  ].join("\n"),
-  "ai-citation-monitor": [
-    "# MCP Scraper AI Citation Monitor Prompt",
-    "",
-    "Use search_serp and harvest_paa to check whether the target brand/domain appears in AI Overview citations, organic results, People Also Ask sources, local pack, forums, and videos. Save evidence before summarizing trends or gaps."
-  ].join("\n"),
-  "serp-brief": [
-    "# MCP Scraper SERP Brief Prompt",
-    "",
-    "Use live SERP, PAA, AI Overview, forum, video, and source evidence to create a writer brief. Tie each recommended section to evidence rows and identify missing proof, entities, comparisons, and customer questions."
-  ].join("\n")
-};
-function listPrompts() {
-  return Object.keys(AGENT_PROMPTS).sort();
-}
-function renderPrompt(name) {
-  const prompt = AGENT_PROMPTS[name];
-  if (!prompt) throw new Error(`Unknown prompt "${name}". Available: ${listPrompts().join(", ")}`);
-  return prompt;
-}
-
-// src/cli/human-cli.ts
-function numberOpt(value) {
-  if (value === void 0 || value === null || value === "") return void 0;
-  const parsed = Number(value);
-  return Number.isFinite(parsed) ? parsed : void 0;
-}
-function booleanOpt(value) {
-  if (value === void 0) return void 0;
-  if (typeof value === "boolean") return value;
-  if (value === "true") return true;
-  if (value === "false") return false;
-  return void 0;
-}
-function compactInput(input) {
-  return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== void 0));
-}
-function workflowInput(id, opts) {
-  if (id === "agent-packet" || id === "serp-comparison" || id === "ai-overview-language") {
-    return compactInput({
-      keyword: opts.keyword,
-      domain: opts.domain,
-      url: opts.url,
-      location: opts.location,
-      maxResults: numberOpt(opts.maxResults),
-      maxQuestions: numberOpt(opts.maxQuestions),
-      extractTop: numberOpt(opts.extractTop),
-      includeSerp: opts.serp === false ? false : void 0,
-      includePaa: opts.paa === false ? false : void 0,
-      includeAiOverview: booleanOpt(opts.includeAiOverview),
-      returnPartial: opts.returnPartial === false ? false : void 0
-    });
-  }
-  if (id === "paa-expansion-brief") {
-    return compactInput({
-      keyword: opts.keyword,
-      location: opts.location,
-      maxQuestions: numberOpt(opts.maxQuestions),
-      depth: numberOpt(opts.depth),
-      returnPartial: opts.returnPartial === false ? false : void 0
-    });
-  }
-  if (id === "directory" || id === "local-competitive-audit" || id === "map-comparison") {
-    return compactInput({
-      query: opts.query,
-      location: opts.location,
-      state: opts.state,
-      minPopulation: numberOpt(opts.minPop ?? opts.minPopulation),
-      maxCities: numberOpt(opts.maxCities),
-      maxResultsPerCity: numberOpt(opts.perCity ?? opts.maxResultsPerCity ?? opts.maxResults),
-      concurrency: numberOpt(opts.concurrency),
-      proxyMode: opts.proxyMode,
-      hydrateTop: id === "local-competitive-audit" || id === "map-comparison" ? numberOpt(opts.hydrateTop) : void 0,
-      maxReviews: id === "local-competitive-audit" || id === "map-comparison" ? numberOpt(opts.reviews ?? opts.maxReviews) : void 0,
-      returnPartial: opts.returnPartial === false ? false : void 0
-    });
-  }
-  return compactInput(opts);
-}
-function writeOutput(data, json) {
-  if (json) {
-    process.stdout.write(`${JSON.stringify(data, null, 2)}
-`);
-  } else if (typeof data === "string") {
-    process.stdout.write(`${data}
-`);
-  } else {
-    process.stdout.write(`${JSON.stringify(data, null, 2)}
-`);
-  }
-}
-function maskSecrets(value) {
-  return value.replace(/sk_[A-Za-z0-9_-]+/g, "sk_***");
-}
-function runLocalCommand(command, args) {
-  return new Promise((resolve) => {
-    const child = 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";
-  return "weekly";
-}
-function apiOptions(opts) {
-  const apiKey = String(opts.apiKey ?? process.env.MCP_SCRAPER_API_KEY ?? "").trim();
-  if (!apiKey) throw new Error("MCP_SCRAPER_API_KEY is required. Pass --api-key or set the environment variable.");
-  return {
-    apiUrl: String(opts.apiUrl ?? process.env.MCP_SCRAPER_API_URL ?? "https://mcpscraper.dev").replace(/\/$/, ""),
-    apiKey
-  };
-}
-function openExternalUrl(url) {
-  const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
-  const args = process.platform === "win32" ? ["/c", "start", "", url] : [url];
-  try {
-    const child = spawn(command, args, { detached: true, stdio: "ignore" });
-    child.unref();
-    return true;
-  } catch {
-    return false;
-  }
-}
-async function apiRequest(path, method, opts, body) {
-  const { apiUrl, apiKey } = apiOptions(opts);
-  const res = await fetch(`${apiUrl}${path}`, {
-    method,
-    headers: {
-      "Content-Type": "application/json",
-      "x-api-key": apiKey
-    },
-    body: body == null ? void 0 : JSON.stringify(body)
-  });
-  const data = await res.json().catch(() => ({}));
-  if (!res.ok) {
-    const message = typeof data.error === "string" ? data.error : `API request failed with ${res.status}`;
-    throw new Error(message);
-  }
-  return data;
-}
-function addWorkflowInputOptions(command) {
-  return command.option("--keyword <keyword>", "Agent packet keyword").option("--domain <domain>", "Target domain").option("--url <url>", "Target page URL").option("--location <location>", "Target location").option("--max-results <n>", "Maximum SERP or Maps results").option("--max-questions <n>", "Maximum PAA questions").option("--extract-top <n>", "Top result pages or citation pages to extract").option("--depth <n>", "PAA expansion depth").option("--no-serp", "Skip SERP evidence for agent packet").option("--no-paa", "Skip PAA evidence for agent packet").option("--query <query>", "Business category or workflow query").option("--state <state>", "US state").option("--min-pop <n>", "Minimum city population").option("--max-cities <n>", "Maximum selected cities").option("--per-city <n>", "Maps results per city").option("--concurrency <n>", "City search concurrency").option("--proxy-mode <mode>", "Proxy mode: location, configured, or none").option("--hydrate-top <n>", "Profiles to hydrate per city for competitive audits").option("--reviews <n>", "Review cards to collect per hydrated profile").option("--no-return-partial", "Fail instead of writing partial artifacts");
-}
-function buildHumanCli() {
-  const program = new Command();
-  program.name("mcp-scraper-cli").description("Human CLI for MCP Scraper setup, workflows, reports, and agent-ready SEO artifacts.").version(PACKAGE_VERSION);
-  program.command("doctor").description("Check setup, API key, output directory, package version, and recommended MCP config.").option("--api-key <key>", "MCP Scraper API key").option("--api-url <url>", "MCP Scraper API URL", "https://mcpscraper.dev").option("--output-dir <path>", "Output directory to test").option("--json", "Print machine-readable JSON").action(async (opts) => {
-    const output = await runDoctor({ apiKey: opts.apiKey, apiUrl: opts.apiUrl, outputDir: opts.outputDir });
-    writeOutput(opts.json ? output : renderDoctor(output), opts.json);
-    if (!output.ok) process.exitCode = 1;
-  });
-  const billing = program.command("billing").description("Inspect billing and start checkout flows.");
-  const billingConcurrency = billing.command("concurrency").description("Manage MCP Scraper concurrency packs.");
-  billingConcurrency.command("info").description("Show current concurrency limit and concurrency-pack price.").option("--api-key <key>", "MCP Scraper API key").option("--api-url <url>", "MCP Scraper API URL", "https://mcpscraper.dev").option("--json", "Print machine-readable JSON").action(async (opts) => {
-    const result = await apiRequest("/billing/credits", "POST", opts, {});
-    if (opts.json) writeOutput(result.concurrency, true);
-    else {
-      const upgrade = result.concurrency?.upgrade;
-      writeOutput([
-        `Current limit: ${result.concurrency?.current_limit ?? "unknown"} concurrent operations`,
-        `Extra slots: ${result.concurrency?.current_extra_slots ?? "unknown"}`,
-        `Concurrency pack: ${upgrade?.price_label ?? "$5/month for 2 extra browsers"}`,
-        `Upgrade command: ${upgrade?.terminal_command ?? "mcp-scraper-cli billing concurrency checkout"}`
-      ].join("\n"), false);
-    }
-  });
-  billingConcurrency.command("checkout").description("Create or update a hosted Stripe checkout for concurrency packs (two browsers per pack).").argument("[quantity]", "Desired pack quantity", "1").option("--api-key <key>", "MCP Scraper API key").option("--api-url <url>", "MCP Scraper API URL", "https://mcpscraper.dev").option("--json", "Print machine-readable JSON").option("--no-open", "Print the checkout URL without opening a browser").action(async (quantity, opts) => {
-    const result = await apiRequest("/billing/concurrency/terminal-checkout", "POST", opts, { quantity: Number(quantity) });
-    if (opts.json) {
-      writeOutput(result, true);
-      return;
-    }
-    const opened = !!result.checkout_url && opts.open !== false && openExternalUrl(result.checkout_url);
-    writeOutput([
-      `Concurrency pack: ${result.price?.price_label ?? "$5/month for 2 extra browsers"}`,
-      result.updated ? "Concurrency pack quantity updated." : opened ? `Opened checkout: ${result.checkout_url}` : `Checkout URL: ${result.checkout_url}`,
-      result.next_step ?? "Complete checkout, then retry the MCP request."
-    ].join("\n"), false);
-  });
-  billing.command("subscribe <tier>").description("Subscribe to a plan (starter | growth | scale) via a hosted Stripe checkout link.").option("--api-key <key>", "MCP Scraper API key").option("--api-url <url>", "MCP Scraper API URL", "https://mcpscraper.dev").option("--json", "Print machine-readable JSON").option("--no-open", "Print the checkout URL without opening a browser").action(async (tier, opts) => {
-    const result = await apiRequest("/billing/subscribe/terminal-checkout", "POST", opts, { tier: String(tier).toLowerCase() });
-    if (opts.json) {
-      writeOutput(result, true);
-      return;
-    }
-    if (result.updated) {
-      writeOutput(result.message ?? `Switched to ${result.tier}.`, false);
-      return;
-    }
-    const opened = opts.open !== false && !!result.checkout_url && openExternalUrl(result.checkout_url);
-    const interval = result.billing_interval === "year" ? "year" : "month";
-    const amount = result.amount_usd ?? result.monthly_usd;
-    const credits = result.credits_per_interval ?? result.credits_per_month;
-    const perInterval = interval === "year" ? "/yr" : "/mo";
-    const creditsPer = interval === "year" ? "credits/yr" : "credits/mo";
-    const extras = [
-      result.credits_never_expire ? "credits never expire" : null,
-      result.includes_memory ? "includes Memory Pro" : null,
-      result.intro
-    ].filter(Boolean).join(" \xB7 ");
-    writeOutput([
-      `Plan: ${result.label ?? tier} \u2014 $${amount}${perInterval} \xB7 ${credits?.toLocaleString()} ${creditsPer} \xB7 ${result.concurrency} concurrency${extras ? ` \xB7 ${extras}` : ""}`,
-      opened ? `Opened checkout: ${result.checkout_url}` : `Checkout URL: ${result.checkout_url}`,
-      result.next_step ?? "Complete payment in the browser."
-    ].join("\n"), false);
-  });
-  const agent = program.command("agent").description("Generate AI-agent install configs and workflow prompts.");
-  agent.command("install <host>").description("Print or apply install/config instructions for Codex, Claude, Cursor, Windsurf, Cline, or a handoff-only MCP host.").option("--api-key <key>", "API key to place in generated config").option("--package <spec>", "npm package spec", "mcp-scraper@latest").option("--browser-profile <name>", "Default saved browser profile for browser_open sessions.").option("--save-browser-profile-changes", "Persist cookies and browser storage back to the named browser profile when sessions close").option("--apply", "Apply the config to this 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 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,
-        browserProfileName: opts.browserProfile,
-        browserProfileSaveChanges: opts.saveBrowserProfileChanges
-      };
-      const existing = await runLocalCommand("claude", claudeMcpGetArgs());
-      const snapshot = existing.code === 0 ? parseClaudeMcpGet(existing.stdout) : null;
-      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());
-        let rollback;
-        if (remove.code !== 0) {
-          rollback = "No existing entry was removed, so your configuration is unchanged.";
-        } else if (!snapshot) {
-          rollback = "WARNING: the previous mcp-scraper entry was removed and could not be captured for rollback. Re-add it manually.";
-        } else {
-          const restore = await runLocalCommand("claude", claudeMcpRestoreArgs(snapshot));
-          rollback = restore.code === 0 ? "Your previous mcp-scraper entry was restored; nothing was lost." : "WARNING: the previous mcp-scraper entry was removed and could NOT be restored. Re-add it with:\n  claude " + claudeMcpRestoreArgs(snapshot).join(" ");
-        }
-        throw new Error([
-          "Claude Code MCP registration failed.",
-          reason || "No error output returned.",
-          rollback,
-          "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: combinedNpxArgs(configOptions),
-        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 " + combinedNpxArgs(configOptions).join(" "),
-        opts.browserProfile ? `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,
-      browserProfileName: opts.browserProfile,
-      browserProfileSaveChanges: opts.saveBrowserProfileChanges
-    });
-    writeOutput(opts.json ? {
-      host,
-      protocolVersion: XRAY_INSTALL_PROTOCOL_VERSION,
-      protocolDigest: XRAY_INSTALL_PROTOCOL_DIGEST,
-      text
-    } : text, opts.json);
-  });
-  agent.command("prompt [name]").description("Print an agent prompt template.").option("--json", "Print machine-readable JSON").action((name, opts) => {
-    if (!name) {
-      writeOutput(opts.json ? { prompts: listPrompts() } : listPrompts().join("\n"), opts.json);
-      return;
-    }
-    const text = renderPrompt(name);
-    writeOutput(opts.json ? {
-      name,
-      ...name === "xray-setup" ? {
-        protocolVersion: XRAY_INSTALL_PROTOCOL_VERSION,
-        protocolDigest: XRAY_INSTALL_PROTOCOL_DIGEST
-      } : {},
-      text
-    } : text, opts.json);
-  });
-  const workflow = program.command("workflow").description("Run named SEO workflows.");
-  workflow.command("list").description("List available workflows.").option("--json", "Print machine-readable JSON").action((opts) => {
-    const rows = listWorkflowDefinitions();
-    if (opts.json) writeOutput({ workflows: rows }, true);
-    else writeOutput(rows.map((row) => `${row.id}	${row.title}
-  ${row.description}`).join("\n"), false);
-  });
-  workflow.command("run <id>").description("Run a workflow and save local artifacts.").option("--api-key <key>", "MCP Scraper API key").option("--api-url <url>", "MCP Scraper API URL", "https://mcpscraper.dev").option("--output-dir <path>", "Workflow output directory").option("--json", "Print machine-readable JSON").option("--keyword <keyword>", "Agent packet keyword").option("--domain <domain>", "Target domain").option("--url <url>", "Target page URL").option("--location <location>", "Target location").option("--max-results <n>", "Maximum SERP or Maps results").option("--max-questions <n>", "Maximum PAA questions").option("--extract-top <n>", "Top result pages or citation pages to extract").option("--depth <n>", "PAA expansion depth").option("--no-serp", "Skip SERP evidence for agent packet").option("--no-paa", "Skip PAA evidence for agent packet").option("--query <query>", "Business category or workflow query").option("--state <state>", "US state").option("--min-pop <n>", "Minimum city population").option("--max-cities <n>", "Maximum selected cities").option("--per-city <n>", "Maps results per city").option("--concurrency <n>", "City search concurrency").option("--proxy-mode <mode>", "Proxy mode: location, configured, or none").option("--hydrate-top <n>", "Profiles to hydrate per city for competitive audits").option("--reviews <n>", "Review cards to collect per hydrated profile").option("--no-return-partial", "Fail instead of writing partial artifacts").action(async (id, opts) => {
-    const summary = await runWorkflow(id, workflowInput(id, opts), {
-      apiKey: opts.apiKey,
-      apiUrl: opts.apiUrl,
-      outputDir: opts.outputDir
-    });
-    if (opts.json) writeOutput(summary, true);
-    else {
-      writeOutput([
-        `${summary.title}: ${summary.status}`,
-        summary.summary,
-        summary.reportPath ? `Report: ${summary.reportPath}` : "",
-        summary.warnings.length ? `Warnings:
-${summary.warnings.map((w) => `- ${w}`).join("\n")}` : ""
-      ].filter(Boolean).join("\n"), false);
-    }
-  });
-  const report = program.command("report").description("List and open local workflow reports.");
-  report.command("list").description("List recent workflow reports.").option("--output-dir <path>", "Workflow output directory").option("--json", "Print machine-readable JSON").action(async (opts) => {
-    const reports = await listWorkflowReports(opts.outputDir);
-    writeOutput(opts.json ? { reports } : reports.map((r) => `${r.startedAt}	${r.workflow}	${r.status}	${r.reportPath ?? r.manifestPath}`).join("\n"), opts.json);
-  });
-  report.command("path [id]").description("Print a report path. Defaults to last.").option("--output-dir <path>", "Workflow output directory").option("--json", "Print machine-readable JSON").action(async (id = "last", opts) => {
-    const found = await findWorkflowReport(id, opts.outputDir);
-    if (!found?.reportPath) throw new Error(`No report found for "${id}"`);
-    writeOutput(opts.json ? { path: found.reportPath, run: found } : found.reportPath, opts.json);
-  });
-  report.command("open [id]").description("Open a report. Defaults to last.").option("--output-dir <path>", "Workflow output directory").option("--json", "Print machine-readable JSON instead of opening").action(async (id = "last", opts) => {
-    if (opts.json) {
-      const found = await findWorkflowReport(id, opts.outputDir);
-      if (!found?.reportPath) throw new Error(`No report found for "${id}"`);
-      writeOutput({ path: found.reportPath, run: found }, true);
-      return;
-    }
-    const path = await openWorkflowReport(id, opts.outputDir);
-    writeOutput(`Opened: ${path}`, false);
-  });
-  const schedule = program.command("schedule").description("Create and manage hosted workflow schedules.");
-  addWorkflowInputOptions(schedule.command("create <workflowId>").description("Create a recurring hosted workflow schedule.").option("--api-key <key>", "MCP Scraper API key").option("--api-url <url>", "MCP Scraper API URL", "https://mcpscraper.dev").option("--name <name>", "Schedule name").option("--daily", "Run daily").option("--weekly", "Run weekly").option("--monthly", "Run monthly").option("--timezone <tz>", "Schedule timezone", "UTC").option("--webhook <url>", "HTTPS webhook URL").option("--next-run-at <iso>", "First run time as an ISO timestamp").option("--json", "Print machine-readable JSON")).action(async (workflowId, opts) => {
-    const result = await apiRequest("/workflows/schedules", "POST", opts, {
-      workflowId,
-      name: opts.name,
-      input: workflowInput(workflowId, opts),
-      cadence: cadenceOpt(opts),
-      timezone: opts.timezone,
-      webhookUrl: opts.webhook,
-      nextRunAt: opts.nextRunAt
-    });
-    writeOutput(result, opts.json);
-  });
-  schedule.command("list").description("List hosted workflow schedules.").option("--api-key <key>", "MCP Scraper API key").option("--api-url <url>", "MCP Scraper API URL", "https://mcpscraper.dev").option("--json", "Print machine-readable JSON").action(async (opts) => {
-    const result = await apiRequest("/workflows/schedules", "GET", opts);
-    if (opts.json) writeOutput(result, true);
-    else writeOutput(result.schedules.map((scheduleRow) => `${scheduleRow.id}	${scheduleRow.status}	${scheduleRow.workflow_id}	${scheduleRow.next_run_at ?? ""}`).join("\n"), false);
-  });
-  schedule.command("pause <id>").description("Pause a hosted workflow schedule.").option("--api-key <key>", "MCP Scraper API key").option("--api-url <url>", "MCP Scraper API URL", "https://mcpscraper.dev").option("--json", "Print machine-readable JSON").action(async (id, opts) => writeOutput(await apiRequest(`/workflows/schedules/${id}`, "PATCH", opts, { status: "paused" }), opts.json));
-  schedule.command("resume <id>").description("Resume a hosted workflow schedule.").option("--api-key <key>", "MCP Scraper API key").option("--api-url <url>", "MCP Scraper API URL", "https://mcpscraper.dev").option("--json", "Print machine-readable JSON").action(async (id, opts) => writeOutput(await apiRequest(`/workflows/schedules/${id}`, "PATCH", opts, { status: "active" }), opts.json));
-  schedule.command("delete <id>").description("Delete a hosted workflow schedule.").option("--api-key <key>", "MCP Scraper API key").option("--api-url <url>", "MCP Scraper API URL", "https://mcpscraper.dev").option("--json", "Print machine-readable JSON").action(async (id, opts) => writeOutput(await apiRequest(`/workflows/schedules/${id}`, "DELETE", opts), opts.json));
-  schedule.command("run <id>").description("Run a hosted workflow schedule now.").option("--api-key <key>", "MCP Scraper API key").option("--api-url <url>", "MCP Scraper API URL", "https://mcpscraper.dev").option("--json", "Print machine-readable JSON").action(async (id, opts) => writeOutput(await apiRequest(`/workflows/schedules/${id}/run`, "POST", opts, {}), opts.json));
-  const runs = program.command("runs").description("Inspect and download hosted workflow runs.");
-  runs.command("list").description("List hosted workflow runs.").option("--api-key <key>", "MCP Scraper API key").option("--api-url <url>", "MCP Scraper API URL", "https://mcpscraper.dev").option("--json", "Print machine-readable JSON").action(async (opts) => {
-    const result = await apiRequest("/workflows/runs", "GET", opts);
-    if (opts.json) writeOutput(result, true);
-    else writeOutput(result.runs.map((run) => `${run.id}	${run.status}	${run.workflow_id}	${run.queued_at}`).join("\n"), false);
-  });
-  runs.command("status <id>").description("Show a hosted workflow run.").option("--api-key <key>", "MCP Scraper API key").option("--api-url <url>", "MCP Scraper API URL", "https://mcpscraper.dev").option("--json", "Print machine-readable JSON").action(async (id, opts) => writeOutput(await apiRequest(`/workflows/runs/${id}`, "GET", opts), opts.json));
-  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 = join2(opts.outputDir ?? workflowOutputBaseDir(), "workflow-downloads", id);
-    await mkdir2(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 = join2(outDir, basename(artifact.path));
-      await writeFile(file, Buffer.from(await res.arrayBuffer()));
-      downloaded.push(file);
-    }
-    writeOutput(opts.json ? { runId: id, files: downloaded } : downloaded.join("\n"), opts.json);
-  });
-  return program;
-}
-async function runHumanCli(argv = process.argv) {
-  await buildHumanCli().parseAsync(argv);
-}
-
-// bin/mcp-scraper-cli.ts
-runHumanCli().catch((err) => {
-  console.error(err instanceof Error ? err.message : String(err));
-  process.exit(1);
-});
+import{b as E,c as N,d as M,e as L,f as T,j as U}from"../chunk-XLWNEVUZ.js";import"../chunk-KJQXUZ4Y.js";import"../chunk-3GP5CYZX.js";import{g as v,j as b,k as D,l as K,m as H}from"../chunk-WO3N5FH2.js";import"../chunk-HE45FFBU.js";import{a as P}from"../chunk-Z2QGQJS2.js";import{Command as he}from"commander";import{spawn as ne}from"child_process";import{mkdir as ke,writeFile as Pe}from"fs/promises";import{basename as Ce,join as Z}from"path";function se(e){return e.apiKey?.trim()||"sk_live_your_key"}function ce(e){return e.packageSpec?.trim()||"mcp-scraper@latest"}function A(e={}){return["-y","--package",ce(e),"mcp-scraper"]}function pe(e){let n={MCP_SCRAPER_API_KEY:se(e)},c=e.browserProfileName?.trim();return c&&(n.BROWSER_AGENT_PROFILE_NAME=c),e.browserProfileSaveChanges===!0&&(n.BROWSER_AGENT_PROFILE_SAVE_CHANGES="true"),n}function q(){return["mcp","remove","mcp-scraper","-s","user"]}function J(){return["mcp","get","mcp-scraper"]}function B(e){let n=e.match(/^\s*Command:\s*(.+?)\s*$/m)?.[1];if(!n)return null;let c=e.match(/^\s*Args:\s*(.*?)\s*$/m)?.[1]??"",i=c.length?c.split(/\s+/):[],p={},u=e.split(/^\s*Environment:\s*$/m)[1];if(u)for(let a of u.split(`
+`)){let l=a.match(/^\s{2,}([A-Za-z_][A-Za-z0-9_]*)=(.*)$/);if(!l){if(a.trim().length&&!/^\s{2,}/.test(a))break;continue}p[l[1]]=l[2]}return{command:n,args:i,env:p}}function j(e){let n=["mcp","add","mcp-scraper","--scope","user"];for(let[c,i]of Object.entries(e.env))n.push("--env",`${c}=${i}`);return n.push("--",e.command,...e.args),n}function G(e={}){let n=["mcp","add","mcp-scraper","--scope","user"];for(let[c,i]of Object.entries(pe(e)))n.push("--env",`${c}=${i}`);return n.push("--","npx",...A(e)),n}function O(e){if(e==="claude-code")return"claude";if(e==="claude"||D.hosts.some(n=>n.id===e))return e;throw new Error('Unknown host "'+e+'". Use: codex, claude, claude-code, claude-desktop, cursor, windsurf, cline, or user-action-only')}function ue(e){return K(e==="claude"?"claude-code":e)}function W(e,n={}){let c=O(e),i=ue(c),p="Restart the MCP client so it starts a fresh npx process.",u='MCP_SCRAPER_API_KEY="$MCP_SCRAPER_API_KEY" npx -y -p mcp-scraper@latest mcp-scraper-cli agent install claude --apply',a=`X-Ray install protocol: ${v} (${b})`;return c==="codex"?["# Codex MCP config",a,i.exactConfig,"",`Continuation: ${i.continuation}`,`Rollback: ${i.rollback}`,"",p].join(`
+`):c==="claude"?["# Claude Code command",a,i.exactConfig,"","# One-command Claude Code setup",u,"",`Continuation: ${i.continuation}`,`Rollback: ${i.rollback}`,"",p].join(`
+`):c==="claude-desktop"?["# Claude Desktop config",a,i.exactConfig,"","Desktop Extension: https://mcpscraper.dev/downloads/mcp-scraper.mcpb",`Continuation: ${i.continuation}`,`Rollback: ${i.rollback}`,p].join(`
+`):[`# ${i.label} MCP config`,a,i.exactConfig,"",`Continuation: ${i.continuation}`,`Rollback: ${i.rollback}`,...i.restartRequired?["",p]:[]].join(`
+`)}import{access as le,mkdir as de,readFile as me}from"fs/promises";import{homedir as Y}from"os";import{join as F}from"path";function fe(e,n=!1){return e?"pass":n?"warn":"fail"}function ge(e){return Number(e.replace(/^v/,"").split(".")[0]??0)}async function we(){let e=process.env.MCP_SCRAPER_KEY_PATH?.trim()||F(Y(),".mcp-scraper-key");try{return(await me(e,"utf8")).trim()||null}catch{return null}}async function ye(e){try{let n=await e("https://registry.npmjs.org/mcp-scraper/latest",{signal:AbortSignal.timeout(5e3)});return n.ok?(await n.json()).version??null:null}catch{return null}}async function z(e={}){let n=e.fetchImpl??fetch,c=(e.apiUrl??process.env.MCP_SCRAPER_API_URL??"https://mcpscraper.dev").replace(/\/$/,""),i=e.outputDir??process.env.MCP_SCRAPER_OUTPUT_DIR??F(Y(),"Downloads","mcp-scraper"),p=e.apiKey?.trim()||process.env.MCP_SCRAPER_API_KEY?.trim()||await we(),u=await ye(n),a=[],l=ge(process.version);a.push({id:"node",label:"Node.js",status:fe(l>=20),detail:process.version,fix:l>=20?void 0:"Install Node.js 20 or newer."}),a.push({id:"package_version",label:"Local package",status:u&&u!==P?"warn":"pass",detail:u?`local ${P}, npm latest ${u}`:`local ${P}, npm latest unavailable`,fix:u&&u!==P?"Use mcp-scraper@latest and restart the MCP client.":void 0}),a.push({id:"api_key",label:"API key",status:p?"pass":"warn",detail:p?"configured":"not configured",fix:p?void 0:"Set MCP_SCRAPER_API_KEY or pass --api-key."});try{await de(i,{recursive:!0}),await le(i),a.push({id:"output_dir",label:"Output directory",status:"pass",detail:i})}catch(t){a.push({id:"output_dir",label:"Output directory",status:"fail",detail:i,fix:t instanceof Error?t.message:"Create a writable output directory."})}if(p)try{let t=await n(`${c}/me`,{headers:{"x-api-key":p},signal:AbortSignal.timeout(8e3)});a.push({id:"api_reachability",label:"Hosted API",status:t.ok?"pass":"fail",detail:`${c}/me returned ${t.status}`,fix:t.ok?void 0:"Verify the API key and account status."})}catch(t){a.push({id:"api_reachability",label:"Hosted API",status:"fail",detail:t instanceof Error?t.message:String(t),fix:"Check network access and MCP_SCRAPER_API_URL."})}else a.push({id:"api_reachability",label:"Hosted API",status:"skip",detail:"skipped because no API key is configured"});return a.push({id:"mcp_config",label:"MCP command",status:"pass",detail:`npx ${A().join(" ")}`,fix:"Restart the MCP client after package updates."}),{ok:a.every(t=>t.status==="pass"||t.status==="skip"),version:P,npmLatest:u,checks:a,recommendedConfig:{command:"npx",args:A(),env:{MCP_SCRAPER_API_KEY:p?"$MCP_SCRAPER_API_KEY":"sk_live_your_key"}}}}function V(e){let n={pass:"PASS",warn:"WARN",fail:"FAIL",skip:"SKIP"};return[`mcp-scraper doctor v${e.version}`,"",...e.checks.map(i=>{let p=i.fix?`
+    Fix: ${i.fix}`:"";return`[${n[i.status]}] ${i.label}: ${i.detail}${p}`}),"",`Recommended MCP command: npx ${e.recommendedConfig.args.join(" ")}`].join(`
+`)}var X={"xray-setup":H(),"agent-packet":["# MCP Scraper Agent Packet Prompt","","Use MCP Scraper as the evidence layer. Run the agent-packet workflow for the target keyword/domain, then treat `evidence.json`, `sources.csv`, and `competitors.csv` as source of truth.","","Do not invent citations. If a recommendation is not supported by the packet, mark it as an assumption. Turn the evidence into a concise SEO brief, an implementation task list, and content recommendations tied to source rows."].join(`
+`),"local-competitive-audit":["# MCP Scraper Local Competitive Audit Prompt","","Run the local-competitive-audit workflow for the niche and markets. Use the city summary, competitor CSV, and review-insight CSV to identify market difficulty, review themes, GBP category patterns, and weak competitors.","","Ground recommendations in Maps rank position, review count, star rating, categories, profile details, and review topics. Do not overstate heuristic opportunity scores."].join(`
+`),"directory-workflow":["# MCP Scraper Directory Workflow Prompt","","Use directory_workflow when the user wants cities selected by population and Google Maps candidates per city. Keep query and location separate. Preserve result_position, source_location, review stars/count, categories, and profile URLs for downstream CSV or directory use."].join(`
+`),"map-comparison":["# MCP Scraper Maps Comparison Prompt","","Run the map-comparison workflow when the user wants to compare local Maps competitors in a city or across selected markets. Use `maps-results.csv`, `map-comparison.csv`, and `profile-insights.csv` as source of truth.","","Ground recommendations in result_position, review_stars, review_count, category, website presence, review topics, and profile attributes. Treat review gaps and missing websites as opportunity signals, not guaranteed ranking factors."].join(`
+`),"serp-comparison":["# MCP Scraper SERP Comparison Prompt","","Run the serp-comparison workflow when the user wants to know why competitors outrank a page or what the SERP rewards. Use organic results, extracted page headings, PAA questions, and AI Overview citations before making recommendations.","","Tie each recommendation to `content-gaps.csv`, `page-comparison.csv`, `paa-questions.csv`, or `ai-overview-citations.csv`. Do not invent missing sections or citations."].join(`
+`),"paa-expansion-brief":["# MCP Scraper PAA Expansion Brief Prompt","","Run the paa-expansion-brief workflow when the user wants to figure out what to write from People Also Ask expansion. Use `section-map.csv` to structure the brief and `paa-questions.csv` for exact customer-language headings.","","Answer the highest-priority questions directly, preserve source URLs when present, and separate evidence-backed sections from assumptions."].join(`
+`),"ai-overview-language":["# MCP Scraper AI Overview Language Prompt","","Run the ai-overview-language workflow when the user wants to know how to phrase content for AI Overview inclusion. Use `claim-patterns.csv`, `language-guidance.csv`, `ai-overview-citations.csv`, and PAA follow-ups as evidence.","","Recommend concise answer blocks, criteria/step language, citation hooks, and follow-up sections. Do not claim the target will be cited; frame the output as evidence-based language guidance."].join(`
+`),"ai-citation-monitor":["# MCP Scraper AI Citation Monitor Prompt","","Use search_serp and harvest_paa to check whether the target brand/domain appears in AI Overview citations, organic results, People Also Ask sources, local pack, forums, and videos. Save evidence before summarizing trends or gaps."].join(`
+`),"serp-brief":["# MCP Scraper SERP Brief Prompt","","Use live SERP, PAA, AI Overview, forum, video, and source evidence to create a writer brief. Tie each recommended section to evidence rows and identify missing proof, entities, comparisons, and customer questions."].join(`
+`)};function _(){return Object.keys(X).sort()}function Q(e){let n=X[e];if(!n)throw new Error(`Unknown prompt "${e}". Available: ${_().join(", ")}`);return n}function f(e){if(e==null||e==="")return;let n=Number(e);return Number.isFinite(n)?n:void 0}function Ae(e){if(e!==void 0){if(typeof e=="boolean")return e;if(e==="true")return!0;if(e==="false")return!1}}function x(e){return Object.fromEntries(Object.entries(e).filter(([,n])=>n!==void 0))}function ee(e,n){return x(e==="agent-packet"||e==="serp-comparison"||e==="ai-overview-language"?{keyword:n.keyword,domain:n.domain,url:n.url,location:n.location,maxResults:f(n.maxResults),maxQuestions:f(n.maxQuestions),extractTop:f(n.extractTop),includeSerp:n.serp===!1?!1:void 0,includePaa:n.paa===!1?!1:void 0,includeAiOverview:Ae(n.includeAiOverview),returnPartial:n.returnPartial===!1?!1:void 0}:e==="paa-expansion-brief"?{keyword:n.keyword,location:n.location,maxQuestions:f(n.maxQuestions),depth:f(n.depth),returnPartial:n.returnPartial===!1?!1:void 0}:e==="directory"||e==="local-competitive-audit"||e==="map-comparison"?{query:n.query,location:n.location,state:n.state,minPopulation:f(n.minPop??n.minPopulation),maxCities:f(n.maxCities),maxResultsPerCity:f(n.perCity??n.maxResultsPerCity??n.maxResults),concurrency:f(n.concurrency),proxyMode:n.proxyMode,hydrateTop:e==="local-competitive-audit"||e==="map-comparison"?f(n.hydrateTop):void 0,maxReviews:e==="local-competitive-audit"||e==="map-comparison"?f(n.reviews??n.maxReviews):void 0,returnPartial:n.returnPartial===!1?!1:void 0}:n)}function s(e,n){n?process.stdout.write(`${JSON.stringify(e,null,2)}
+`):typeof e=="string"?process.stdout.write(`${e}
+`):process.stdout.write(`${JSON.stringify(e,null,2)}
+`)}function re(e){return e.replace(/sk_[A-Za-z0-9_-]+/g,"sk_***")}function S(e,n){return new Promise(c=>{let i=ne(e,n,{stdio:["ignore","pipe","pipe"]}),p=[],u=[],a=!1,l=t=>{a||(a=!0,c(t))};i.stdout.on("data",t=>p.push(Buffer.from(t))),i.stderr.on("data",t=>u.push(Buffer.from(t))),i.on("error",t=>{l({code:127,stdout:"",stderr:t.message})}),i.on("close",t=>{l({code:typeof t=="number"?t:1,stdout:Buffer.concat(p).toString("utf8"),stderr:Buffer.concat(u).toString("utf8")})})})}function ve(e){return e.daily?"daily":e.monthly?"monthly":"weekly"}function oe(e){let n=String(e.apiKey??process.env.MCP_SCRAPER_API_KEY??"").trim();if(!n)throw new Error("MCP_SCRAPER_API_KEY is required. Pass --api-key or set the environment variable.");return{apiUrl:String(e.apiUrl??process.env.MCP_SCRAPER_API_URL??"https://mcpscraper.dev").replace(/\/$/,""),apiKey:n}}function te(e){let n=process.platform==="darwin"?"open":process.platform==="win32"?"cmd":"xdg-open",c=process.platform==="win32"?["/c","start","",e]:[e];try{return ne(n,c,{detached:!0,stdio:"ignore"}).unref(),!0}catch{return!1}}async function m(e,n,c,i){let{apiUrl:p,apiKey:u}=oe(c),a=await fetch(`${p}${e}`,{method:n,headers:{"Content-Type":"application/json","x-api-key":u},body:i==null?void 0:JSON.stringify(i)}),l=await a.json().catch(()=>({}));if(!a.ok){let t=typeof l.error=="string"?l.error:`API request failed with ${a.status}`;throw new Error(t)}return l}function be(e){return e.option("--keyword <keyword>","Agent packet keyword").option("--domain <domain>","Target domain").option("--url <url>","Target page URL").option("--location <location>","Target location").option("--max-results <n>","Maximum SERP or Maps results").option("--max-questions <n>","Maximum PAA questions").option("--extract-top <n>","Top result pages or citation pages to extract").option("--depth <n>","PAA expansion depth").option("--no-serp","Skip SERP evidence for agent packet").option("--no-paa","Skip PAA evidence for agent packet").option("--query <query>","Business category or workflow query").option("--state <state>","US state").option("--min-pop <n>","Minimum city population").option("--max-cities <n>","Maximum selected cities").option("--per-city <n>","Maps results per city").option("--concurrency <n>","City search concurrency").option("--proxy-mode <mode>","Proxy mode: location, configured, or none").option("--hydrate-top <n>","Profiles to hydrate per city for competitive audits").option("--reviews <n>","Review cards to collect per hydrated profile").option("--no-return-partial","Fail instead of writing partial artifacts")}function Se(){let e=new he;e.name("mcp-scraper-cli").description("Human CLI for MCP Scraper setup, workflows, reports, and agent-ready SEO artifacts.").version(P),e.command("doctor").description("Check setup, API key, output directory, package version, and recommended MCP config.").option("--api-key <key>","MCP Scraper API key").option("--api-url <url>","MCP Scraper API URL","https://mcpscraper.dev").option("--output-dir <path>","Output directory to test").option("--json","Print machine-readable JSON").action(async t=>{let r=await z({apiKey:t.apiKey,apiUrl:t.apiUrl,outputDir:t.outputDir});s(t.json?r:V(r),t.json),r.ok||(process.exitCode=1)});let n=e.command("billing").description("Inspect billing and start checkout flows."),c=n.command("concurrency").description("Manage MCP Scraper concurrency packs.");c.command("info").description("Show current concurrency limit and concurrency-pack price.").option("--api-key <key>","MCP Scraper API key").option("--api-url <url>","MCP Scraper API URL","https://mcpscraper.dev").option("--json","Print machine-readable JSON").action(async t=>{let r=await m("/billing/credits","POST",t,{});if(t.json)s(r.concurrency,!0);else{let o=r.concurrency?.upgrade;s([`Current limit: ${r.concurrency?.current_limit??"unknown"} concurrent operations`,`Extra slots: ${r.concurrency?.current_extra_slots??"unknown"}`,`Concurrency pack: ${o?.price_label??"$5/month for 2 extra browsers"}`,`Upgrade command: ${o?.terminal_command??"mcp-scraper-cli billing concurrency checkout"}`].join(`
+`),!1)}}),c.command("checkout").description("Create or update a hosted Stripe checkout for concurrency packs (two browsers per pack).").argument("[quantity]","Desired pack quantity","1").option("--api-key <key>","MCP Scraper API key").option("--api-url <url>","MCP Scraper API URL","https://mcpscraper.dev").option("--json","Print machine-readable JSON").option("--no-open","Print the checkout URL without opening a browser").action(async(t,r)=>{let o=await m("/billing/concurrency/terminal-checkout","POST",r,{quantity:Number(t)});if(r.json){s(o,!0);return}let d=!!o.checkout_url&&r.open!==!1&&te(o.checkout_url);s([`Concurrency pack: ${o.price?.price_label??"$5/month for 2 extra browsers"}`,o.updated?"Concurrency pack quantity updated.":d?`Opened checkout: ${o.checkout_url}`:`Checkout URL: ${o.checkout_url}`,o.next_step??"Complete checkout, then retry the MCP request."].join(`
+`),!1)}),n.command("subscribe <tier>").description("Subscribe to a plan (starter | growth | scale) via a hosted Stripe checkout link.").option("--api-key <key>","MCP Scraper API key").option("--api-url <url>","MCP Scraper API URL","https://mcpscraper.dev").option("--json","Print machine-readable JSON").option("--no-open","Print the checkout URL without opening a browser").action(async(t,r)=>{let o=await m("/billing/subscribe/terminal-checkout","POST",r,{tier:String(t).toLowerCase()});if(r.json){s(o,!0);return}if(o.updated){s(o.message??`Switched to ${o.tier}.`,!1);return}let d=r.open!==!1&&!!o.checkout_url&&te(o.checkout_url),C=o.billing_interval==="year"?"year":"month",h=o.amount_usd??o.monthly_usd,k=o.credits_per_interval??o.credits_per_month,g=C==="year"?"/yr":"/mo",w=C==="year"?"credits/yr":"credits/mo",y=[o.credits_never_expire?"credits never expire":null,o.includes_memory?"includes Memory Pro":null,o.intro].filter(Boolean).join(" \xB7 ");s([`Plan: ${o.label??t} \u2014 $${h}${g} \xB7 ${k?.toLocaleString()} ${w} \xB7 ${o.concurrency} concurrency${y?` \xB7 ${y}`:""}`,d?`Opened checkout: ${o.checkout_url}`:`Checkout URL: ${o.checkout_url}`,o.next_step??"Complete payment in the browser."].join(`
+`),!1)});let i=e.command("agent").description("Generate AI-agent install configs and workflow prompts.");i.command("install <host>").description("Print or apply install/config instructions for Codex, Claude, Cursor, Windsurf, Cline, or a handoff-only MCP host.").option("--api-key <key>","API key to place in generated config").option("--package <spec>","npm package spec","mcp-scraper@latest").option("--browser-profile <name>","Default saved browser profile for browser_open sessions.").option("--save-browser-profile-changes","Persist cookies and browser storage back to the named browser profile when sessions close").option("--apply","Apply the config to this client when supported. For Claude Code, this upserts the user-scope mcp-scraper server.").option("--json","Print machine-readable JSON").action(async(t,r)=>{let o=O(t),d=r.apiKey??process.env.MCP_SCRAPER_API_KEY;if(r.apply){if(o!=="claude")throw new Error('--apply is currently supported for Claude Code only. Use host "claude" or "claude-code".');if(!d?.trim())throw new Error("MCP_SCRAPER_API_KEY is required for --apply. Set it in the environment or pass --api-key.");let h={apiKey:d,packageSpec:r.package,browserProfileName:r.browserProfile,browserProfileSaveChanges:r.saveBrowserProfileChanges},k=await S("claude",J()),g=k.code===0?B(k.stdout):null,w=await S("claude",q()),y=await S("claude",G(h));if(y.code!==0){let ae=re([y.stderr,y.stdout].filter(Boolean).join(`
+`).trim()),R;throw w.code!==0?R="No existing entry was removed, so your configuration is unchanged.":g?R=(await S("claude",j(g))).code===0?"Your previous mcp-scraper entry was restored; nothing was lost.":`WARNING: the previous mcp-scraper entry was removed and could NOT be restored. Re-add it with:
+  claude `+j(g).join(" "):R="WARNING: the previous mcp-scraper entry was removed and could not be captured for rollback. Re-add it manually.",new Error(["Claude Code MCP registration failed.",ae||"No error output returned.",R,"Make sure Claude Code is installed and the `claude` command is on PATH."].join(`
+`))}let I=await S("claude",["mcp","list"]),$={host:"claude",applied:!0,replacedExisting:w.code===0,command:"npx",args:A(h),nextStep:"Fully exit Claude Code, start a new Claude terminal, then run: claude mcp list",list:re([I.stdout,I.stderr].filter(Boolean).join(`
+`).trim())};if(r.json){s($,!0);return}s(["Applied Claude Code MCP config: mcp-scraper",w.code===0?"Replaced existing mcp-scraper entry.":"No existing mcp-scraper entry found; added a new one.","Command: npx "+A(h).join(" "),r.browserProfile?`Browser profile: ${r.browserProfile}`:"","","Next step: fully exit Claude Code, start a new Claude terminal, then run:","  claude mcp list","",$.list?`Current Claude MCP list:
+${$.list}`:""].filter(Boolean).join(`
+`),!1);return}let C=W(o,{apiKey:r.apiKey,packageSpec:r.package,browserProfileName:r.browserProfile,browserProfileSaveChanges:r.saveBrowserProfileChanges});s(r.json?{host:o,protocolVersion:v,protocolDigest:b,text:C}:C,r.json)}),i.command("prompt [name]").description("Print an agent prompt template.").option("--json","Print machine-readable JSON").action((t,r)=>{if(!t){s(r.json?{prompts:_()}:_().join(`
+`),r.json);return}let o=Q(t);s(r.json?{name:t,...t==="xray-setup"?{protocolVersion:v,protocolDigest:b}:{},text:o}:o,r.json)});let p=e.command("workflow").description("Run named SEO workflows.");p.command("list").description("List available workflows.").option("--json","Print machine-readable JSON").action(t=>{let r=T();t.json?s({workflows:r},!0):s(r.map(o=>`${o.id}	${o.title}
+  ${o.description}`).join(`
+`),!1)}),p.command("run <id>").description("Run a workflow and save local artifacts.").option("--api-key <key>","MCP Scraper API key").option("--api-url <url>","MCP Scraper API URL","https://mcpscraper.dev").option("--output-dir <path>","Workflow output directory").option("--json","Print machine-readable JSON").option("--keyword <keyword>","Agent packet keyword").option("--domain <domain>","Target domain").option("--url <url>","Target page URL").option("--location <location>","Target location").option("--max-results <n>","Maximum SERP or Maps results").option("--max-questions <n>","Maximum PAA questions").option("--extract-top <n>","Top result pages or citation pages to extract").option("--depth <n>","PAA expansion depth").option("--no-serp","Skip SERP evidence for agent packet").option("--no-paa","Skip PAA evidence for agent packet").option("--query <query>","Business category or workflow query").option("--state <state>","US state").option("--min-pop <n>","Minimum city population").option("--max-cities <n>","Maximum selected cities").option("--per-city <n>","Maps results per city").option("--concurrency <n>","City search concurrency").option("--proxy-mode <mode>","Proxy mode: location, configured, or none").option("--hydrate-top <n>","Profiles to hydrate per city for competitive audits").option("--reviews <n>","Review cards to collect per hydrated profile").option("--no-return-partial","Fail instead of writing partial artifacts").action(async(t,r)=>{let o=await U(t,ee(t,r),{apiKey:r.apiKey,apiUrl:r.apiUrl,outputDir:r.outputDir});r.json?s(o,!0):s([`${o.title}: ${o.status}`,o.summary,o.reportPath?`Report: ${o.reportPath}`:"",o.warnings.length?`Warnings:
+${o.warnings.map(d=>`- ${d}`).join(`
+`)}`:""].filter(Boolean).join(`
+`),!1)});let u=e.command("report").description("List and open local workflow reports.");u.command("list").description("List recent workflow reports.").option("--output-dir <path>","Workflow output directory").option("--json","Print machine-readable JSON").action(async t=>{let r=await N(t.outputDir);s(t.json?{reports:r}:r.map(o=>`${o.startedAt}	${o.workflow}	${o.status}	${o.reportPath??o.manifestPath}`).join(`
+`),t.json)}),u.command("path [id]").description("Print a report path. Defaults to last.").option("--output-dir <path>","Workflow output directory").option("--json","Print machine-readable JSON").action(async(t="last",r)=>{let o=await M(t,r.outputDir);if(!o?.reportPath)throw new Error(`No report found for "${t}"`);s(r.json?{path:o.reportPath,run:o}:o.reportPath,r.json)}),u.command("open [id]").description("Open a report. Defaults to last.").option("--output-dir <path>","Workflow output directory").option("--json","Print machine-readable JSON instead of opening").action(async(t="last",r)=>{if(r.json){let d=await M(t,r.outputDir);if(!d?.reportPath)throw new Error(`No report found for "${t}"`);s({path:d.reportPath,run:d},!0);return}let o=await L(t,r.outputDir);s(`Opened: ${o}`,!1)});let a=e.command("schedule").description("Create and manage hosted workflow schedules.");be(a.command("create <workflowId>").description("Create a recurring hosted workflow schedule.").option("--api-key <key>","MCP Scraper API key").option("--api-url <url>","MCP Scraper API URL","https://mcpscraper.dev").option("--name <name>","Schedule name").option("--daily","Run daily").option("--weekly","Run weekly").option("--monthly","Run monthly").option("--timezone <tz>","Schedule timezone","UTC").option("--webhook <url>","HTTPS webhook URL").option("--next-run-at <iso>","First run time as an ISO timestamp").option("--json","Print machine-readable JSON")).action(async(t,r)=>{let o=await m("/workflows/schedules","POST",r,{workflowId:t,name:r.name,input:ee(t,r),cadence:ve(r),timezone:r.timezone,webhookUrl:r.webhook,nextRunAt:r.nextRunAt});s(o,r.json)}),a.command("list").description("List hosted workflow schedules.").option("--api-key <key>","MCP Scraper API key").option("--api-url <url>","MCP Scraper API URL","https://mcpscraper.dev").option("--json","Print machine-readable JSON").action(async t=>{let r=await m("/workflows/schedules","GET",t);t.json?s(r,!0):s(r.schedules.map(o=>`${o.id}	${o.status}	${o.workflow_id}	${o.next_run_at??""}`).join(`
+`),!1)}),a.command("pause <id>").description("Pause a hosted workflow schedule.").option("--api-key <key>","MCP Scraper API key").option("--api-url <url>","MCP Scraper API URL","https://mcpscraper.dev").option("--json","Print machine-readable JSON").action(async(t,r)=>s(await m(`/workflows/schedules/${t}`,"PATCH",r,{status:"paused"}),r.json)),a.command("resume <id>").description("Resume a hosted workflow schedule.").option("--api-key <key>","MCP Scraper API key").option("--api-url <url>","MCP Scraper API URL","https://mcpscraper.dev").option("--json","Print machine-readable JSON").action(async(t,r)=>s(await m(`/workflows/schedules/${t}`,"PATCH",r,{status:"active"}),r.json)),a.command("delete <id>").description("Delete a hosted workflow schedule.").option("--api-key <key>","MCP Scraper API key").option("--api-url <url>","MCP Scraper API URL","https://mcpscraper.dev").option("--json","Print machine-readable JSON").action(async(t,r)=>s(await m(`/workflows/schedules/${t}`,"DELETE",r),r.json)),a.command("run <id>").description("Run a hosted workflow schedule now.").option("--api-key <key>","MCP Scraper API key").option("--api-url <url>","MCP Scraper API URL","https://mcpscraper.dev").option("--json","Print machine-readable JSON").action(async(t,r)=>s(await m(`/workflows/schedules/${t}/run`,"POST",r,{}),r.json));let l=e.command("runs").description("Inspect and download hosted workflow runs.");return l.command("list").description("List hosted workflow runs.").option("--api-key <key>","MCP Scraper API key").option("--api-url <url>","MCP Scraper API URL","https://mcpscraper.dev").option("--json","Print machine-readable JSON").action(async t=>{let r=await m("/workflows/runs","GET",t);t.json?s(r,!0):s(r.runs.map(o=>`${o.id}	${o.status}	${o.workflow_id}	${o.queued_at}`).join(`
+`),!1)}),l.command("status <id>").description("Show a hosted workflow run.").option("--api-key <key>","MCP Scraper API key").option("--api-url <url>","MCP Scraper API URL","https://mcpscraper.dev").option("--json","Print machine-readable JSON").action(async(t,r)=>s(await m(`/workflows/runs/${t}`,"GET",r),r.json)),l.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(t,r)=>{let o=await m(`/workflows/runs/${t}`,"GET",r),{apiUrl:d,apiKey:C}=oe(r),h=Z(r.outputDir??E(),"workflow-downloads",t);await ke(h,{recursive:!0});let k=[];for(let g of o.run.artifacts??[]){let w=await fetch(`${d}/workflows/runs/${t}/artifacts/${g.id}`,{headers:{"x-api-key":C}});if(!w.ok)throw new Error(`Failed to download ${g.label}: HTTP ${w.status}`);let y=Z(h,Ce(g.path));await Pe(y,Buffer.from(await w.arrayBuffer())),k.push(y)}s(r.json?{runId:t,files:k}:k.join(`
+`),r.json)}),e}async function ie(e=process.argv){await Se().parseAsync(e)}ie().catch(e=>{console.error(e instanceof Error?e.message:String(e)),process.exit(1)});