mcp-scraper 0.2.5 → 0.2.6

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

@@ -2,14 +2,14 @@
 import {
   HttpMcpToolExecutor,
   registerPaaExtractorMcpTools
-} from "../chunk-ENI4DM3S.js";
+} from "../chunk-7WB2W6FO.js";
 import "../chunk-M2S27J6Z.js";
 import {
   registerBrowserAgentMcpTools
-} from "../chunk-O36HHUKX.js";
+} from "../chunk-XL4V7VKD.js";
 import {
   PACKAGE_VERSION
-} from "../chunk-JDX57SEC.js";
+} from "../chunk-T6SIPPOQ.js";
 
 // bin/mcp-scraper-combined-stdio-server.ts
 import { readFileSync } from "fs";

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

@@ -53,9 +53,10 @@ function renderInstallTerminal(options) {
     `${colorize("MCP Scraper Agent", "cyan", color)}  .  v${options.version}  .  mcpscraper.dev`,
     "1/1 install surfaces ready",
     "",
-    `${colorize("Tools", "cyan", color)}  ${colorize("(28 loaded)", "muted", color)}`,
+    `${colorize("Tools", "cyan", color)}  ${colorize("(29 loaded)", "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"], color),
     toolRow("browser", ["browser_open", "browser_screenshot", "browser_click", "browser_replay_download"], color),
     toolRow("account", ["credits_info", "local reports", "MCP resources"], color),
@@ -78,7 +79,7 @@ function renderInstallTerminal(options) {
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.2.5";
+var PACKAGE_VERSION = "0.2.6";
 
 // bin/mcp-scraper-install.ts
 var noColor = process.argv.includes("--no-color") || process.env.NO_COLOR !== void 0 || process.env.FORCE_COLOR === "0" || !process.stdout.isTTY;

package/dist/bin/mcp-scraper-install.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/install-terminal.ts","../../src/version.ts","../../bin/mcp-scraper-install.ts"],"sourcesContent":["export interface InstallTerminalOptions {\n  color?: boolean\n  version: string\n  apiKeyConfigured?: boolean\n}\n\ntype Tone = 'cyan' | 'lime' | 'amber' | 'red' | 'muted' | 'bold'\n\nconst CODES: Record<Tone | 'reset', string> = {\n  reset: '\\x1b[0m',\n  cyan: '\\x1b[36m',\n  lime: '\\x1b[32m',\n  amber: '\\x1b[33m',\n  red: '\\x1b[31m',\n  muted: '\\x1b[90m',\n  bold: '\\x1b[1m',\n}\n\nfunction colorize(value: string, tone: Tone, enabled: boolean): string {\n  if (!enabled) return value\n  return `${CODES[tone]}${value}${CODES.reset}`\n}\n\nfunction toolRow(label: string, tools: string[], enabled: boolean): string {\n  const padded = label.padEnd(9, ' ')\n  return `  ${colorize(padded, 'muted', enabled)} ${tools.join(colorize('  .  ', 'muted', enabled))}`\n}\n\nexport function renderInstallTerminal(options: InstallTerminalOptions): string {\n  const color = options.color ?? true\n  const apiKeyValue = options.apiKeyConfigured ? '$MCP_SCRAPER_API_KEY' : 'sk_live_your_key'\n  const ascii = String.raw`\n __  __  ____ ____ \n|  \\/  |/ ___|  _ \\\n| |\\/| | |   | |_) |\n| |  | | |___|  __/\n|_|  |_|\\____|_|\n\n ____   ____ ____      _    ____  _____ ____\n/ ___| / ___|  _ \\    / \\  |  _ \\| ____|  _ \\\n\\___ \\| |   | |_) |  / _ \\ | |_) |  _| | |_) |\n ___) | |___|  _ <  / ___ \\|  __/| |___|  _ <\n|____/ \\____|_| \\_\\/_/   \\_\\_|   |_____|_| \\_\\\n`\n\n  const claudeCommand = [\n    'claude mcp add mcp-scraper --scope user',\n    `  --env MCP_SCRAPER_API_KEY=${apiKeyValue}`,\n    '  -- npx -y -p mcp-scraper@latest mcp-scraper-combined',\n  ].join(' \\\\\\n')\n\n  const codexConfig = [\n    '[mcp_servers.mcp-scraper]',\n    'command = \"npx\"',\n    'args = [\"-y\", \"-p\", \"mcp-scraper@latest\", \"mcp-scraper-combined\"]',\n    `env = { MCP_SCRAPER_API_KEY = \"${apiKeyValue}\" }`,\n  ].join('\\n')\n\n  return [\n    colorize(`mcp-scraper v${options.version}`, 'bold', color),\n    colorize('> mcp-scraper-install', 'muted', color),\n    colorize(ascii, 'amber', color),\n    `${colorize('MCP Scraper Agent', 'cyan', color)}  .  v${options.version}  .  mcpscraper.dev`,\n    '1/1 install surfaces ready',\n    '',\n    `${colorize('Tools', 'cyan', color)}  ${colorize('(28 loaded)', 'muted', color)}`,\n    toolRow('search', ['harvest_paa', 'search_serp', 'maps_search', 'maps_place_intel'], color),\n    toolRow('extract', ['extract_url', 'map_site_urls', 'extract_site', 'directory_workflow'], color),\n    toolRow('media', ['youtube_harvest', 'youtube_transcribe', 'facebook_ad_search', 'facebook_page_intel'], color),\n    toolRow('browser', ['browser_open', 'browser_screenshot', 'browser_click', 'browser_replay_download'], color),\n    toolRow('account', ['credits_info', 'local reports', 'MCP resources'], color),\n    '',\n    `${colorize('Ready.', 'lime', color)} Install the combined MCP server with one of these paths:`,\n    '',\n    colorize('Claude Code', 'amber', color),\n    claudeCommand,\n    '',\n    colorize('Codex config', 'amber', color),\n    codexConfig,\n    '',\n    colorize('Claude Desktop Extension', 'amber', color),\n    'Download: https://mcpscraper.dev/downloads/mcp-scraper.mcpb',\n    '',\n    colorize('Safety note:', 'muted', color),\n    'This installer can print terminal UI. MCP server commands stay silent so stdio JSON-RPC is not corrupted.',\n    '',\n  ].join('\\n')\n}\n","export const PACKAGE_VERSION = '0.2.5'\n","#!/usr/bin/env node\nimport { renderInstallTerminal } from '../src/install-terminal.js'\nimport { PACKAGE_VERSION } from '../src/version.js'\n\nconst noColor =\n  process.argv.includes('--no-color') ||\n  process.env.NO_COLOR !== undefined ||\n  process.env.FORCE_COLOR === '0' ||\n  !process.stdout.isTTY\n\nconst help = process.argv.includes('--help') || process.argv.includes('-h')\nif (help) {\n  process.stdout.write([\n    'Usage: mcp-scraper-install [--no-color]',\n    '',\n    'Prints the branded MCP Scraper terminal install card and copyable install commands.',\n    'Use mcp-scraper-combined, mcp-scraper, and browser-agent only as MCP stdio servers.',\n    '',\n  ].join('\\n'))\n  process.exit(0)\n}\n\nprocess.stdout.write(renderInstallTerminal({\n  version: PACKAGE_VERSION,\n  color: !noColor,\n  apiKeyConfigured: Boolean(process.env.MCP_SCRAPER_API_KEY?.trim()),\n}))\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/install-terminal.ts","../../src/version.ts","../../bin/mcp-scraper-install.ts"],"sourcesContent":["export interface InstallTerminalOptions {\n  color?: boolean\n  version: string\n  apiKeyConfigured?: boolean\n}\n\ntype Tone = 'cyan' | 'lime' | 'amber' | 'red' | 'muted' | 'bold'\n\nconst CODES: Record<Tone | 'reset', string> = {\n  reset: '\\x1b[0m',\n  cyan: '\\x1b[36m',\n  lime: '\\x1b[32m',\n  amber: '\\x1b[33m',\n  red: '\\x1b[31m',\n  muted: '\\x1b[90m',\n  bold: '\\x1b[1m',\n}\n\nfunction colorize(value: string, tone: Tone, enabled: boolean): string {\n  if (!enabled) return value\n  return `${CODES[tone]}${value}${CODES.reset}`\n}\n\nfunction toolRow(label: string, tools: string[], enabled: boolean): string {\n  const padded = label.padEnd(9, ' ')\n  return `  ${colorize(padded, 'muted', enabled)} ${tools.join(colorize('  .  ', 'muted', enabled))}`\n}\n\nexport function renderInstallTerminal(options: InstallTerminalOptions): string {\n  const color = options.color ?? true\n  const apiKeyValue = options.apiKeyConfigured ? '$MCP_SCRAPER_API_KEY' : 'sk_live_your_key'\n  const ascii = String.raw`\n __  __  ____ ____ \n|  \\/  |/ ___|  _ \\\n| |\\/| | |   | |_) |\n| |  | | |___|  __/\n|_|  |_|\\____|_|\n\n ____   ____ ____      _    ____  _____ ____\n/ ___| / ___|  _ \\    / \\  |  _ \\| ____|  _ \\\n\\___ \\| |   | |_) |  / _ \\ | |_) |  _| | |_) |\n ___) | |___|  _ <  / ___ \\|  __/| |___|  _ <\n|____/ \\____|_| \\_\\/_/   \\_\\_|   |_____|_| \\_\\\n`\n\n  const claudeCommand = [\n    'claude mcp add mcp-scraper --scope user',\n    `  --env MCP_SCRAPER_API_KEY=${apiKeyValue}`,\n    '  -- npx -y -p mcp-scraper@latest mcp-scraper-combined',\n  ].join(' \\\\\\n')\n\n  const codexConfig = [\n    '[mcp_servers.mcp-scraper]',\n    'command = \"npx\"',\n    'args = [\"-y\", \"-p\", \"mcp-scraper@latest\", \"mcp-scraper-combined\"]',\n    `env = { MCP_SCRAPER_API_KEY = \"${apiKeyValue}\" }`,\n  ].join('\\n')\n\n  return [\n    colorize(`mcp-scraper v${options.version}`, 'bold', color),\n    colorize('> mcp-scraper-install', 'muted', color),\n    colorize(ascii, 'amber', color),\n    `${colorize('MCP Scraper Agent', 'cyan', color)}  .  v${options.version}  .  mcpscraper.dev`,\n    '1/1 install surfaces ready',\n    '',\n    `${colorize('Tools', 'cyan', color)}  ${colorize('(29 loaded)', 'muted', color)}`,\n    toolRow('search', ['harvest_paa', 'search_serp', 'maps_search', 'maps_place_intel'], color),\n    toolRow('extract', ['extract_url', 'map_site_urls', 'extract_site', 'directory_workflow'], color),\n    toolRow('build', ['rank_tracker_blueprint', 'cron plan', 'database prompt'], color),\n    toolRow('media', ['youtube_harvest', 'youtube_transcribe', 'facebook_ad_search', 'facebook_page_intel'], color),\n    toolRow('browser', ['browser_open', 'browser_screenshot', 'browser_click', 'browser_replay_download'], color),\n    toolRow('account', ['credits_info', 'local reports', 'MCP resources'], color),\n    '',\n    `${colorize('Ready.', 'lime', color)} Install the combined MCP server with one of these paths:`,\n    '',\n    colorize('Claude Code', 'amber', color),\n    claudeCommand,\n    '',\n    colorize('Codex config', 'amber', color),\n    codexConfig,\n    '',\n    colorize('Claude Desktop Extension', 'amber', color),\n    'Download: https://mcpscraper.dev/downloads/mcp-scraper.mcpb',\n    '',\n    colorize('Safety note:', 'muted', color),\n    'This installer can print terminal UI. MCP server commands stay silent so stdio JSON-RPC is not corrupted.',\n    '',\n  ].join('\\n')\n}\n","export const PACKAGE_VERSION = '0.2.6'\n","#!/usr/bin/env node\nimport { renderInstallTerminal } from '../src/install-terminal.js'\nimport { PACKAGE_VERSION } from '../src/version.js'\n\nconst noColor =\n  process.argv.includes('--no-color') ||\n  process.env.NO_COLOR !== undefined ||\n  process.env.FORCE_COLOR === '0' ||\n  !process.stdout.isTTY\n\nconst help = process.argv.includes('--help') || process.argv.includes('-h')\nif (help) {\n  process.stdout.write([\n    'Usage: mcp-scraper-install [--no-color]',\n    '',\n    'Prints the branded MCP Scraper terminal install card and copyable install commands.',\n    'Use mcp-scraper-combined, mcp-scraper, and browser-agent only as MCP stdio servers.',\n    '',\n  ].join('\\n'))\n  process.exit(0)\n}\n\nprocess.stdout.write(renderInstallTerminal({\n  version: PACKAGE_VERSION,\n  color: !noColor,\n  apiKeyConfigured: Boolean(process.env.MCP_SCRAPER_API_KEY?.trim()),\n}))\n"],"mappings":"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","names":[]}

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

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   PACKAGE_VERSION
-} from "../chunk-JDX57SEC.js";
+} from "../chunk-T6SIPPOQ.js";
 
 // src/install-terminal.ts
 var CODES = {
@@ -55,9 +55,10 @@ function renderInstallTerminal(options) {
     `${colorize("MCP Scraper Agent", "cyan", color)}  .  v${options.version}  .  mcpscraper.dev`,
     "1/1 install surfaces ready",
     "",
-    `${colorize("Tools", "cyan", color)}  ${colorize("(28 loaded)", "muted", color)}`,
+    `${colorize("Tools", "cyan", color)}  ${colorize("(29 loaded)", "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"], color),
     toolRow("browser", ["browser_open", "browser_screenshot", "browser_click", "browser_replay_download"], color),
     toolRow("account", ["credits_info", "local reports", "MCP resources"], color),

package/dist/bin/mcp-scraper-install.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/install-terminal.ts","../../bin/mcp-scraper-install.ts"],"sourcesContent":["export interface InstallTerminalOptions {\n  color?: boolean\n  version: string\n  apiKeyConfigured?: boolean\n}\n\ntype Tone = 'cyan' | 'lime' | 'amber' | 'red' | 'muted' | 'bold'\n\nconst CODES: Record<Tone | 'reset', string> = {\n  reset: '\\x1b[0m',\n  cyan: '\\x1b[36m',\n  lime: '\\x1b[32m',\n  amber: '\\x1b[33m',\n  red: '\\x1b[31m',\n  muted: '\\x1b[90m',\n  bold: '\\x1b[1m',\n}\n\nfunction colorize(value: string, tone: Tone, enabled: boolean): string {\n  if (!enabled) return value\n  return `${CODES[tone]}${value}${CODES.reset}`\n}\n\nfunction toolRow(label: string, tools: string[], enabled: boolean): string {\n  const padded = label.padEnd(9, ' ')\n  return `  ${colorize(padded, 'muted', enabled)} ${tools.join(colorize('  .  ', 'muted', enabled))}`\n}\n\nexport function renderInstallTerminal(options: InstallTerminalOptions): string {\n  const color = options.color ?? true\n  const apiKeyValue = options.apiKeyConfigured ? '$MCP_SCRAPER_API_KEY' : 'sk_live_your_key'\n  const ascii = String.raw`\n __  __  ____ ____ \n|  \\/  |/ ___|  _ \\\n| |\\/| | |   | |_) |\n| |  | | |___|  __/\n|_|  |_|\\____|_|\n\n ____   ____ ____      _    ____  _____ ____\n/ ___| / ___|  _ \\    / \\  |  _ \\| ____|  _ \\\n\\___ \\| |   | |_) |  / _ \\ | |_) |  _| | |_) |\n ___) | |___|  _ <  / ___ \\|  __/| |___|  _ <\n|____/ \\____|_| \\_\\/_/   \\_\\_|   |_____|_| \\_\\\n`\n\n  const claudeCommand = [\n    'claude mcp add mcp-scraper --scope user',\n    `  --env MCP_SCRAPER_API_KEY=${apiKeyValue}`,\n    '  -- npx -y -p mcp-scraper@latest mcp-scraper-combined',\n  ].join(' \\\\\\n')\n\n  const codexConfig = [\n    '[mcp_servers.mcp-scraper]',\n    'command = \"npx\"',\n    'args = [\"-y\", \"-p\", \"mcp-scraper@latest\", \"mcp-scraper-combined\"]',\n    `env = { MCP_SCRAPER_API_KEY = \"${apiKeyValue}\" }`,\n  ].join('\\n')\n\n  return [\n    colorize(`mcp-scraper v${options.version}`, 'bold', color),\n    colorize('> mcp-scraper-install', 'muted', color),\n    colorize(ascii, 'amber', color),\n    `${colorize('MCP Scraper Agent', 'cyan', color)}  .  v${options.version}  .  mcpscraper.dev`,\n    '1/1 install surfaces ready',\n    '',\n    `${colorize('Tools', 'cyan', color)}  ${colorize('(28 loaded)', 'muted', color)}`,\n    toolRow('search', ['harvest_paa', 'search_serp', 'maps_search', 'maps_place_intel'], color),\n    toolRow('extract', ['extract_url', 'map_site_urls', 'extract_site', 'directory_workflow'], color),\n    toolRow('media', ['youtube_harvest', 'youtube_transcribe', 'facebook_ad_search', 'facebook_page_intel'], color),\n    toolRow('browser', ['browser_open', 'browser_screenshot', 'browser_click', 'browser_replay_download'], color),\n    toolRow('account', ['credits_info', 'local reports', 'MCP resources'], color),\n    '',\n    `${colorize('Ready.', 'lime', color)} Install the combined MCP server with one of these paths:`,\n    '',\n    colorize('Claude Code', 'amber', color),\n    claudeCommand,\n    '',\n    colorize('Codex config', 'amber', color),\n    codexConfig,\n    '',\n    colorize('Claude Desktop Extension', 'amber', color),\n    'Download: https://mcpscraper.dev/downloads/mcp-scraper.mcpb',\n    '',\n    colorize('Safety note:', 'muted', color),\n    'This installer can print terminal UI. MCP server commands stay silent so stdio JSON-RPC is not corrupted.',\n    '',\n  ].join('\\n')\n}\n","#!/usr/bin/env node\nimport { renderInstallTerminal } from '../src/install-terminal.js'\nimport { PACKAGE_VERSION } from '../src/version.js'\n\nconst noColor =\n  process.argv.includes('--no-color') ||\n  process.env.NO_COLOR !== undefined ||\n  process.env.FORCE_COLOR === '0' ||\n  !process.stdout.isTTY\n\nconst help = process.argv.includes('--help') || process.argv.includes('-h')\nif (help) {\n  process.stdout.write([\n    'Usage: mcp-scraper-install [--no-color]',\n    '',\n    'Prints the branded MCP Scraper terminal install card and copyable install commands.',\n    'Use mcp-scraper-combined, mcp-scraper, and browser-agent only as MCP stdio servers.',\n    '',\n  ].join('\\n'))\n  process.exit(0)\n}\n\nprocess.stdout.write(renderInstallTerminal({\n  version: PACKAGE_VERSION,\n  color: !noColor,\n  apiKeyConfigured: Boolean(process.env.MCP_SCRAPER_API_KEY?.trim()),\n}))\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/install-terminal.ts","../../bin/mcp-scraper-install.ts"],"sourcesContent":["export interface InstallTerminalOptions {\n  color?: boolean\n  version: string\n  apiKeyConfigured?: boolean\n}\n\ntype Tone = 'cyan' | 'lime' | 'amber' | 'red' | 'muted' | 'bold'\n\nconst CODES: Record<Tone | 'reset', string> = {\n  reset: '\\x1b[0m',\n  cyan: '\\x1b[36m',\n  lime: '\\x1b[32m',\n  amber: '\\x1b[33m',\n  red: '\\x1b[31m',\n  muted: '\\x1b[90m',\n  bold: '\\x1b[1m',\n}\n\nfunction colorize(value: string, tone: Tone, enabled: boolean): string {\n  if (!enabled) return value\n  return `${CODES[tone]}${value}${CODES.reset}`\n}\n\nfunction toolRow(label: string, tools: string[], enabled: boolean): string {\n  const padded = label.padEnd(9, ' ')\n  return `  ${colorize(padded, 'muted', enabled)} ${tools.join(colorize('  .  ', 'muted', enabled))}`\n}\n\nexport function renderInstallTerminal(options: InstallTerminalOptions): string {\n  const color = options.color ?? true\n  const apiKeyValue = options.apiKeyConfigured ? '$MCP_SCRAPER_API_KEY' : 'sk_live_your_key'\n  const ascii = String.raw`\n __  __  ____ ____ \n|  \\/  |/ ___|  _ \\\n| |\\/| | |   | |_) |\n| |  | | |___|  __/\n|_|  |_|\\____|_|\n\n ____   ____ ____      _    ____  _____ ____\n/ ___| / ___|  _ \\    / \\  |  _ \\| ____|  _ \\\n\\___ \\| |   | |_) |  / _ \\ | |_) |  _| | |_) |\n ___) | |___|  _ <  / ___ \\|  __/| |___|  _ <\n|____/ \\____|_| \\_\\/_/   \\_\\_|   |_____|_| \\_\\\n`\n\n  const claudeCommand = [\n    'claude mcp add mcp-scraper --scope user',\n    `  --env MCP_SCRAPER_API_KEY=${apiKeyValue}`,\n    '  -- npx -y -p mcp-scraper@latest mcp-scraper-combined',\n  ].join(' \\\\\\n')\n\n  const codexConfig = [\n    '[mcp_servers.mcp-scraper]',\n    'command = \"npx\"',\n    'args = [\"-y\", \"-p\", \"mcp-scraper@latest\", \"mcp-scraper-combined\"]',\n    `env = { MCP_SCRAPER_API_KEY = \"${apiKeyValue}\" }`,\n  ].join('\\n')\n\n  return [\n    colorize(`mcp-scraper v${options.version}`, 'bold', color),\n    colorize('> mcp-scraper-install', 'muted', color),\n    colorize(ascii, 'amber', color),\n    `${colorize('MCP Scraper Agent', 'cyan', color)}  .  v${options.version}  .  mcpscraper.dev`,\n    '1/1 install surfaces ready',\n    '',\n    `${colorize('Tools', 'cyan', color)}  ${colorize('(29 loaded)', 'muted', color)}`,\n    toolRow('search', ['harvest_paa', 'search_serp', 'maps_search', 'maps_place_intel'], color),\n    toolRow('extract', ['extract_url', 'map_site_urls', 'extract_site', 'directory_workflow'], color),\n    toolRow('build', ['rank_tracker_blueprint', 'cron plan', 'database prompt'], color),\n    toolRow('media', ['youtube_harvest', 'youtube_transcribe', 'facebook_ad_search', 'facebook_page_intel'], color),\n    toolRow('browser', ['browser_open', 'browser_screenshot', 'browser_click', 'browser_replay_download'], color),\n    toolRow('account', ['credits_info', 'local reports', 'MCP resources'], color),\n    '',\n    `${colorize('Ready.', 'lime', color)} Install the combined MCP server with one of these paths:`,\n    '',\n    colorize('Claude Code', 'amber', color),\n    claudeCommand,\n    '',\n    colorize('Codex config', 'amber', color),\n    codexConfig,\n    '',\n    colorize('Claude Desktop Extension', 'amber', color),\n    'Download: https://mcpscraper.dev/downloads/mcp-scraper.mcpb',\n    '',\n    colorize('Safety note:', 'muted', color),\n    'This installer can print terminal UI. MCP server commands stay silent so stdio JSON-RPC is not corrupted.',\n    '',\n  ].join('\\n')\n}\n","#!/usr/bin/env node\nimport { renderInstallTerminal } from '../src/install-terminal.js'\nimport { PACKAGE_VERSION } from '../src/version.js'\n\nconst noColor =\n  process.argv.includes('--no-color') ||\n  process.env.NO_COLOR !== undefined ||\n  process.env.FORCE_COLOR === '0' ||\n  !process.stdout.isTTY\n\nconst help = process.argv.includes('--help') || process.argv.includes('-h')\nif (help) {\n  process.stdout.write([\n    'Usage: mcp-scraper-install [--no-color]',\n    '',\n    'Prints the branded MCP Scraper terminal install card and copyable install commands.',\n    'Use mcp-scraper-combined, mcp-scraper, and browser-agent only as MCP stdio servers.',\n    '',\n  ].join('\\n'))\n  process.exit(0)\n}\n\nprocess.stdout.write(renderInstallTerminal({\n  version: PACKAGE_VERSION,\n  color: !noColor,\n  apiKeyConfigured: Boolean(process.env.MCP_SCRAPER_API_KEY?.trim()),\n}))\n"],"mappings":"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","names":[]}

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

