mcp-scraper 0.2.17 → 0.2.19

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

@@ -9,7 +9,7 @@ import {
 } from "../chunk-F44RBOJ5.js";
 import {
   PACKAGE_VERSION
-} from "../chunk-NZG2K6CJ.js";
+} from "../chunk-RU2HZD55.js";
 
 // src/cli/human-cli.ts
 import { Command } from "commander";

package/dist/bin/mcp-scraper-combined-stdio-server.cjs

@@ -212,7 +212,7 @@ var import_node_os2 = require("os");
 var import_node_path2 = require("path");
 
 // src/version.ts
-var PACKAGE_VERSION = "0.2.17";
+var PACKAGE_VERSION = "0.2.19";
 
 // src/mcp/browser-agent-tool-schemas.ts
 var import_zod = require("zod");
@@ -3429,7 +3429,111 @@ function registerPaaExtractorMcpTools(server2, executor, options = {}) {
   }, async (input) => formatCreditsInfo(await executor.creditsInfo(input), input));
 }
 
+// src/install-terminal.ts
+var CODES = {
+  reset: "\x1B[0m",
+  cyan: "\x1B[36m",
+  lime: "\x1B[32m",
+  amber: "\x1B[33m",
+  red: "\x1B[31m",
+  muted: "\x1B[90m",
+  bold: "\x1B[1m"
+};
+function colorize(value, tone, enabled) {
+  if (!enabled) return value;
+  return `${CODES[tone]}${value}${CODES.reset}`;
+}
+function toolRow(label, tools, enabled) {
+  const padded = label.padEnd(9, " ");
+  return `  ${colorize(padded, "muted", enabled)} ${tools.join(colorize("  .  ", "muted", enabled))}`;
+}
+function renderInstallTerminal(options) {
+  const color = options.color ?? true;
+  const apiKeyValue = options.apiKeyConfigured ? "$MCP_SCRAPER_API_KEY" : "sk_live_your_key";
+  const ascii = String.raw`
+ __  __  ____ ____ 
+|  \/  |/ ___|  _ \
+| |\/| | |   | |_) |
+| |  | | |___|  __/
+|_|  |_|\____|_|
+
+ ____   ____ ____      _    ____  _____ ____
+/ ___| / ___|  _ \    / \  |  _ \| ____|  _ \
+\___ \| |   | |_) |  / _ \ | |_) |  _| | |_) |
+ ___) | |___|  _ <  / ___ \|  __/| |___|  _ <
+|____/ \____|_| \_\/_/   \_\_|   |_____|_| \_\
+`;
+  const claudeCommand = [
+    "claude mcp add mcp-scraper --scope user",
+    `  --env MCP_SCRAPER_API_KEY=${apiKeyValue}`,
+    "  -- npx -y -p mcp-scraper@latest mcp-scraper-combined"
+  ].join(" \\\n");
+  const codexConfig = [
+    "[mcp_servers.mcp-scraper]",
+    'command = "npx"',
+    'args = ["-y", "-p", "mcp-scraper@latest", "mcp-scraper-combined"]',
+    `env = { MCP_SCRAPER_API_KEY = "${apiKeyValue}" }`
+  ].join("\n");
+  return [
+    colorize(`mcp-scraper v${options.version}`, "bold", color),
+    colorize("> mcp-scraper-install", "muted", color),
+    colorize(ascii, "amber", color),
+    `${colorize("MCP Scraper Agent", "cyan", color)}  .  v${options.version}  .  mcpscraper.dev`,
+    "1/1 install surfaces ready",
+    colorize("Newest: MCP workflow tools for market analysis, ICP research, CRO audits, brand briefs, and AI search visibility.", "lime", color),
+    "",
+    `${colorize("Tools", "cyan", color)}  ${colorize("(38 MCP tools)", "muted", color)}`,
+    toolRow("search", ["harvest_paa", "search_serp", "maps_search", "maps_place_intel"], color),
+    toolRow("extract", ["extract_url", "map_site_urls", "extract_site", "directory_workflow"], color),
+    toolRow("build", ["rank_tracker_blueprint", "cron plan", "database prompt"], color),
+    toolRow("media", ["youtube_harvest", "youtube_transcribe", "facebook_ad_search", "facebook_page_intel", "facebook_ad_transcribe", "facebook_video_transcribe"], color),
+    toolRow("browser", ["browser_open", "browser_screenshot", "browser_read", "browser_locate", "browser_replay_mark", "browser_replay_annotate"], color),
+    toolRow("account", ["credits_info", "local reports", "MCP resources"], color),
+    `${colorize("Workflows", "cyan", color)}  ${colorize("(MCP + CLI + API)", "muted", color)}`,
+    toolRow("route", ["workflow_list", "workflow_suggest", "workflow_run", "workflow_status", "workflow_artifact_read"], color),
+    toolRow("seo", ["directory", "agent-packet", "local audit", "map/serp comparison", "PAA/AIO briefs", "scheduled runs"], color),
+    "",
+    colorize("Usage tips:", "amber", color),
+    "Run mcp-scraper-combined in a human terminal to print this card; MCP clients get the same command as a silent stdio server.",
+    "Explicit card command: npx -y -p mcp-scraper@latest mcp-scraper-install",
+    "Start with workflow_suggest for broad jobs like market analysis, ICP research, CRO audits, brand briefs, content gaps, and AI visibility.",
+    "For MCP clients, use mcp-scraper-combined so one install can mix SERP, Maps, browser, reports, and saved MCP resources.",
+    "If you hit the concurrency limit, add an extra slot for $5/month with mcp-scraper-cli billing concurrency checkout.",
+    "",
+    `${colorize("Ready.", "lime", color)} Install the combined MCP server with one of these paths:`,
+    "",
+    colorize("Setup doctor", "amber", color),
+    "npx -y -p mcp-scraper@latest mcp-scraper-cli doctor",
+    "",
+    colorize("Claude Code", "amber", color),
+    claudeCommand,
+    "",
+    colorize("Codex config", "amber", color),
+    codexConfig,
+    "",
+    colorize("Claude Desktop Extension", "amber", color),
+    "Download: https://mcpscraper.dev/downloads/mcp-scraper.mcpb",
+    "",
+    colorize("Safety note:", "muted", color),
+    "mcp-scraper-combined prints this card only when stdin/stdout are an interactive TTY. In MCP clients it writes only JSON-RPC to stdout.",
+    "Use --stdio or MCP_SCRAPER_FORCE_STDIO=1 to force server mode from a terminal.",
+    ""
+  ].join("\n");
+}
+
 // bin/mcp-scraper-combined-stdio-server.ts
+var forceStdio = process.argv.includes("--stdio") || process.env.MCP_SCRAPER_FORCE_STDIO === "1";
+var interactiveTerminal = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+var wantsHelp = process.argv.includes("--help") || process.argv.includes("-h");
+if (!forceStdio && (interactiveTerminal || wantsHelp)) {
+  const noColor = process.argv.includes("--no-color") || process.env.NO_COLOR !== void 0 || process.env.FORCE_COLOR === "0" || !process.stdout.isTTY;
+  process.stdout.write(renderInstallTerminal({
+    version: PACKAGE_VERSION,
+    color: !noColor,
+    apiKeyConfigured: Boolean(process.env.MCP_SCRAPER_API_KEY?.trim())
+  }));
+  process.exit(0);
+}
 function readApiKeyFile() {
   const explicitPath = process.env.MCP_SCRAPER_KEY_PATH?.trim();
   const paths = [explicitPath, (0, import_node_path5.join)((0, import_node_os4.homedir)(), ".mcp-scraper-key")].filter(Boolean);