@@ -136,7 +136,7 @@ var import_node_fs2 = require("fs");
 var import_node_path2 = require("path");
 
 // src/version.ts
-var PACKAGE_VERSION = "0.2.5";
+var PACKAGE_VERSION = "0.2.6";
 
 // src/mcp/mcp-response-formatter.ts
 var import_node_fs = require("fs");
@@ -1166,6 +1166,24 @@ var DirectoryWorkflowInputSchema = {
   proxyZip: import_zod.z.string().regex(/^\d{5}$/).optional().describe("Optional ZIP override for proxy targeting. Normally omit it so each city can use its Lead Magician ZIP group or city/state location."),
   debug: import_zod.z.boolean().default(false).describe("Include sanitized browser/proxy diagnostics in each Maps browser session when supported.")
 };
+var RankTrackerModeSchema = import_zod.z.enum(["maps", "organic", "ai_overview", "paa"]);
+var RankTrackerBlueprintInputSchema = {
+  projectName: import_zod.z.string().min(1).optional().describe("Optional name for the rank tracker project, client, or campaign."),
+  targetDomain: import_zod.z.string().min(1).optional().describe("Primary domain to track in organic results, AI Overview citations, and PAA sources, e.g. example.com."),
+  targetBusinessName: import_zod.z.string().min(1).optional().describe("Primary Google Business Profile or brand/business name to match in Maps results. Required for reliable Maps rank tracking."),
+  trackingModes: import_zod.z.array(RankTrackerModeSchema).min(1).max(4).default(["maps", "organic", "ai_overview", "paa"]).describe("Rank tracker surfaces to build. maps uses directory_workflow/maps_search. organic uses search_serp. ai_overview uses search_serp/harvest_paa. paa uses harvest_paa source presence."),
+  keywords: import_zod.z.array(import_zod.z.string().min(1)).max(200).default([]).describe("Seed keywords or service queries to track. Leave empty when the downstream AI should create the keyword table from user input."),
+  locations: import_zod.z.array(import_zod.z.string().min(1)).max(100).default([]).describe("Markets, cities, ZIPs, or service areas to track. Use city/state strings like Denver, CO for localized SERP and Maps checks."),
+  competitors: import_zod.z.array(import_zod.z.string().min(1)).max(100).default([]).describe("Optional competitor domains or business names to persist as comparison targets."),
+  database: import_zod.z.enum(["postgres", "neon", "supabase", "sqlite", "mysql"]).default("postgres").describe("Database family the downstream AI should target when generating migrations."),
+  scheduleCadence: import_zod.z.enum(["daily", "weekly", "monthly", "custom"]).default("weekly").describe("Default recurring rank check cadence for the generated cron/heartbeat plan."),
+  customCron: import_zod.z.string().min(1).optional().describe("Cron expression to use when scheduleCadence is custom."),
+  timezone: import_zod.z.string().min(1).default("UTC").describe("IANA timezone for scheduled rank checks, e.g. America/Denver."),
+  includeCron: import_zod.z.boolean().default(true).describe("Include a cron or heartbeat worker plan. Keep true for production rank trackers."),
+  includeDashboard: import_zod.z.boolean().default(true).describe("Include dashboard/reporting requirements in the generated prompt."),
+  includeAlerts: import_zod.z.boolean().default(true).describe("Include alert rules for rank movement and SERP feature gains/losses."),
+  notes: import_zod.z.string().max(4e3).optional().describe("Extra product, client, stack, or hosting requirements to include in the implementation prompt.")
+};
 var NullableString = import_zod.z.string().nullable();
 var MapsSearchOutputSchema = {
   query: import_zod.z.string(),
@@ -1241,6 +1259,39 @@ var DirectoryWorkflowOutputSchema = {
   })),
   durationMs: import_zod.z.number().int().min(0)
 };
+var RankTrackerToolPlanOutput = import_zod.z.object({
+  tool: import_zod.z.string(),
+  purpose: import_zod.z.string()
+});
+var RankTrackerTableOutput = import_zod.z.object({
+  name: import_zod.z.string(),
+  purpose: import_zod.z.string(),
+  keyColumns: import_zod.z.array(import_zod.z.string())
+});
+var RankTrackerCronJobOutput = import_zod.z.object({
+  name: import_zod.z.string(),
+  purpose: import_zod.z.string(),
+  modes: import_zod.z.array(RankTrackerModeSchema),
+  recommendedTools: import_zod.z.array(import_zod.z.string())
+});
+var RankTrackerBlueprintOutputSchema = {
+  projectName: import_zod.z.string(),
+  targetDomain: NullableString,
+  targetBusinessName: NullableString,
+  trackingModes: import_zod.z.array(RankTrackerModeSchema),
+  database: import_zod.z.string(),
+  recommendedTools: import_zod.z.array(RankTrackerToolPlanOutput),
+  tables: import_zod.z.array(RankTrackerTableOutput),
+  cron: import_zod.z.object({
+    enabled: import_zod.z.boolean(),
+    cadence: import_zod.z.string(),
+    expression: import_zod.z.string(),
+    timezone: import_zod.z.string(),
+    jobs: import_zod.z.array(RankTrackerCronJobOutput)
+  }),
+  metrics: import_zod.z.array(import_zod.z.string()),
+  implementationPrompt: import_zod.z.string()
+};
 var OrganicResultOutput = import_zod.z.object({
   position: import_zod.z.number().int(),
   title: import_zod.z.string(),
@@ -1455,6 +1506,329 @@ var CaptureSerpPageSnapshotsInputSchema = {
   debug: import_zod.z.boolean().default(false).describe("Include sanitized browser/proxy diagnostics for page snapshot debugging. Use true for capture, network, or proxy troubleshooting.")
 };
 
+// src/mcp/rank-tracker-blueprint.ts
+var DEFAULT_MODES = ["maps", "organic", "ai_overview", "paa"];
+function normalizeDomain(value) {
+  const trimmed = value?.trim();
+  if (!trimmed) return null;
+  try {
+    const url = new URL(trimmed.includes("://") ? trimmed : `https://${trimmed}`);
+    return url.hostname.replace(/^www\./, "").toLowerCase();
+  } catch {
+    return trimmed.replace(/^https?:\/\//, "").replace(/^www\./, "").split("/")[0]?.toLowerCase() || trimmed;
+  }
+}
+function uniqueModes(input) {
+  const modes = input?.length ? input : DEFAULT_MODES;
+  return [...new Set(modes)];
+}
+function cronExpression(cadence, customCron) {
+  if (cadence === "daily") return "15 6 * * *";
+  if (cadence === "monthly") return "15 6 1 * *";
+  if (cadence === "custom") return customCron?.trim() || "CUSTOM_CRON_EXPRESSION_REQUIRED";
+  return "15 6 * * 1";
+}
+function includes(modes, mode) {
+  return modes.includes(mode);
+}
+function buildToolPlan(modes) {
+  const plans = [];
+  const push = (tool, purpose) => {
+    if (!plans.some((plan) => plan.tool === tool)) plans.push({ tool, purpose });
+  };
+  push("credits_info", "Check account balance and rates before scheduling recurring rank checks.");
+  if (includes(modes, "maps")) {
+    push("directory_workflow", "Seed or refresh city-by-city Maps datasets when building local market coverage.");
+    push("maps_search", "Run recurring Google Maps category checks for each keyword and location.");
+    push("maps_place_intel", "Hydrate selected target or competitor GBP details when profile-level evidence is needed.");
+  }
+  if (includes(modes, "organic")) {
+    push("search_serp", "Capture localized organic rankings, local pack data, and AI Overview status without PAA expansion.");
+  }
+  if (includes(modes, "ai_overview")) {
+    push("search_serp", "Capture quick AI Overview detection and organic context for each tracked query.");
+    push("harvest_paa", "Use when AI Overview text, PAA context, or source-level evidence needs deeper capture.");
+  }
+  if (includes(modes, "paa")) {
+    push("harvest_paa", "Capture People Also Ask questions, answers, and source sites for PAA presence tracking.");
+  }
+  return plans;
+}
+function buildTables(modes, includeDashboard, includeAlerts, hasCompetitors) {
+  const tables = [
+    {
+      name: "rank_tracker_projects",
+      purpose: "One row per client, campaign, or tracked property.",
+      keyColumns: ["id", "name", "target_domain", "target_business_name", "database_mode", "timezone", "created_at"]
+    },
+    {
+      name: "rank_tracker_targets",
+      purpose: "Normalized target identities and match rules for domains, URLs, business names, CIDs, and competitors.",
+      keyColumns: ["id", "project_id", "kind", "value", "display_name", "match_rules_json", "active"]
+    },
+    {
+      name: "rank_tracker_keywords",
+      purpose: "Tracked keywords or service queries, separated from location so calls can localize correctly.",
+      keyColumns: ["id", "project_id", "keyword", "intent", "tags_json", "active"]
+    },
+    {
+      name: "rank_tracker_locations",
+      purpose: "Markets, cities, ZIPs, country/language settings, and proxy targeting hints.",
+      keyColumns: ["id", "project_id", "label", "gl", "hl", "proxy_zip", "device", "active"]
+    },
+    {
+      name: "rank_tracker_runs",
+      purpose: "Heartbeat table for every scheduled or manual rank check batch.",
+      keyColumns: ["id", "project_id", "scheduled_for", "started_at", "completed_at", "status", "idempotency_key", "error_message"]
+    }
+  ];
+  if (includes(modes, "organic")) {
+    tables.push({
+      name: "rank_tracker_organic_results",
+      purpose: "SERP organic result rows from search_serp, including target-domain matches and competitor rows.",
+      keyColumns: ["id", "run_id", "keyword_id", "location_id", "device", "position", "title", "url", "domain", "is_target"]
+    });
+  }
+  if (includes(modes, "maps")) {
+    tables.push({
+      name: "rank_tracker_maps_results",
+      purpose: "Google Maps result rows from maps_search and directory_workflow, including GBP identity fields.",
+      keyColumns: ["id", "run_id", "keyword_id", "location_id", "position", "business_name", "place_url", "cid", "website_url", "rating", "review_count", "is_target"]
+    });
+    tables.push({
+      name: "rank_tracker_market_seeds",
+      purpose: "Directory workflow city, population, ZIP-group, and market seed records used to build local tracking coverage.",
+      keyColumns: ["id", "project_id", "query", "city", "state", "population", "zip_group_json", "last_seeded_run_id"]
+    });
+  }
+  if (includes(modes, "ai_overview")) {
+    tables.push({
+      name: "rank_tracker_ai_overviews",
+      purpose: "AI Overview detection, text snapshot, citation domains, and target citation status per query/location.",
+      keyColumns: ["id", "run_id", "keyword_id", "location_id", "detected", "target_cited", "cited_domains_json", "overview_text"]
+    });
+  }
+  if (includes(modes, "paa")) {
+    tables.push({
+      name: "rank_tracker_paa_sources",
+      purpose: "People Also Ask questions, answers, and source sites, with target source presence flags.",
+      keyColumns: ["id", "run_id", "keyword_id", "location_id", "question", "answer", "source_title", "source_site", "target_present"]
+    });
+  }
+  if (hasCompetitors) {
+    tables.push({
+      name: "rank_tracker_competitor_snapshots",
+      purpose: "Per-run competitor visibility summaries across organic, Maps, AI Overview, and PAA surfaces.",
+      keyColumns: ["id", "run_id", "target_id", "surface", "best_position", "presence_count", "share_of_surface"]
+    });
+  }
+  if (includeDashboard) {
+    tables.push({
+      name: "rank_tracker_daily_metrics",
+      purpose: "Rollup table for dashboard charts, trend lines, and share-of-visibility summaries.",
+      keyColumns: ["id", "project_id", "metric_date", "keyword_id", "location_id", "surface", "metric_name", "metric_value"]
+    });
+  }
+  if (includeAlerts) {
+    tables.push({
+      name: "rank_tracker_alert_events",
+      purpose: "Deduplicated gain/loss events for rank movement, Maps top 3, AI Overview citations, and PAA source presence.",
+      keyColumns: ["id", "project_id", "run_id", "surface", "severity", "event_key", "message", "created_at", "acknowledged_at"]
+    });
+  }
+  return tables;
+}
+function buildCronJobs(modes, includeDashboard, includeAlerts) {
+  const jobs = [
+    {
+      name: "rank-tracker-dispatch",
+      purpose: "Find due keyword/location/mode combinations, create a rank_tracker_runs row, and enqueue idempotent work items.",
+      modes,
+      recommendedTools: ["credits_info"]
+    }
+  ];
+  if (includes(modes, "maps")) {
+    jobs.push({
+      name: "maps-rank-check",
+      purpose: "Run maps_search per keyword/location and optionally directory_workflow for market seed refreshes.",
+      modes: ["maps"],
+      recommendedTools: ["maps_search", "directory_workflow", "maps_place_intel"]
+    });
+  }
+  if (includes(modes, "organic") || includes(modes, "ai_overview")) {
+    jobs.push({
+      name: "serp-rank-check",
+      purpose: "Run search_serp per keyword/location/device and persist organic ranks, local pack, and AI Overview status.",
+      modes: modes.filter((mode) => mode === "organic" || mode === "ai_overview"),
+      recommendedTools: ["search_serp"]
+    });
+  }
+  if (includes(modes, "paa") || includes(modes, "ai_overview")) {
+    jobs.push({
+      name: "paa-ai-evidence-check",
+      purpose: "Run harvest_paa for PAA source presence and deeper AI Overview/PAA evidence where needed.",
+      modes: modes.filter((mode) => mode === "paa" || mode === "ai_overview"),
+      recommendedTools: ["harvest_paa"]
+    });
+  }
+  if (includeDashboard) {
+    jobs.push({
+      name: "rank-tracker-rollups",
+      purpose: "Aggregate raw rows into daily metrics for charts, comparison tables, and trend lines.",
+      modes,
+      recommendedTools: []
+    });
+  }
+  if (includeAlerts) {
+    jobs.push({
+      name: "rank-tracker-alerts",
+      purpose: "Compare latest run against prior snapshots and emit deduplicated visibility gain/loss events.",
+      modes,
+      recommendedTools: []
+    });
+  }
+  return jobs;
+}
+function buildMetrics(modes, includeDashboard, includeAlerts) {
+  const metrics = ["run_success_rate", "last_successful_run_at", "stale_keyword_location_count"];
+  if (includes(modes, "maps")) {
+    metrics.push("maps_best_position", "maps_top_3_presence", "maps_target_found", "maps_competitor_count_above_target");
+  }
+  if (includes(modes, "organic")) {
+    metrics.push("organic_best_position", "organic_top_3_presence", "organic_top_10_presence", "organic_best_url");
+  }
+  if (includes(modes, "ai_overview")) {
+    metrics.push("ai_overview_detected", "target_ai_overview_cited", "ai_overview_citation_domain_count");
+  }
+  if (includes(modes, "paa")) {
+    metrics.push("paa_question_count", "target_paa_source_count", "paa_presence_rate", "paa_source_domains");
+  }
+  if (includeDashboard) metrics.push("share_of_visibility", "position_delta_7d", "position_delta_30d");
+  if (includeAlerts) metrics.push("visibility_gain_events", "visibility_loss_events");
+  return metrics;
+}
+function listOrPlaceholder(values, fallback) {
+  const clean = values?.map((value) => value.trim()).filter(Boolean) ?? [];
+  if (!clean.length) return fallback;
+  return clean.map((value) => `- ${value}`).join("\n");
+}
+function buildPrompt(input, modes, tools, tables, jobs, metrics, expression, targetDomain, targetBusinessName) {
+  const keywords = listOrPlaceholder(input.keywords, "- TODO: add tracked keywords");
+  const locations = listOrPlaceholder(input.locations, "- TODO: add tracked markets/locations");
+  const competitors = listOrPlaceholder(input.competitors, "- Optional: add competitor domains or GBP names");
+  const notes = input.notes?.trim() || "No extra implementation notes.";
+  return [
+    "You are building a production rank tracker powered by MCP Scraper. Create the database migrations, scheduled worker, ingestion functions, and dashboard/query layer described below.",
+    "",
+    `Project: ${input.projectName || "MCP Scraper Rank Tracker"}`,
+    `Target domain: ${targetDomain || "TODO_TARGET_DOMAIN"}`,
+    `Target business/GBP name: ${targetBusinessName || "TODO_TARGET_BUSINESS_NAME"}`,
+    `Database target: ${input.database || "postgres"}`,
+    `Tracking modes: ${modes.join(", ")}`,
+    "",
+    "Seed keywords:",
+    keywords,
+    "",
+    "Seed locations:",
+    locations,
+    "",
+    "Competitors:",
+    competitors,
+    "",
+    "MCP Scraper calls to use:",
+    tools.map((tool) => `- ${tool.tool}: ${tool.purpose}`).join("\n"),
+    "",
+    "Database tables to create:",
+    tables.map((table) => `- ${table.name}: ${table.keyColumns.join(", ")}`).join("\n"),
+    "",
+    "Scheduler and heartbeat requirements:",
+    `- Use cron expression "${expression}" in timezone "${input.timezone || "UTC"}" unless the user changes cadence.`,
+    "- Every scheduled batch must insert or update rank_tracker_runs before calling MCP tools.",
+    "- Use idempotency_key = project_id + keyword_id + location_id + mode + device + scheduled_date.",
+    "- Mark runs as running, succeeded, failed, or skipped; persist error_message on failures.",
+    "- Run MCP calls sequentially by default because accounts have one concurrency slot unless the user bought more.",
+    "- Retry retryable upstream failures with backoff, but do not duplicate rows for the same idempotency key.",
+    "",
+    "Mode-specific ingestion rules:",
+    "- maps: Use directory_workflow to seed/refresh market coverage and maps_search for recurring keyword/location rank checks. Match the target by targetBusinessName, website domain, CID, and place URL when available.",
+    "- organic: Use search_serp and persist every organic result row. Compute the best targetDomain position and best ranking URL per keyword/location/device.",
+    "- ai_overview: Use search_serp for quick detection and harvest_paa when deeper text/source evidence is needed. Track detected, overview_text, cited domains, and whether targetDomain is cited.",
+    "- paa: Use harvest_paa and persist each question/source pair. Track whether sourceSite or answer/source evidence matches targetDomain, then compute PAA presence rate.",
+    "",
+    "Metrics to expose:",
+    metrics.map((metric) => `- ${metric}`).join("\n"),
+    "",
+    "Alert requirements:",
+    input.includeAlerts ? "- Emit deduplicated alert_events when target gains/loses Maps top 3, organic top 10, AI Overview citation, or PAA source presence." : "- Alerts are out of scope for this build unless the user asks for them.",
+    "",
+    "Dashboard requirements:",
+    input.includeDashboard ? "- Build views for latest position by keyword/location, trend deltas, competitors above target, AI Overview citations, and PAA source wins/losses." : "- Dashboard is out of scope for this build unless the user asks for it.",
+    "",
+    "Extra notes:",
+    notes
+  ].join("\n");
+}
+function buildRankTrackerBlueprint(input) {
+  const trackingModes = uniqueModes(input.trackingModes);
+  const targetDomain = normalizeDomain(input.targetDomain);
+  const targetBusinessName = input.targetBusinessName?.trim() || null;
+  const projectName = input.projectName?.trim() || "MCP Scraper Rank Tracker";
+  const database = input.database || "postgres";
+  const expression = cronExpression(input.scheduleCadence || "weekly", input.customCron);
+  const tools = buildToolPlan(trackingModes);
+  const tables = buildTables(trackingModes, input.includeDashboard !== false, input.includeAlerts !== false, Boolean(input.competitors?.length));
+  const jobs = input.includeCron === false ? [] : buildCronJobs(trackingModes, input.includeDashboard !== false, input.includeAlerts !== false);
+  const metrics = buildMetrics(trackingModes, input.includeDashboard !== false, input.includeAlerts !== false);
+  const implementationPrompt = buildPrompt(input, trackingModes, tools, tables, jobs, metrics, expression, targetDomain, targetBusinessName);
+  const blueprint = {
+    projectName,
+    targetDomain,
+    targetBusinessName,
+    trackingModes,
+    database,
+    recommendedTools: tools,
+    tables,
+    cron: {
+      enabled: input.includeCron !== false,
+      cadence: input.scheduleCadence || "weekly",
+      expression: input.includeCron === false ? "disabled" : expression,
+      timezone: input.timezone || "UTC",
+      jobs
+    },
+    metrics,
+    implementationPrompt
+  };
+  const text = [
+    `# ${projectName}`,
+    "",
+    "Rank tracker build blueprint generated from MCP Scraper tool capabilities.",
+    "",
+    "## Modes",
+    trackingModes.map((mode) => `- ${mode}`).join("\n"),
+    "",
+    "## Recommended MCP Tools",
+    tools.map((tool) => `- \`${tool.tool}\` - ${tool.purpose}`).join("\n"),
+    "",
+    "## Database Tables",
+    tables.map((table) => `- \`${table.name}\` - ${table.purpose}`).join("\n"),
+    "",
+    "## Cron / Heartbeat",
+    blueprint.cron.enabled ? `- Cadence: ${blueprint.cron.cadence}
+- Cron: \`${blueprint.cron.expression}\`
+- Timezone: ${blueprint.cron.timezone}
+- Jobs: ${jobs.map((job) => job.name).join(", ")}` : "- Disabled by input. Still create rank_tracker_runs for manual runs.",
+    "",
+    "## Implementation Prompt",
+    "```text",
+    implementationPrompt,
+    "```"
+  ].join("\n");
+  return {
+    content: [{ type: "text", text }],
+    structuredContent: blueprint
+  };
+}
+
 // src/mcp/paa-mcp-server.ts
 function liveWebToolAnnotations(title) {
   return {
@@ -1465,6 +1839,15 @@ function liveWebToolAnnotations(title) {
     openWorldHint: true
   };
 }
+function localPlanningToolAnnotations(title) {
+  return {
+    title,
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+  };
+}
 function listSavedReports() {
   try {
     const dir = outputBaseDir();
@@ -1598,6 +1981,13 @@ function registerPaaExtractorMcpTools(server2, executor2, options = {}) {
     outputSchema: DirectoryWorkflowOutputSchema,
     annotations: liveWebToolAnnotations("Directory Workflow: Markets + Maps")
   }, async (input) => formatDirectoryWorkflow(await executor2.directoryWorkflow(input), input));
+  server2.registerTool("rank_tracker_blueprint", {
+    title: "Rank Tracker Blueprint Builder",
+    description: "Generate a build-ready database, cron/heartbeat, ingestion, metrics, and AI implementation prompt for a rank tracker powered by MCP Scraper. Supports Maps rankings through directory_workflow/maps_search, organic rankings through search_serp, AI Overview citation tracking, and People Also Ask source presence tracking. This tool is local planning only; it does not call the web or spend credits.",
+    inputSchema: RankTrackerBlueprintInputSchema,
+    outputSchema: RankTrackerBlueprintOutputSchema,
+    annotations: localPlanningToolAnnotations("Rank Tracker Blueprint Builder")
+  }, async (input) => buildRankTrackerBlueprint(input));
   server2.registerTool("credits_info", {
     title: "MCP Scraper Credits & Costs",
     description: "Answer questions about MCP Scraper credits: current credit balance, what a specific tool/action costs, the full cost table, and optionally recent credit ledger entries. Does not expose payment methods or credit card information.",