thorbit-content-mcp 0.1.0 → 0.1.2

package/README.md

@@ -58,11 +58,13 @@ npx -y -p thorbit-content-mcp@latest thorbit-content-mcp-install --key-path ~/.c
 ## Tools
 
 - `thorbit_content_extract_url`: extract a URL through MCP Scraper.
-- `thorbit_content_harvest_serp`: harvest SERP/PAA evidence through MCP Scraper.
-- `thorbit_content_reddit_research`: discover Reddit candidates with MCP Scraper SERP and read posts through MCP Scraper browser-agent by default.
+- `thorbit_content_harvest_serp`: harvest SERP/PAA evidence through MCP Scraper. Returns PAA flat questions, PAA tree, organic SERP, local pack, videos/shorts, forums, whatPeopleSaying, AI Overview text/citations/sections, AI Mode, entity IDs, stats, diagnostics, retry attempts, and the raw MCP Scraper result. Supports MCP Scraper `proxyMode`, `proxyZip`, `device`, `pages`, and `debug` controls.
+- `thorbit_content_reddit_research`: discover Reddit candidates with MCP Scraper SERP and read posts through MCP Scraper browser-agent by default. Supports the same SERP proxy controls for discovery.
 - `thorbit_onpage_start_analysis`: start durable Thorbit on-page analysis for a project keyword or inline content.
 - `thorbit_onpage_get_analysis`: read persisted analysis status, score, signal counts, and summary.
 
+For US city/state SERP or Reddit discovery, keep `proxyMode` at the default `location` and pass `location` plus `proxyZip` when a city-center ZIP is known. MCP Scraper owns retryable CAPTCHA, proxy tunnel, proxy availability, and location-mismatch retries with fresh residential proxy/browser attempts. Set `debug: true` when you need sanitized attempt telemetry in the Thorbit response.
+
 ## Resources
 
 - `thorbit-content://analyses/{analysisPublicId}`: JSON status and summary for one persisted on-page analysis.

package/dist/bin/thorbit-content-mcp-install.cjs

@@ -305,7 +305,7 @@ function renderInstallInstructions(options) {
     "",
     paint("Tools", ansi.terracotta, color),
     "  thorbit_content_extract_url       Extract a URL through MCP Scraper.",
-    "  thorbit_content_harvest_serp      Harvest SERP/PAA evidence through MCP Scraper.",
+    "  thorbit_content_harvest_serp      Harvest full SERP/PAA evidence through MCP Scraper.",
     "  thorbit_content_reddit_research   Read Reddit through MCP Scraper browser-agent.",
     "  thorbit_onpage_start_analysis     Start durable Thorbit on-page analysis.",
     "  thorbit_onpage_get_analysis       Read analysis status and summary.",

package/dist/bin/thorbit-content-mcp-install.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../bin/thorbit-content-mcp-install.ts"],"sourcesContent":["import { realpathSync } from 'node:fs'\nimport { fileURLToPath } from 'node:url'\n\nexport type InstallOptions = {\n  apiKey: string\n  baseUrl?: string\n  keyPath?: string\n  serverName: string\n  json: boolean\n  color: boolean\n  help: boolean\n}\n\nexport function readArg(name: string, argv = process.argv.slice(2)): string | undefined {\n  const prefix = `--${name}=`\n  const inline = argv.find(arg => arg.startsWith(prefix))\n  if (inline) return inline.slice(prefix.length)\n  const index = argv.indexOf(`--${name}`)\n  return index >= 0 ? argv[index + 1] : undefined\n}\n\nexport function hasFlag(name: string, argv = process.argv.slice(2)): boolean {\n  return argv.includes(`--${name}`)\n}\n\nexport function resolveInstallOptions(argv = process.argv.slice(2)): InstallOptions {\n  return {\n    apiKey: readArg('api-key', argv) ?? process.env.THORBIT_API_KEY ?? process.env.THORBIT_MCP_API_KEY ?? 'thbt_mcp_...',\n    baseUrl: readArg('base-url', argv) ?? process.env.THORBIT_BASE_URL,\n    keyPath: readArg('key-path', argv) ?? process.env.THORBIT_CONTENT_MCP_KEY_PATH,\n    serverName: readArg('server-name', argv) ?? 'thorbit-content',\n    json: hasFlag('json', argv),\n    color: !hasFlag('no-color', argv),\n    help: hasFlag('help', argv) || hasFlag('h', argv),\n  }\n}\n\nexport function buildMcpConfig(options: InstallOptions) {\n  const env: Record<string, string> = options.keyPath\n    ? { THORBIT_CONTENT_MCP_KEY_PATH: options.keyPath }\n    : { THORBIT_API_KEY: options.apiKey }\n\n  if (options.baseUrl) {\n    env.THORBIT_BASE_URL = options.baseUrl.replace(/\\/$/, '')\n  }\n\n  return {\n    mcpServers: {\n      [options.serverName]: {\n        command: 'npx',\n        args: ['-y', 'thorbit-content-mcp@latest'],\n        env,\n      },\n    },\n  }\n}\n\nconst ansi = {\n  reset: '\\u001b[0m',\n  bold: '\\u001b[1m',\n  dim: '\\u001b[2m',\n  terracotta: '\\u001b[38;2;198;90;54m',\n  cardBg: '\\u001b[48;2;31;31;31m',\n  cardBorder: '\\u001b[38;2;108;66;50m',\n  clay: '\\u001b[38;2;226;138;92m',\n  cream: '\\u001b[38;2;255;244;230m',\n  green: '\\u001b[38;2;75;181;67m',\n  shadow: '\\u001b[38;2;116;70;56m',\n  slate: '\\u001b[38;2;174;181;195m',\n  wire: '\\u001b[38;2;198;90;54m',\n}\n\nfunction paint(value: string, code: string, enabled: boolean): string {\n  return enabled ? `${code}${value}${ansi.reset}` : value\n}\n\nexport function renderHelp(color: boolean): string {\n  return [\n    renderBanner(color),\n    '',\n    'Usage:',\n    '  npx -y -p thorbit-content-mcp@latest thorbit-content-mcp-install [options]',\n    '',\n    'Options:',\n    '  --api-key <key>        Thorbit MCP API key from Settings -> MCPs.',\n    '  --key-path <path>      File containing the API key. Preferred for shared machines and servers.',\n    '  --base-url <url>       Thorbit app URL. Defaults to https://thorbit.ai.',\n    '  --server-name <name>   MCP client server name. Defaults to thorbit-content.',\n    '  --json                 Print only MCP client JSON.',\n    '  --no-color             Disable ANSI color.',\n    '  --help                 Show this help.',\n    '',\n  ].join('\\n')\n}\n\nexport function renderBanner(color: boolean): string {\n  return color ? renderReferenceCardBanner() : renderAsciiBanner()\n}\n\nconst cardWidth = 104\n\ntype CardTone = 'title' | 'mark' | 'wire' | 'caption' | 'blank'\ntype CardPart = {\n  color: string\n  text: string\n}\n\nconst thorbitPixelLetters: Record<string, string[]> = {\n  T: [\n    '1111111',\n    '0011000',\n    '0011000',\n    '0011000',\n    '0011000',\n    '0011000',\n    '0011000',\n  ],\n  H: [\n    '110011',\n    '110011',\n    '110011',\n    '111111',\n    '110011',\n    '110011',\n    '110011',\n  ],\n  O: [\n    '011110',\n    '110011',\n    '110011',\n    '110011',\n    '110011',\n    '110011',\n    '011110',\n  ],\n  R: [\n    '111110',\n    '110011',\n    '110011',\n    '111110',\n    '110110',\n    '110011',\n    '110011',\n  ],\n  B: [\n    '111110',\n    '110011',\n    '110011',\n    '111110',\n    '110011',\n    '110011',\n    '111110',\n  ],\n  I: [\n    '1111',\n    '0110',\n    '0110',\n    '0110',\n    '0110',\n    '0110',\n    '1111',\n  ],\n}\n\nfunction renderReferenceCardBanner(): string {\n  const heading = justifyCardContent('  Plain text', '⧉', cardWidth)\n\n  return [\n    `${ansi.cardBorder}╭${'─'.repeat(cardWidth + 2)}╮${ansi.reset}`,\n    renderCardLine(heading, 'title'),\n    renderCardLine('', 'blank'),\n    ...renderLayeredPixelWordmarkCardLines('THORBIT'),\n    renderCardLine('', 'blank'),\n    renderCardLine('  THORBIT CONTENT MCP', 'caption'),\n    `${ansi.cardBorder}╰${'─'.repeat(cardWidth + 2)}╯${ansi.reset}`,\n  ].join('\\n')\n}\n\nfunction renderAsciiBanner(): string {\n  const contentWidth = 96\n  const border = `+${'-'.repeat(contentWidth + 2)}+`\n  const cardLine = (content = '') => `| ${content.padEnd(contentWidth)} |`\n  const title = 'Plain text'\n  const copy = '[copy]'\n  const lines = [\n    border,\n    cardLine(`${title}${' '.repeat(contentWidth - title.length - copy.length)}${copy}`),\n    cardLine(),\n    ...renderAsciiWordmark('THORBIT').map(line => cardLine(`  ${line}`)),\n    cardLine(),\n    cardLine('  THORBIT CONTENT MCP'),\n    border,\n  ]\n\n  return lines.join('\\n')\n}\n\nfunction renderCardLine(content: string, tone: CardTone): string {\n  const foreground = {\n    title: ansi.cream,\n    mark: ansi.clay,\n    wire: ansi.wire,\n    caption: ansi.terracotta,\n    blank: ansi.slate,\n  }[tone]\n  return renderCardLineParts([{ color: foreground, text: content }])\n}\n\nfunction renderCardLineParts(parts: CardPart[]): string {\n  const visibleWidth = parts.reduce((width, part) => width + part.text.length, 0)\n  const padding = ' '.repeat(Math.max(0, cardWidth - visibleWidth))\n  return [\n    `${ansi.cardBorder}│${ansi.reset}`,\n    ansi.cardBg,\n    ' ',\n    ...parts.map(part => `${part.color}${part.text}`),\n    padding,\n    ' ',\n    ansi.reset,\n    `${ansi.cardBorder}│${ansi.reset}`,\n  ].join('')\n}\n\nfunction justifyCardContent(left: string, right: string, width: number): string {\n  return `${left}${' '.repeat(Math.max(1, width - left.length - right.length))}${right}`\n}\n\nfunction buildPixelWordmarkMatrix(word: string): boolean[][] {\n  const rows: boolean[][] = Array.from({ length: 7 }, () => [])\n  for (let rowIndex = 0; rowIndex < 7; rowIndex += 1) {\n    word.split('').forEach((letter, letterIndex) => {\n      const pattern = thorbitPixelLetters[letter]\n      if (!pattern) return\n      if (letterIndex > 0) rows[rowIndex].push(false)\n      rows[rowIndex].push(...pattern[rowIndex].split('').map(cell => cell === '1'))\n    })\n  }\n  return rows\n}\n\nfunction renderLayeredPixelWordmarkCardLines(word: string): string[] {\n  const matrix = buildPixelWordmarkMatrix(word)\n  const wordmarkWidth = Math.max(...matrix.map(row => row.length))\n  const shadowOffsetX = 1\n  const shadowOffsetY = -1\n  const outputRows = matrix.length + Math.abs(Math.min(0, shadowOffsetY))\n  const outputWidth = wordmarkWidth + shadowOffsetX\n\n  return Array.from({ length: outputRows }, (_, outputRowIndex) => {\n    const rowParts: CardPart[] = [{ color: ansi.slate, text: '    ' }]\n\n    for (let columnIndex = 0; columnIndex < outputWidth; columnIndex += 1) {\n      const foregroundRow = outputRowIndex - Math.abs(Math.min(0, shadowOffsetY))\n      const hasForeground = foregroundRow >= 0 && Boolean(matrix[foregroundRow]?.[columnIndex])\n      const shadowSourceRow = outputRowIndex - shadowOffsetY - Math.abs(Math.min(0, shadowOffsetY))\n      const shadowSourceColumn = columnIndex - shadowOffsetX\n      const hasShadow = shadowSourceRow >= 0 && shadowSourceColumn >= 0\n        && Boolean(matrix[shadowSourceRow]?.[shadowSourceColumn])\n\n      if (hasForeground) {\n        appendCardPart(rowParts, ansi.clay, '██')\n      } else if (hasShadow) {\n        appendCardPart(rowParts, ansi.shadow, '░░')\n      } else {\n        appendCardPart(rowParts, ansi.slate, '  ')\n      }\n    }\n\n    return renderCardLineParts(rowParts)\n  })\n}\n\nfunction appendCardPart(parts: CardPart[], color: string, text: string): void {\n  const previous = parts[parts.length - 1]\n  if (previous?.color === color) {\n    previous.text += text\n    return\n  }\n  parts.push({ color, text })\n}\n\nfunction renderAsciiWordmark(word: string): string[] {\n  const matrix = buildPixelWordmarkMatrix(word)\n  const rows: string[] = []\n  for (const matrixRow of matrix) {\n    rows.push(matrixRow.map(cell => (cell ? '#' : ' ')).join(''))\n  }\n  return rows\n}\n\nexport function renderInstallInstructions(options: InstallOptions): string {\n  const color = options.color\n  const json = JSON.stringify(buildMcpConfig(options), null, 2)\n  const keySetup = options.keyPath\n    ? [\n        paint('Key file mode', ansi.terracotta, color),\n        `  chmod 600 ${options.keyPath}`,\n      ].join('\\n')\n    : [\n        paint('Safer key-file option', ansi.terracotta, color),\n        '  mkdir -p ~/.config/thorbit',\n        \"  printf '%s\\\\n' 'thbt_mcp_...' > ~/.config/thorbit/content-mcp-key\",\n        '  chmod 600 ~/.config/thorbit/content-mcp-key',\n        '',\n        '  Then run:',\n        '  npx -y -p thorbit-content-mcp@latest thorbit-content-mcp-install --key-path ~/.config/thorbit/content-mcp-key',\n      ].join('\\n')\n\n  return [\n    renderBanner(color),\n    paint('MCP Scraper research and on-page analysis for MCP agents.', ansi.slate, color),\n    '',\n    `${paint('1.', ansi.terracotta, color)} Generate an API key in Thorbit Settings -> MCPs with content/onpage scopes.`,\n    `${paint('2.', ansi.terracotta, color)} Add this server config to your MCP client:`,\n    '',\n    json,\n    '',\n    `${paint('3.', ansi.terracotta, color)} Restart your MCP client, then call ${paint('thorbit_content_harvest_serp', ansi.green, color)} or ${paint('thorbit_content_reddit_research', ansi.green, color)}.`,\n    '',\n    keySetup,\n    '',\n    paint('Tools', ansi.terracotta, color),\n    '  thorbit_content_extract_url       Extract a URL through MCP Scraper.',\n    '  thorbit_content_harvest_serp      Harvest SERP/PAA evidence through MCP Scraper.',\n    '  thorbit_content_reddit_research   Read Reddit through MCP Scraper browser-agent.',\n    '  thorbit_onpage_start_analysis     Start durable Thorbit on-page analysis.',\n    '  thorbit_onpage_get_analysis       Read analysis status and summary.',\n    '',\n    paint('Raw JSON:', ansi.slate, color),\n    '  npx -y -p thorbit-content-mcp@latest thorbit-content-mcp-install --json --api-key thbt_mcp_...',\n    '',\n  ].join('\\n')\n}\n\nexport function main(): void {\n  const options = resolveInstallOptions()\n  if (options.help) {\n    process.stdout.write(renderHelp(options.color))\n    return\n  }\n\n  if (options.json) {\n    process.stdout.write(`${JSON.stringify(buildMcpConfig(options), null, 2)}\\n`)\n    return\n  }\n\n  process.stdout.write(renderInstallInstructions(options))\n}\n\nfunction isMainModule(): boolean {\n  const entry = process.argv[1]\n  if (!entry) return false\n  try {\n    return realpathSync(entry) === realpathSync(fileURLToPath(import.meta.url))\n  } catch {\n    return false\n  }\n}\n\nif (isMainModule()) main()\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA6B;AAC7B,sBAA8B;AAD9B;AAaO,SAAS,QAAQ,MAAc,OAAO,QAAQ,KAAK,MAAM,CAAC,GAAuB;AACtF,QAAM,SAAS,KAAK,IAAI;AACxB,QAAM,SAAS,KAAK,KAAK,SAAO,IAAI,WAAW,MAAM,CAAC;AACtD,MAAI,OAAQ,QAAO,OAAO,MAAM,OAAO,MAAM;AAC7C,QAAM,QAAQ,KAAK,QAAQ,KAAK,IAAI,EAAE;AACtC,SAAO,SAAS,IAAI,KAAK,QAAQ,CAAC,IAAI;AACxC;AAEO,SAAS,QAAQ,MAAc,OAAO,QAAQ,KAAK,MAAM,CAAC,GAAY;AAC3E,SAAO,KAAK,SAAS,KAAK,IAAI,EAAE;AAClC;AAEO,SAAS,sBAAsB,OAAO,QAAQ,KAAK,MAAM,CAAC,GAAmB;AAClF,SAAO;AAAA,IACL,QAAQ,QAAQ,WAAW,IAAI,KAAK,QAAQ,IAAI,mBAAmB,QAAQ,IAAI,uBAAuB;AAAA,IACtG,SAAS,QAAQ,YAAY,IAAI,KAAK,QAAQ,IAAI;AAAA,IAClD,SAAS,QAAQ,YAAY,IAAI,KAAK,QAAQ,IAAI;AAAA,IAClD,YAAY,QAAQ,eAAe,IAAI,KAAK;AAAA,IAC5C,MAAM,QAAQ,QAAQ,IAAI;AAAA,IAC1B,OAAO,CAAC,QAAQ,YAAY,IAAI;AAAA,IAChC,MAAM,QAAQ,QAAQ,IAAI,KAAK,QAAQ,KAAK,IAAI;AAAA,EAClD;AACF;AAEO,SAAS,eAAe,SAAyB;AACtD,QAAM,MAA8B,QAAQ,UACxC,EAAE,8BAA8B,QAAQ,QAAQ,IAChD,EAAE,iBAAiB,QAAQ,OAAO;AAEtC,MAAI,QAAQ,SAAS;AACnB,QAAI,mBAAmB,QAAQ,QAAQ,QAAQ,OAAO,EAAE;AAAA,EAC1D;AAEA,SAAO;AAAA,IACL,YAAY;AAAA,MACV,CAAC,QAAQ,UAAU,GAAG;AAAA,QACpB,SAAS;AAAA,QACT,MAAM,CAAC,MAAM,4BAA4B;AAAA,QACzC;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAM,OAAO;AAAA,EACX,OAAO;AAAA,EACP,MAAM;AAAA,EACN,KAAK;AAAA,EACL,YAAY;AAAA,EACZ,QAAQ;AAAA,EACR,YAAY;AAAA,EACZ,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,MAAM;AACR;AAEA,SAAS,MAAM,OAAe,MAAc,SAA0B;AACpE,SAAO,UAAU,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,KAAK,KAAK;AACpD;AAEO,SAAS,WAAW,OAAwB;AACjD,SAAO;AAAA,IACL,aAAa,KAAK;AAAA,IAClB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAEO,SAAS,aAAa,OAAwB;AACnD,SAAO,QAAQ,0BAA0B,IAAI,kBAAkB;AACjE;AAEA,IAAM,YAAY;AAQlB,IAAM,sBAAgD;AAAA,EACpD,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEA,SAAS,4BAAoC;AAC3C,QAAM,UAAU,mBAAmB,gBAAgB,UAAK,SAAS;AAEjE,SAAO;AAAA,IACL,GAAG,KAAK,UAAU,SAAI,SAAI,OAAO,YAAY,CAAC,CAAC,SAAI,KAAK,KAAK;AAAA,IAC7D,eAAe,SAAS,OAAO;AAAA,IAC/B,eAAe,IAAI,OAAO;AAAA,IAC1B,GAAG,oCAAoC,SAAS;AAAA,IAChD,eAAe,IAAI,OAAO;AAAA,IAC1B,eAAe,yBAAyB,SAAS;AAAA,IACjD,GAAG,KAAK,UAAU,SAAI,SAAI,OAAO,YAAY,CAAC,CAAC,SAAI,KAAK,KAAK;AAAA,EAC/D,EAAE,KAAK,IAAI;AACb;AAEA,SAAS,oBAA4B;AACnC,QAAM,eAAe;AACrB,QAAM,SAAS,IAAI,IAAI,OAAO,eAAe,CAAC,CAAC;AAC/C,QAAM,WAAW,CAAC,UAAU,OAAO,KAAK,QAAQ,OAAO,YAAY,CAAC;AACpE,QAAM,QAAQ;AACd,QAAM,OAAO;AACb,QAAM,QAAQ;AAAA,IACZ;AAAA,IACA,SAAS,GAAG,KAAK,GAAG,IAAI,OAAO,eAAe,MAAM,SAAS,KAAK,MAAM,CAAC,GAAG,IAAI,EAAE;AAAA,IAClF,SAAS;AAAA,IACT,GAAG,oBAAoB,SAAS,EAAE,IAAI,UAAQ,SAAS,KAAK,IAAI,EAAE,CAAC;AAAA,IACnE,SAAS;AAAA,IACT,SAAS,uBAAuB;AAAA,IAChC;AAAA,EACF;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;AAEA,SAAS,eAAe,SAAiB,MAAwB;AAC/D,QAAM,aAAa;AAAA,IACjB,OAAO,KAAK;AAAA,IACZ,MAAM,KAAK;AAAA,IACX,MAAM,KAAK;AAAA,IACX,SAAS,KAAK;AAAA,IACd,OAAO,KAAK;AAAA,EACd,EAAE,IAAI;AACN,SAAO,oBAAoB,CAAC,EAAE,OAAO,YAAY,MAAM,QAAQ,CAAC,CAAC;AACnE;AAEA,SAAS,oBAAoB,OAA2B;AACtD,QAAM,eAAe,MAAM,OAAO,CAAC,OAAO,SAAS,QAAQ,KAAK,KAAK,QAAQ,CAAC;AAC9E,QAAM,UAAU,IAAI,OAAO,KAAK,IAAI,GAAG,YAAY,YAAY,CAAC;AAChE,SAAO;AAAA,IACL,GAAG,KAAK,UAAU,SAAI,KAAK,KAAK;AAAA,IAChC,KAAK;AAAA,IACL;AAAA,IACA,GAAG,MAAM,IAAI,UAAQ,GAAG,KAAK,KAAK,GAAG,KAAK,IAAI,EAAE;AAAA,IAChD;AAAA,IACA;AAAA,IACA,KAAK;AAAA,IACL,GAAG,KAAK,UAAU,SAAI,KAAK,KAAK;AAAA,EAClC,EAAE,KAAK,EAAE;AACX;AAEA,SAAS,mBAAmB,MAAc,OAAe,OAAuB;AAC9E,SAAO,GAAG,IAAI,GAAG,IAAI,OAAO,KAAK,IAAI,GAAG,QAAQ,KAAK,SAAS,MAAM,MAAM,CAAC,CAAC,GAAG,KAAK;AACtF;AAEA,SAAS,yBAAyB,MAA2B;AAC3D,QAAM,OAAoB,MAAM,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,CAAC;AAC5D,WAAS,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG;AAClD,SAAK,MAAM,EAAE,EAAE,QAAQ,CAAC,QAAQ,gBAAgB;AAC9C,YAAM,UAAU,oBAAoB,MAAM;AAC1C,UAAI,CAAC,QAAS;AACd,UAAI,cAAc,EAAG,MAAK,QAAQ,EAAE,KAAK,KAAK;AAC9C,WAAK,QAAQ,EAAE,KAAK,GAAG,QAAQ,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,UAAQ,SAAS,GAAG,CAAC;AAAA,IAC9E,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAEA,SAAS,oCAAoC,MAAwB;AACnE,QAAM,SAAS,yBAAyB,IAAI;AAC5C,QAAM,gBAAgB,KAAK,IAAI,GAAG,OAAO,IAAI,SAAO,IAAI,MAAM,CAAC;AAC/D,QAAM,gBAAgB;AACtB,QAAM,gBAAgB;AACtB,QAAM,aAAa,OAAO,SAAS,KAAK,IAAI,KAAK,IAAI,GAAG,aAAa,CAAC;AACtE,QAAM,cAAc,gBAAgB;AAEpC,SAAO,MAAM,KAAK,EAAE,QAAQ,WAAW,GAAG,CAAC,GAAG,mBAAmB;AAC/D,UAAM,WAAuB,CAAC,EAAE,OAAO,KAAK,OAAO,MAAM,OAAO,CAAC;AAEjE,aAAS,cAAc,GAAG,cAAc,aAAa,eAAe,GAAG;AACrE,YAAM,gBAAgB,iBAAiB,KAAK,IAAI,KAAK,IAAI,GAAG,aAAa,CAAC;AAC1E,YAAM,gBAAgB,iBAAiB,KAAK,QAAQ,OAAO,aAAa,IAAI,WAAW,CAAC;AACxF,YAAM,kBAAkB,iBAAiB,gBAAgB,KAAK,IAAI,KAAK,IAAI,GAAG,aAAa,CAAC;AAC5F,YAAM,qBAAqB,cAAc;AACzC,YAAM,YAAY,mBAAmB,KAAK,sBAAsB,KAC3D,QAAQ,OAAO,eAAe,IAAI,kBAAkB,CAAC;AAE1D,UAAI,eAAe;AACjB,uBAAe,UAAU,KAAK,MAAM,cAAI;AAAA,MAC1C,WAAW,WAAW;AACpB,uBAAe,UAAU,KAAK,QAAQ,cAAI;AAAA,MAC5C,OAAO;AACL,uBAAe,UAAU,KAAK,OAAO,IAAI;AAAA,MAC3C;AAAA,IACF;AAEA,WAAO,oBAAoB,QAAQ;AAAA,EACrC,CAAC;AACH;AAEA,SAAS,eAAe,OAAmB,OAAe,MAAoB;AAC5E,QAAM,WAAW,MAAM,MAAM,SAAS,CAAC;AACvC,MAAI,UAAU,UAAU,OAAO;AAC7B,aAAS,QAAQ;AACjB;AAAA,EACF;AACA,QAAM,KAAK,EAAE,OAAO,KAAK,CAAC;AAC5B;AAEA,SAAS,oBAAoB,MAAwB;AACnD,QAAM,SAAS,yBAAyB,IAAI;AAC5C,QAAM,OAAiB,CAAC;AACxB,aAAW,aAAa,QAAQ;AAC9B,SAAK,KAAK,UAAU,IAAI,UAAS,OAAO,MAAM,GAAI,EAAE,KAAK,EAAE,CAAC;AAAA,EAC9D;AACA,SAAO;AACT;AAEO,SAAS,0BAA0B,SAAiC;AACzE,QAAM,QAAQ,QAAQ;AACtB,QAAM,OAAO,KAAK,UAAU,eAAe,OAAO,GAAG,MAAM,CAAC;AAC5D,QAAM,WAAW,QAAQ,UACrB;AAAA,IACE,MAAM,iBAAiB,KAAK,YAAY,KAAK;AAAA,IAC7C,eAAe,QAAQ,OAAO;AAAA,EAChC,EAAE,KAAK,IAAI,IACX;AAAA,IACE,MAAM,yBAAyB,KAAK,YAAY,KAAK;AAAA,IACrD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AAEf,SAAO;AAAA,IACL,aAAa,KAAK;AAAA,IAClB,MAAM,6DAA6D,KAAK,OAAO,KAAK;AAAA,IACpF;AAAA,IACA,GAAG,MAAM,MAAM,KAAK,YAAY,KAAK,CAAC;AAAA,IACtC,GAAG,MAAM,MAAM,KAAK,YAAY,KAAK,CAAC;AAAA,IACtC;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAG,MAAM,MAAM,KAAK,YAAY,KAAK,CAAC,uCAAuC,MAAM,gCAAgC,KAAK,OAAO,KAAK,CAAC,OAAO,MAAM,mCAAmC,KAAK,OAAO,KAAK,CAAC;AAAA,IACvM;AAAA,IACA;AAAA,IACA;AAAA,IACA,MAAM,SAAS,KAAK,YAAY,KAAK;AAAA,IACrC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,MAAM,aAAa,KAAK,OAAO,KAAK;AAAA,IACpC;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAEO,SAAS,OAAa;AAC3B,QAAM,UAAU,sBAAsB;AACtC,MAAI,QAAQ,MAAM;AAChB,YAAQ,OAAO,MAAM,WAAW,QAAQ,KAAK,CAAC;AAC9C;AAAA,EACF;AAEA,MAAI,QAAQ,MAAM;AAChB,YAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,eAAe,OAAO,GAAG,MAAM,CAAC,CAAC;AAAA,CAAI;AAC5E;AAAA,EACF;AAEA,UAAQ,OAAO,MAAM,0BAA0B,OAAO,CAAC;AACzD;AAEA,SAAS,eAAwB;AAC/B,QAAM,QAAQ,QAAQ,KAAK,CAAC;AAC5B,MAAI,CAAC,MAAO,QAAO;AACnB,MAAI;AACF,eAAO,6BAAa,KAAK,UAAM,iCAAa,+BAAc,YAAY,GAAG,CAAC;AAAA,EAC5E,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,IAAI,aAAa,EAAG,MAAK;","names":[]}
+{"version":3,"sources":["../../bin/thorbit-content-mcp-install.ts"],"sourcesContent":["import { realpathSync } from 'node:fs'\nimport { fileURLToPath } from 'node:url'\n\nexport type InstallOptions = {\n  apiKey: string\n  baseUrl?: string\n  keyPath?: string\n  serverName: string\n  json: boolean\n  color: boolean\n  help: boolean\n}\n\nexport function readArg(name: string, argv = process.argv.slice(2)): string | undefined {\n  const prefix = `--${name}=`\n  const inline = argv.find(arg => arg.startsWith(prefix))\n  if (inline) return inline.slice(prefix.length)\n  const index = argv.indexOf(`--${name}`)\n  return index >= 0 ? argv[index + 1] : undefined\n}\n\nexport function hasFlag(name: string, argv = process.argv.slice(2)): boolean {\n  return argv.includes(`--${name}`)\n}\n\nexport function resolveInstallOptions(argv = process.argv.slice(2)): InstallOptions {\n  return {\n    apiKey: readArg('api-key', argv) ?? process.env.THORBIT_API_KEY ?? process.env.THORBIT_MCP_API_KEY ?? 'thbt_mcp_...',\n    baseUrl: readArg('base-url', argv) ?? process.env.THORBIT_BASE_URL,\n    keyPath: readArg('key-path', argv) ?? process.env.THORBIT_CONTENT_MCP_KEY_PATH,\n    serverName: readArg('server-name', argv) ?? 'thorbit-content',\n    json: hasFlag('json', argv),\n    color: !hasFlag('no-color', argv),\n    help: hasFlag('help', argv) || hasFlag('h', argv),\n  }\n}\n\nexport function buildMcpConfig(options: InstallOptions) {\n  const env: Record<string, string> = options.keyPath\n    ? { THORBIT_CONTENT_MCP_KEY_PATH: options.keyPath }\n    : { THORBIT_API_KEY: options.apiKey }\n\n  if (options.baseUrl) {\n    env.THORBIT_BASE_URL = options.baseUrl.replace(/\\/$/, '')\n  }\n\n  return {\n    mcpServers: {\n      [options.serverName]: {\n        command: 'npx',\n        args: ['-y', 'thorbit-content-mcp@latest'],\n        env,\n      },\n    },\n  }\n}\n\nconst ansi = {\n  reset: '\\u001b[0m',\n  bold: '\\u001b[1m',\n  dim: '\\u001b[2m',\n  terracotta: '\\u001b[38;2;198;90;54m',\n  cardBg: '\\u001b[48;2;31;31;31m',\n  cardBorder: '\\u001b[38;2;108;66;50m',\n  clay: '\\u001b[38;2;226;138;92m',\n  cream: '\\u001b[38;2;255;244;230m',\n  green: '\\u001b[38;2;75;181;67m',\n  shadow: '\\u001b[38;2;116;70;56m',\n  slate: '\\u001b[38;2;174;181;195m',\n  wire: '\\u001b[38;2;198;90;54m',\n}\n\nfunction paint(value: string, code: string, enabled: boolean): string {\n  return enabled ? `${code}${value}${ansi.reset}` : value\n}\n\nexport function renderHelp(color: boolean): string {\n  return [\n    renderBanner(color),\n    '',\n    'Usage:',\n    '  npx -y -p thorbit-content-mcp@latest thorbit-content-mcp-install [options]',\n    '',\n    'Options:',\n    '  --api-key <key>        Thorbit MCP API key from Settings -> MCPs.',\n    '  --key-path <path>      File containing the API key. Preferred for shared machines and servers.',\n    '  --base-url <url>       Thorbit app URL. Defaults to https://thorbit.ai.',\n    '  --server-name <name>   MCP client server name. Defaults to thorbit-content.',\n    '  --json                 Print only MCP client JSON.',\n    '  --no-color             Disable ANSI color.',\n    '  --help                 Show this help.',\n    '',\n  ].join('\\n')\n}\n\nexport function renderBanner(color: boolean): string {\n  return color ? renderReferenceCardBanner() : renderAsciiBanner()\n}\n\nconst cardWidth = 104\n\ntype CardTone = 'title' | 'mark' | 'wire' | 'caption' | 'blank'\ntype CardPart = {\n  color: string\n  text: string\n}\n\nconst thorbitPixelLetters: Record<string, string[]> = {\n  T: [\n    '1111111',\n    '0011000',\n    '0011000',\n    '0011000',\n    '0011000',\n    '0011000',\n    '0011000',\n  ],\n  H: [\n    '110011',\n    '110011',\n    '110011',\n    '111111',\n    '110011',\n    '110011',\n    '110011',\n  ],\n  O: [\n    '011110',\n    '110011',\n    '110011',\n    '110011',\n    '110011',\n    '110011',\n    '011110',\n  ],\n  R: [\n    '111110',\n    '110011',\n    '110011',\n    '111110',\n    '110110',\n    '110011',\n    '110011',\n  ],\n  B: [\n    '111110',\n    '110011',\n    '110011',\n    '111110',\n    '110011',\n    '110011',\n    '111110',\n  ],\n  I: [\n    '1111',\n    '0110',\n    '0110',\n    '0110',\n    '0110',\n    '0110',\n    '1111',\n  ],\n}\n\nfunction renderReferenceCardBanner(): string {\n  const heading = justifyCardContent('  Plain text', '⧉', cardWidth)\n\n  return [\n    `${ansi.cardBorder}╭${'─'.repeat(cardWidth + 2)}╮${ansi.reset}`,\n    renderCardLine(heading, 'title'),\n    renderCardLine('', 'blank'),\n    ...renderLayeredPixelWordmarkCardLines('THORBIT'),\n    renderCardLine('', 'blank'),\n    renderCardLine('  THORBIT CONTENT MCP', 'caption'),\n    `${ansi.cardBorder}╰${'─'.repeat(cardWidth + 2)}╯${ansi.reset}`,\n  ].join('\\n')\n}\n\nfunction renderAsciiBanner(): string {\n  const contentWidth = 96\n  const border = `+${'-'.repeat(contentWidth + 2)}+`\n  const cardLine = (content = '') => `| ${content.padEnd(contentWidth)} |`\n  const title = 'Plain text'\n  const copy = '[copy]'\n  const lines = [\n    border,\n    cardLine(`${title}${' '.repeat(contentWidth - title.length - copy.length)}${copy}`),\n    cardLine(),\n    ...renderAsciiWordmark('THORBIT').map(line => cardLine(`  ${line}`)),\n    cardLine(),\n    cardLine('  THORBIT CONTENT MCP'),\n    border,\n  ]\n\n  return lines.join('\\n')\n}\n\nfunction renderCardLine(content: string, tone: CardTone): string {\n  const foreground = {\n    title: ansi.cream,\n    mark: ansi.clay,\n    wire: ansi.wire,\n    caption: ansi.terracotta,\n    blank: ansi.slate,\n  }[tone]\n  return renderCardLineParts([{ color: foreground, text: content }])\n}\n\nfunction renderCardLineParts(parts: CardPart[]): string {\n  const visibleWidth = parts.reduce((width, part) => width + part.text.length, 0)\n  const padding = ' '.repeat(Math.max(0, cardWidth - visibleWidth))\n  return [\n    `${ansi.cardBorder}│${ansi.reset}`,\n    ansi.cardBg,\n    ' ',\n    ...parts.map(part => `${part.color}${part.text}`),\n    padding,\n    ' ',\n    ansi.reset,\n    `${ansi.cardBorder}│${ansi.reset}`,\n  ].join('')\n}\n\nfunction justifyCardContent(left: string, right: string, width: number): string {\n  return `${left}${' '.repeat(Math.max(1, width - left.length - right.length))}${right}`\n}\n\nfunction buildPixelWordmarkMatrix(word: string): boolean[][] {\n  const rows: boolean[][] = Array.from({ length: 7 }, () => [])\n  for (let rowIndex = 0; rowIndex < 7; rowIndex += 1) {\n    word.split('').forEach((letter, letterIndex) => {\n      const pattern = thorbitPixelLetters[letter]\n      if (!pattern) return\n      if (letterIndex > 0) rows[rowIndex].push(false)\n      rows[rowIndex].push(...pattern[rowIndex].split('').map(cell => cell === '1'))\n    })\n  }\n  return rows\n}\n\nfunction renderLayeredPixelWordmarkCardLines(word: string): string[] {\n  const matrix = buildPixelWordmarkMatrix(word)\n  const wordmarkWidth = Math.max(...matrix.map(row => row.length))\n  const shadowOffsetX = 1\n  const shadowOffsetY = -1\n  const outputRows = matrix.length + Math.abs(Math.min(0, shadowOffsetY))\n  const outputWidth = wordmarkWidth + shadowOffsetX\n\n  return Array.from({ length: outputRows }, (_, outputRowIndex) => {\n    const rowParts: CardPart[] = [{ color: ansi.slate, text: '    ' }]\n\n    for (let columnIndex = 0; columnIndex < outputWidth; columnIndex += 1) {\n      const foregroundRow = outputRowIndex - Math.abs(Math.min(0, shadowOffsetY))\n      const hasForeground = foregroundRow >= 0 && Boolean(matrix[foregroundRow]?.[columnIndex])\n      const shadowSourceRow = outputRowIndex - shadowOffsetY - Math.abs(Math.min(0, shadowOffsetY))\n      const shadowSourceColumn = columnIndex - shadowOffsetX\n      const hasShadow = shadowSourceRow >= 0 && shadowSourceColumn >= 0\n        && Boolean(matrix[shadowSourceRow]?.[shadowSourceColumn])\n\n      if (hasForeground) {\n        appendCardPart(rowParts, ansi.clay, '██')\n      } else if (hasShadow) {\n        appendCardPart(rowParts, ansi.shadow, '░░')\n      } else {\n        appendCardPart(rowParts, ansi.slate, '  ')\n      }\n    }\n\n    return renderCardLineParts(rowParts)\n  })\n}\n\nfunction appendCardPart(parts: CardPart[], color: string, text: string): void {\n  const previous = parts[parts.length - 1]\n  if (previous?.color === color) {\n    previous.text += text\n    return\n  }\n  parts.push({ color, text })\n}\n\nfunction renderAsciiWordmark(word: string): string[] {\n  const matrix = buildPixelWordmarkMatrix(word)\n  const rows: string[] = []\n  for (const matrixRow of matrix) {\n    rows.push(matrixRow.map(cell => (cell ? '#' : ' ')).join(''))\n  }\n  return rows\n}\n\nexport function renderInstallInstructions(options: InstallOptions): string {\n  const color = options.color\n  const json = JSON.stringify(buildMcpConfig(options), null, 2)\n  const keySetup = options.keyPath\n    ? [\n        paint('Key file mode', ansi.terracotta, color),\n        `  chmod 600 ${options.keyPath}`,\n      ].join('\\n')\n    : [\n        paint('Safer key-file option', ansi.terracotta, color),\n        '  mkdir -p ~/.config/thorbit',\n        \"  printf '%s\\\\n' 'thbt_mcp_...' > ~/.config/thorbit/content-mcp-key\",\n        '  chmod 600 ~/.config/thorbit/content-mcp-key',\n        '',\n        '  Then run:',\n        '  npx -y -p thorbit-content-mcp@latest thorbit-content-mcp-install --key-path ~/.config/thorbit/content-mcp-key',\n      ].join('\\n')\n\n  return [\n    renderBanner(color),\n    paint('MCP Scraper research and on-page analysis for MCP agents.', ansi.slate, color),\n    '',\n    `${paint('1.', ansi.terracotta, color)} Generate an API key in Thorbit Settings -> MCPs with content/onpage scopes.`,\n    `${paint('2.', ansi.terracotta, color)} Add this server config to your MCP client:`,\n    '',\n    json,\n    '',\n    `${paint('3.', ansi.terracotta, color)} Restart your MCP client, then call ${paint('thorbit_content_harvest_serp', ansi.green, color)} or ${paint('thorbit_content_reddit_research', ansi.green, color)}.`,\n    '',\n    keySetup,\n    '',\n    paint('Tools', ansi.terracotta, color),\n    '  thorbit_content_extract_url       Extract a URL through MCP Scraper.',\n    '  thorbit_content_harvest_serp      Harvest full SERP/PAA evidence through MCP Scraper.',\n    '  thorbit_content_reddit_research   Read Reddit through MCP Scraper browser-agent.',\n    '  thorbit_onpage_start_analysis     Start durable Thorbit on-page analysis.',\n    '  thorbit_onpage_get_analysis       Read analysis status and summary.',\n    '',\n    paint('Raw JSON:', ansi.slate, color),\n    '  npx -y -p thorbit-content-mcp@latest thorbit-content-mcp-install --json --api-key thbt_mcp_...',\n    '',\n  ].join('\\n')\n}\n\nexport function main(): void {\n  const options = resolveInstallOptions()\n  if (options.help) {\n    process.stdout.write(renderHelp(options.color))\n    return\n  }\n\n  if (options.json) {\n    process.stdout.write(`${JSON.stringify(buildMcpConfig(options), null, 2)}\\n`)\n    return\n  }\n\n  process.stdout.write(renderInstallInstructions(options))\n}\n\nfunction isMainModule(): boolean {\n  const entry = process.argv[1]\n  if (!entry) return false\n  try {\n    return realpathSync(entry) === realpathSync(fileURLToPath(import.meta.url))\n  } catch {\n    return false\n  }\n}\n\nif (isMainModule()) main()\n"],"mappings":"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","names":[]}

package/dist/bin/thorbit-content-mcp-install.js

@@ -274,7 +274,7 @@ function renderInstallInstructions(options) {
     "",
     paint("Tools", ansi.terracotta, color),
     "  thorbit_content_extract_url       Extract a URL through MCP Scraper.",
-    "  thorbit_content_harvest_serp      Harvest SERP/PAA evidence through MCP Scraper.",
+    "  thorbit_content_harvest_serp      Harvest full SERP/PAA evidence through MCP Scraper.",
     "  thorbit_content_reddit_research   Read Reddit through MCP Scraper browser-agent.",
     "  thorbit_onpage_start_analysis     Start durable Thorbit on-page analysis.",
     "  thorbit_onpage_get_analysis       Read analysis status and summary.",

package/dist/bin/thorbit-content-mcp-install.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../bin/thorbit-content-mcp-install.ts"],"sourcesContent":["import { realpathSync } from 'node:fs'\nimport { fileURLToPath } from 'node:url'\n\nexport type InstallOptions = {\n  apiKey: string\n  baseUrl?: string\n  keyPath?: string\n  serverName: string\n  json: boolean\n  color: boolean\n  help: boolean\n}\n\nexport function readArg(name: string, argv = process.argv.slice(2)): string | undefined {\n  const prefix = `--${name}=`\n  const inline = argv.find(arg => arg.startsWith(prefix))\n  if (inline) return inline.slice(prefix.length)\n  const index = argv.indexOf(`--${name}`)\n  return index >= 0 ? argv[index + 1] : undefined\n}\n\nexport function hasFlag(name: string, argv = process.argv.slice(2)): boolean {\n  return argv.includes(`--${name}`)\n}\n\nexport function resolveInstallOptions(argv = process.argv.slice(2)): InstallOptions {\n  return {\n    apiKey: readArg('api-key', argv) ?? process.env.THORBIT_API_KEY ?? process.env.THORBIT_MCP_API_KEY ?? 'thbt_mcp_...',\n    baseUrl: readArg('base-url', argv) ?? process.env.THORBIT_BASE_URL,\n    keyPath: readArg('key-path', argv) ?? process.env.THORBIT_CONTENT_MCP_KEY_PATH,\n    serverName: readArg('server-name', argv) ?? 'thorbit-content',\n    json: hasFlag('json', argv),\n    color: !hasFlag('no-color', argv),\n    help: hasFlag('help', argv) || hasFlag('h', argv),\n  }\n}\n\nexport function buildMcpConfig(options: InstallOptions) {\n  const env: Record<string, string> = options.keyPath\n    ? { THORBIT_CONTENT_MCP_KEY_PATH: options.keyPath }\n    : { THORBIT_API_KEY: options.apiKey }\n\n  if (options.baseUrl) {\n    env.THORBIT_BASE_URL = options.baseUrl.replace(/\\/$/, '')\n  }\n\n  return {\n    mcpServers: {\n      [options.serverName]: {\n        command: 'npx',\n        args: ['-y', 'thorbit-content-mcp@latest'],\n        env,\n      },\n    },\n  }\n}\n\nconst ansi = {\n  reset: '\\u001b[0m',\n  bold: '\\u001b[1m',\n  dim: '\\u001b[2m',\n  terracotta: '\\u001b[38;2;198;90;54m',\n  cardBg: '\\u001b[48;2;31;31;31m',\n  cardBorder: '\\u001b[38;2;108;66;50m',\n  clay: '\\u001b[38;2;226;138;92m',\n  cream: '\\u001b[38;2;255;244;230m',\n  green: '\\u001b[38;2;75;181;67m',\n  shadow: '\\u001b[38;2;116;70;56m',\n  slate: '\\u001b[38;2;174;181;195m',\n  wire: '\\u001b[38;2;198;90;54m',\n}\n\nfunction paint(value: string, code: string, enabled: boolean): string {\n  return enabled ? `${code}${value}${ansi.reset}` : value\n}\n\nexport function renderHelp(color: boolean): string {\n  return [\n    renderBanner(color),\n    '',\n    'Usage:',\n    '  npx -y -p thorbit-content-mcp@latest thorbit-content-mcp-install [options]',\n    '',\n    'Options:',\n    '  --api-key <key>        Thorbit MCP API key from Settings -> MCPs.',\n    '  --key-path <path>      File containing the API key. Preferred for shared machines and servers.',\n    '  --base-url <url>       Thorbit app URL. Defaults to https://thorbit.ai.',\n    '  --server-name <name>   MCP client server name. Defaults to thorbit-content.',\n    '  --json                 Print only MCP client JSON.',\n    '  --no-color             Disable ANSI color.',\n    '  --help                 Show this help.',\n    '',\n  ].join('\\n')\n}\n\nexport function renderBanner(color: boolean): string {\n  return color ? renderReferenceCardBanner() : renderAsciiBanner()\n}\n\nconst cardWidth = 104\n\ntype CardTone = 'title' | 'mark' | 'wire' | 'caption' | 'blank'\ntype CardPart = {\n  color: string\n  text: string\n}\n\nconst thorbitPixelLetters: Record<string, string[]> = {\n  T: [\n    '1111111',\n    '0011000',\n    '0011000',\n    '0011000',\n    '0011000',\n    '0011000',\n    '0011000',\n  ],\n  H: [\n    '110011',\n    '110011',\n    '110011',\n    '111111',\n    '110011',\n    '110011',\n    '110011',\n  ],\n  O: [\n    '011110',\n    '110011',\n    '110011',\n    '110011',\n    '110011',\n    '110011',\n    '011110',\n  ],\n  R: [\n    '111110',\n    '110011',\n    '110011',\n    '111110',\n    '110110',\n    '110011',\n    '110011',\n  ],\n  B: [\n    '111110',\n    '110011',\n    '110011',\n    '111110',\n    '110011',\n    '110011',\n    '111110',\n  ],\n  I: [\n    '1111',\n    '0110',\n    '0110',\n    '0110',\n    '0110',\n    '0110',\n    '1111',\n  ],\n}\n\nfunction renderReferenceCardBanner(): string {\n  const heading = justifyCardContent('  Plain text', '⧉', cardWidth)\n\n  return [\n    `${ansi.cardBorder}╭${'─'.repeat(cardWidth + 2)}╮${ansi.reset}`,\n    renderCardLine(heading, 'title'),\n    renderCardLine('', 'blank'),\n    ...renderLayeredPixelWordmarkCardLines('THORBIT'),\n    renderCardLine('', 'blank'),\n    renderCardLine('  THORBIT CONTENT MCP', 'caption'),\n    `${ansi.cardBorder}╰${'─'.repeat(cardWidth + 2)}╯${ansi.reset}`,\n  ].join('\\n')\n}\n\nfunction renderAsciiBanner(): string {\n  const contentWidth = 96\n  const border = `+${'-'.repeat(contentWidth + 2)}+`\n  const cardLine = (content = '') => `| ${content.padEnd(contentWidth)} |`\n  const title = 'Plain text'\n  const copy = '[copy]'\n  const lines = [\n    border,\n    cardLine(`${title}${' '.repeat(contentWidth - title.length - copy.length)}${copy}`),\n    cardLine(),\n    ...renderAsciiWordmark('THORBIT').map(line => cardLine(`  ${line}`)),\n    cardLine(),\n    cardLine('  THORBIT CONTENT MCP'),\n    border,\n  ]\n\n  return lines.join('\\n')\n}\n\nfunction renderCardLine(content: string, tone: CardTone): string {\n  const foreground = {\n    title: ansi.cream,\n    mark: ansi.clay,\n    wire: ansi.wire,\n    caption: ansi.terracotta,\n    blank: ansi.slate,\n  }[tone]\n  return renderCardLineParts([{ color: foreground, text: content }])\n}\n\nfunction renderCardLineParts(parts: CardPart[]): string {\n  const visibleWidth = parts.reduce((width, part) => width + part.text.length, 0)\n  const padding = ' '.repeat(Math.max(0, cardWidth - visibleWidth))\n  return [\n    `${ansi.cardBorder}│${ansi.reset}`,\n    ansi.cardBg,\n    ' ',\n    ...parts.map(part => `${part.color}${part.text}`),\n    padding,\n    ' ',\n    ansi.reset,\n    `${ansi.cardBorder}│${ansi.reset}`,\n  ].join('')\n}\n\nfunction justifyCardContent(left: string, right: string, width: number): string {\n  return `${left}${' '.repeat(Math.max(1, width - left.length - right.length))}${right}`\n}\n\nfunction buildPixelWordmarkMatrix(word: string): boolean[][] {\n  const rows: boolean[][] = Array.from({ length: 7 }, () => [])\n  for (let rowIndex = 0; rowIndex < 7; rowIndex += 1) {\n    word.split('').forEach((letter, letterIndex) => {\n      const pattern = thorbitPixelLetters[letter]\n      if (!pattern) return\n      if (letterIndex > 0) rows[rowIndex].push(false)\n      rows[rowIndex].push(...pattern[rowIndex].split('').map(cell => cell === '1'))\n    })\n  }\n  return rows\n}\n\nfunction renderLayeredPixelWordmarkCardLines(word: string): string[] {\n  const matrix = buildPixelWordmarkMatrix(word)\n  const wordmarkWidth = Math.max(...matrix.map(row => row.length))\n  const shadowOffsetX = 1\n  const shadowOffsetY = -1\n  const outputRows = matrix.length + Math.abs(Math.min(0, shadowOffsetY))\n  const outputWidth = wordmarkWidth + shadowOffsetX\n\n  return Array.from({ length: outputRows }, (_, outputRowIndex) => {\n    const rowParts: CardPart[] = [{ color: ansi.slate, text: '    ' }]\n\n    for (let columnIndex = 0; columnIndex < outputWidth; columnIndex += 1) {\n      const foregroundRow = outputRowIndex - Math.abs(Math.min(0, shadowOffsetY))\n      const hasForeground = foregroundRow >= 0 && Boolean(matrix[foregroundRow]?.[columnIndex])\n      const shadowSourceRow = outputRowIndex - shadowOffsetY - Math.abs(Math.min(0, shadowOffsetY))\n      const shadowSourceColumn = columnIndex - shadowOffsetX\n      const hasShadow = shadowSourceRow >= 0 && shadowSourceColumn >= 0\n        && Boolean(matrix[shadowSourceRow]?.[shadowSourceColumn])\n\n      if (hasForeground) {\n        appendCardPart(rowParts, ansi.clay, '██')\n      } else if (hasShadow) {\n        appendCardPart(rowParts, ansi.shadow, '░░')\n      } else {\n        appendCardPart(rowParts, ansi.slate, '  ')\n      }\n    }\n\n    return renderCardLineParts(rowParts)\n  })\n}\n\nfunction appendCardPart(parts: CardPart[], color: string, text: string): void {\n  const previous = parts[parts.length - 1]\n  if (previous?.color === color) {\n    previous.text += text\n    return\n  }\n  parts.push({ color, text })\n}\n\nfunction renderAsciiWordmark(word: string): string[] {\n  const matrix = buildPixelWordmarkMatrix(word)\n  const rows: string[] = []\n  for (const matrixRow of matrix) {\n    rows.push(matrixRow.map(cell => (cell ? '#' : ' ')).join(''))\n  }\n  return rows\n}\n\nexport function renderInstallInstructions(options: InstallOptions): string {\n  const color = options.color\n  const json = JSON.stringify(buildMcpConfig(options), null, 2)\n  const keySetup = options.keyPath\n    ? [\n        paint('Key file mode', ansi.terracotta, color),\n        `  chmod 600 ${options.keyPath}`,\n      ].join('\\n')\n    : [\n        paint('Safer key-file option', ansi.terracotta, color),\n        '  mkdir -p ~/.config/thorbit',\n        \"  printf '%s\\\\n' 'thbt_mcp_...' > ~/.config/thorbit/content-mcp-key\",\n        '  chmod 600 ~/.config/thorbit/content-mcp-key',\n        '',\n        '  Then run:',\n        '  npx -y -p thorbit-content-mcp@latest thorbit-content-mcp-install --key-path ~/.config/thorbit/content-mcp-key',\n      ].join('\\n')\n\n  return [\n    renderBanner(color),\n    paint('MCP Scraper research and on-page analysis for MCP agents.', ansi.slate, color),\n    '',\n    `${paint('1.', ansi.terracotta, color)} Generate an API key in Thorbit Settings -> MCPs with content/onpage scopes.`,\n    `${paint('2.', ansi.terracotta, color)} Add this server config to your MCP client:`,\n    '',\n    json,\n    '',\n    `${paint('3.', ansi.terracotta, color)} Restart your MCP client, then call ${paint('thorbit_content_harvest_serp', ansi.green, color)} or ${paint('thorbit_content_reddit_research', ansi.green, color)}.`,\n    '',\n    keySetup,\n    '',\n    paint('Tools', ansi.terracotta, color),\n    '  thorbit_content_extract_url       Extract a URL through MCP Scraper.',\n    '  thorbit_content_harvest_serp      Harvest SERP/PAA evidence through MCP Scraper.',\n    '  thorbit_content_reddit_research   Read Reddit through MCP Scraper browser-agent.',\n    '  thorbit_onpage_start_analysis     Start durable Thorbit on-page analysis.',\n    '  thorbit_onpage_get_analysis       Read analysis status and summary.',\n    '',\n    paint('Raw JSON:', ansi.slate, color),\n    '  npx -y -p thorbit-content-mcp@latest thorbit-content-mcp-install --json --api-key thbt_mcp_...',\n    '',\n  ].join('\\n')\n}\n\nexport function main(): void {\n  const options = resolveInstallOptions()\n  if (options.help) {\n    process.stdout.write(renderHelp(options.color))\n    return\n  }\n\n  if (options.json) {\n    process.stdout.write(`${JSON.stringify(buildMcpConfig(options), null, 2)}\\n`)\n    return\n  }\n\n  process.stdout.write(renderInstallInstructions(options))\n}\n\nfunction isMainModule(): boolean {\n  const entry = process.argv[1]\n  if (!entry) return false\n  try {\n    return realpathSync(entry) === realpathSync(fileURLToPath(import.meta.url))\n  } catch {\n    return false\n  }\n}\n\nif (isMainModule()) main()\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../bin/thorbit-content-mcp-install.ts"],"sourcesContent":["import { realpathSync } from 'node:fs'\nimport { fileURLToPath } from 'node:url'\n\nexport type InstallOptions = {\n  apiKey: string\n  baseUrl?: string\n  keyPath?: string\n  serverName: string\n  json: boolean\n  color: boolean\n  help: boolean\n}\n\nexport function readArg(name: string, argv = process.argv.slice(2)): string | undefined {\n  const prefix = `--${name}=`\n  const inline = argv.find(arg => arg.startsWith(prefix))\n  if (inline) return inline.slice(prefix.length)\n  const index = argv.indexOf(`--${name}`)\n  return index >= 0 ? argv[index + 1] : undefined\n}\n\nexport function hasFlag(name: string, argv = process.argv.slice(2)): boolean {\n  return argv.includes(`--${name}`)\n}\n\nexport function resolveInstallOptions(argv = process.argv.slice(2)): InstallOptions {\n  return {\n    apiKey: readArg('api-key', argv) ?? process.env.THORBIT_API_KEY ?? process.env.THORBIT_MCP_API_KEY ?? 'thbt_mcp_...',\n    baseUrl: readArg('base-url', argv) ?? process.env.THORBIT_BASE_URL,\n    keyPath: readArg('key-path', argv) ?? process.env.THORBIT_CONTENT_MCP_KEY_PATH,\n    serverName: readArg('server-name', argv) ?? 'thorbit-content',\n    json: hasFlag('json', argv),\n    color: !hasFlag('no-color', argv),\n    help: hasFlag('help', argv) || hasFlag('h', argv),\n  }\n}\n\nexport function buildMcpConfig(options: InstallOptions) {\n  const env: Record<string, string> = options.keyPath\n    ? { THORBIT_CONTENT_MCP_KEY_PATH: options.keyPath }\n    : { THORBIT_API_KEY: options.apiKey }\n\n  if (options.baseUrl) {\n    env.THORBIT_BASE_URL = options.baseUrl.replace(/\\/$/, '')\n  }\n\n  return {\n    mcpServers: {\n      [options.serverName]: {\n        command: 'npx',\n        args: ['-y', 'thorbit-content-mcp@latest'],\n        env,\n      },\n    },\n  }\n}\n\nconst ansi = {\n  reset: '\\u001b[0m',\n  bold: '\\u001b[1m',\n  dim: '\\u001b[2m',\n  terracotta: '\\u001b[38;2;198;90;54m',\n  cardBg: '\\u001b[48;2;31;31;31m',\n  cardBorder: '\\u001b[38;2;108;66;50m',\n  clay: '\\u001b[38;2;226;138;92m',\n  cream: '\\u001b[38;2;255;244;230m',\n  green: '\\u001b[38;2;75;181;67m',\n  shadow: '\\u001b[38;2;116;70;56m',\n  slate: '\\u001b[38;2;174;181;195m',\n  wire: '\\u001b[38;2;198;90;54m',\n}\n\nfunction paint(value: string, code: string, enabled: boolean): string {\n  return enabled ? `${code}${value}${ansi.reset}` : value\n}\n\nexport function renderHelp(color: boolean): string {\n  return [\n    renderBanner(color),\n    '',\n    'Usage:',\n    '  npx -y -p thorbit-content-mcp@latest thorbit-content-mcp-install [options]',\n    '',\n    'Options:',\n    '  --api-key <key>        Thorbit MCP API key from Settings -> MCPs.',\n    '  --key-path <path>      File containing the API key. Preferred for shared machines and servers.',\n    '  --base-url <url>       Thorbit app URL. Defaults to https://thorbit.ai.',\n    '  --server-name <name>   MCP client server name. Defaults to thorbit-content.',\n    '  --json                 Print only MCP client JSON.',\n    '  --no-color             Disable ANSI color.',\n    '  --help                 Show this help.',\n    '',\n  ].join('\\n')\n}\n\nexport function renderBanner(color: boolean): string {\n  return color ? renderReferenceCardBanner() : renderAsciiBanner()\n}\n\nconst cardWidth = 104\n\ntype CardTone = 'title' | 'mark' | 'wire' | 'caption' | 'blank'\ntype CardPart = {\n  color: string\n  text: string\n}\n\nconst thorbitPixelLetters: Record<string, string[]> = {\n  T: [\n    '1111111',\n    '0011000',\n    '0011000',\n    '0011000',\n    '0011000',\n    '0011000',\n    '0011000',\n  ],\n  H: [\n    '110011',\n    '110011',\n    '110011',\n    '111111',\n    '110011',\n    '110011',\n    '110011',\n  ],\n  O: [\n    '011110',\n    '110011',\n    '110011',\n    '110011',\n    '110011',\n    '110011',\n    '011110',\n  ],\n  R: [\n    '111110',\n    '110011',\n    '110011',\n    '111110',\n    '110110',\n    '110011',\n    '110011',\n  ],\n  B: [\n    '111110',\n    '110011',\n    '110011',\n    '111110',\n    '110011',\n    '110011',\n    '111110',\n  ],\n  I: [\n    '1111',\n    '0110',\n    '0110',\n    '0110',\n    '0110',\n    '0110',\n    '1111',\n  ],\n}\n\nfunction renderReferenceCardBanner(): string {\n  const heading = justifyCardContent('  Plain text', '⧉', cardWidth)\n\n  return [\n    `${ansi.cardBorder}╭${'─'.repeat(cardWidth + 2)}╮${ansi.reset}`,\n    renderCardLine(heading, 'title'),\n    renderCardLine('', 'blank'),\n    ...renderLayeredPixelWordmarkCardLines('THORBIT'),\n    renderCardLine('', 'blank'),\n    renderCardLine('  THORBIT CONTENT MCP', 'caption'),\n    `${ansi.cardBorder}╰${'─'.repeat(cardWidth + 2)}╯${ansi.reset}`,\n  ].join('\\n')\n}\n\nfunction renderAsciiBanner(): string {\n  const contentWidth = 96\n  const border = `+${'-'.repeat(contentWidth + 2)}+`\n  const cardLine = (content = '') => `| ${content.padEnd(contentWidth)} |`\n  const title = 'Plain text'\n  const copy = '[copy]'\n  const lines = [\n    border,\n    cardLine(`${title}${' '.repeat(contentWidth - title.length - copy.length)}${copy}`),\n    cardLine(),\n    ...renderAsciiWordmark('THORBIT').map(line => cardLine(`  ${line}`)),\n    cardLine(),\n    cardLine('  THORBIT CONTENT MCP'),\n    border,\n  ]\n\n  return lines.join('\\n')\n}\n\nfunction renderCardLine(content: string, tone: CardTone): string {\n  const foreground = {\n    title: ansi.cream,\n    mark: ansi.clay,\n    wire: ansi.wire,\n    caption: ansi.terracotta,\n    blank: ansi.slate,\n  }[tone]\n  return renderCardLineParts([{ color: foreground, text: content }])\n}\n\nfunction renderCardLineParts(parts: CardPart[]): string {\n  const visibleWidth = parts.reduce((width, part) => width + part.text.length, 0)\n  const padding = ' '.repeat(Math.max(0, cardWidth - visibleWidth))\n  return [\n    `${ansi.cardBorder}│${ansi.reset}`,\n    ansi.cardBg,\n    ' ',\n    ...parts.map(part => `${part.color}${part.text}`),\n    padding,\n    ' ',\n    ansi.reset,\n    `${ansi.cardBorder}│${ansi.reset}`,\n  ].join('')\n}\n\nfunction justifyCardContent(left: string, right: string, width: number): string {\n  return `${left}${' '.repeat(Math.max(1, width - left.length - right.length))}${right}`\n}\n\nfunction buildPixelWordmarkMatrix(word: string): boolean[][] {\n  const rows: boolean[][] = Array.from({ length: 7 }, () => [])\n  for (let rowIndex = 0; rowIndex < 7; rowIndex += 1) {\n    word.split('').forEach((letter, letterIndex) => {\n      const pattern = thorbitPixelLetters[letter]\n      if (!pattern) return\n      if (letterIndex > 0) rows[rowIndex].push(false)\n      rows[rowIndex].push(...pattern[rowIndex].split('').map(cell => cell === '1'))\n    })\n  }\n  return rows\n}\n\nfunction renderLayeredPixelWordmarkCardLines(word: string): string[] {\n  const matrix = buildPixelWordmarkMatrix(word)\n  const wordmarkWidth = Math.max(...matrix.map(row => row.length))\n  const shadowOffsetX = 1\n  const shadowOffsetY = -1\n  const outputRows = matrix.length + Math.abs(Math.min(0, shadowOffsetY))\n  const outputWidth = wordmarkWidth + shadowOffsetX\n\n  return Array.from({ length: outputRows }, (_, outputRowIndex) => {\n    const rowParts: CardPart[] = [{ color: ansi.slate, text: '    ' }]\n\n    for (let columnIndex = 0; columnIndex < outputWidth; columnIndex += 1) {\n      const foregroundRow = outputRowIndex - Math.abs(Math.min(0, shadowOffsetY))\n      const hasForeground = foregroundRow >= 0 && Boolean(matrix[foregroundRow]?.[columnIndex])\n      const shadowSourceRow = outputRowIndex - shadowOffsetY - Math.abs(Math.min(0, shadowOffsetY))\n      const shadowSourceColumn = columnIndex - shadowOffsetX\n      const hasShadow = shadowSourceRow >= 0 && shadowSourceColumn >= 0\n        && Boolean(matrix[shadowSourceRow]?.[shadowSourceColumn])\n\n      if (hasForeground) {\n        appendCardPart(rowParts, ansi.clay, '██')\n      } else if (hasShadow) {\n        appendCardPart(rowParts, ansi.shadow, '░░')\n      } else {\n        appendCardPart(rowParts, ansi.slate, '  ')\n      }\n    }\n\n    return renderCardLineParts(rowParts)\n  })\n}\n\nfunction appendCardPart(parts: CardPart[], color: string, text: string): void {\n  const previous = parts[parts.length - 1]\n  if (previous?.color === color) {\n    previous.text += text\n    return\n  }\n  parts.push({ color, text })\n}\n\nfunction renderAsciiWordmark(word: string): string[] {\n  const matrix = buildPixelWordmarkMatrix(word)\n  const rows: string[] = []\n  for (const matrixRow of matrix) {\n    rows.push(matrixRow.map(cell => (cell ? '#' : ' ')).join(''))\n  }\n  return rows\n}\n\nexport function renderInstallInstructions(options: InstallOptions): string {\n  const color = options.color\n  const json = JSON.stringify(buildMcpConfig(options), null, 2)\n  const keySetup = options.keyPath\n    ? [\n        paint('Key file mode', ansi.terracotta, color),\n        `  chmod 600 ${options.keyPath}`,\n      ].join('\\n')\n    : [\n        paint('Safer key-file option', ansi.terracotta, color),\n        '  mkdir -p ~/.config/thorbit',\n        \"  printf '%s\\\\n' 'thbt_mcp_...' > ~/.config/thorbit/content-mcp-key\",\n        '  chmod 600 ~/.config/thorbit/content-mcp-key',\n        '',\n        '  Then run:',\n        '  npx -y -p thorbit-content-mcp@latest thorbit-content-mcp-install --key-path ~/.config/thorbit/content-mcp-key',\n      ].join('\\n')\n\n  return [\n    renderBanner(color),\n    paint('MCP Scraper research and on-page analysis for MCP agents.', ansi.slate, color),\n    '',\n    `${paint('1.', ansi.terracotta, color)} Generate an API key in Thorbit Settings -> MCPs with content/onpage scopes.`,\n    `${paint('2.', ansi.terracotta, color)} Add this server config to your MCP client:`,\n    '',\n    json,\n    '',\n    `${paint('3.', ansi.terracotta, color)} Restart your MCP client, then call ${paint('thorbit_content_harvest_serp', ansi.green, color)} or ${paint('thorbit_content_reddit_research', ansi.green, color)}.`,\n    '',\n    keySetup,\n    '',\n    paint('Tools', ansi.terracotta, color),\n    '  thorbit_content_extract_url       Extract a URL through MCP Scraper.',\n    '  thorbit_content_harvest_serp      Harvest full SERP/PAA evidence through MCP Scraper.',\n    '  thorbit_content_reddit_research   Read Reddit through MCP Scraper browser-agent.',\n    '  thorbit_onpage_start_analysis     Start durable Thorbit on-page analysis.',\n    '  thorbit_onpage_get_analysis       Read analysis status and summary.',\n    '',\n    paint('Raw JSON:', ansi.slate, color),\n    '  npx -y -p thorbit-content-mcp@latest thorbit-content-mcp-install --json --api-key thbt_mcp_...',\n    '',\n  ].join('\\n')\n}\n\nexport function main(): void {\n  const options = resolveInstallOptions()\n  if (options.help) {\n    process.stdout.write(renderHelp(options.color))\n    return\n  }\n\n  if (options.json) {\n    process.stdout.write(`${JSON.stringify(buildMcpConfig(options), null, 2)}\\n`)\n    return\n  }\n\n  process.stdout.write(renderInstallInstructions(options))\n}\n\nfunction isMainModule(): boolean {\n  const entry = process.argv[1]\n  if (!entry) return false\n  try {\n    return realpathSync(entry) === realpathSync(fileURLToPath(import.meta.url))\n  } catch {\n    return false\n  }\n}\n\nif (isMainModule()) main()\n"],"mappings":"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","names":[]}

package/dist/bin/thorbit-content-mcp.cjs

@@ -86,18 +86,31 @@ var ThorbitContentExtractUrlInputSchema = {
   downloadMedia: import_zod.z.boolean().default(false).describe("Ask MCP Scraper to download page media when supported."),
   maxCharacters: import_zod.z.number().int().min(500).max(5e5).default(8e4).describe("Maximum extracted content characters returned to the MCP caller.")
 };
+var McpScraperProxyModeSchema = import_zod.z.enum(["location", "configured", "none"]);
+var McpScraperSerpDeviceSchema = import_zod.z.enum(["desktop", "mobile"]);
 var ThorbitContentHarvestSerpInputSchema = {
-  query: import_zod.z.string().min(1).max(400).describe("Search query for MCP Scraper SERP/PAA harvest."),
-  location: import_zod.z.string().min(1).max(160).optional().describe("Optional search location, such as Denver, Colorado, United States."),
+  query: import_zod.z.string().min(1).max(400).describe('Core search topic. Separate location when possible, e.g. query="best CRM" and location="Denver, CO".'),
+  location: import_zod.z.string().min(1).max(160).optional().describe("Optional search location, such as Denver, CO. Required for precise residential proxy targeting."),
   gl: import_zod.z.string().length(2).optional().describe("Optional Google country code, such as us."),
   hl: import_zod.z.string().min(2).max(12).optional().describe("Optional Google interface language, such as en."),
-  maxQuestions: import_zod.z.number().int().min(1).max(150).default(30).describe("Maximum PAA questions when serpOnly is false."),
+  device: McpScraperSerpDeviceSchema.default("desktop").describe("SERP device context. Use desktop by default; use mobile only when requested."),
+  maxQuestions: import_zod.z.number().int().min(1).max(200).default(30).describe("Maximum PAA questions when serpOnly is false."),
   includeSerp: import_zod.z.boolean().default(true).describe("Include organic SERP results. Default true."),
-  serpOnly: import_zod.z.boolean().default(false).describe("Use fast SERP-only mode when PAA expansion is not needed.")
+  serpOnly: import_zod.z.boolean().default(false).describe("Use fast SERP-only mode when PAA expansion is not needed."),
+  proxyMode: McpScraperProxyModeSchema.default("location").describe("MCP Scraper proxy mode. Use location by default for US city/state SERPs so MCP Scraper rotates fresh residential proxy IDs and browser sessions across retryable CAPTCHA/proxy/location failures."),
+  proxyZip: import_zod.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting. Use when a specific ZIP or city-center ZIP is known."),
+  debug: import_zod.z.boolean().default(false).describe("Include sanitized MCP Scraper browser/proxy/location diagnostics and attempt telemetry. Use true when debugging CAPTCHA, proxy selection, or localization."),
+  pages: import_zod.z.number().int().min(1).max(2).default(1).describe("Number of Google result pages to fetch in SERP-only mode.")
 };
 var ThorbitContentRedditResearchInputSchema = {
   query: import_zod.z.string().min(1).max(400).describe("Topic, product, service, or pain point to research on Reddit."),
-  location: import_zod.z.string().min(1).max(160).optional().describe("Optional location to bias MCP Scraper SERP discovery."),
+  location: import_zod.z.string().min(1).max(160).optional().describe("Optional location to bias MCP Scraper SERP discovery and residential proxy targeting."),
+  gl: import_zod.z.string().length(2).optional().describe("Optional Google country code, such as us."),
+  hl: import_zod.z.string().min(2).max(12).optional().describe("Optional Google interface language, such as en."),
+  device: McpScraperSerpDeviceSchema.default("desktop").describe("SERP device context for Reddit discovery."),
+  proxyMode: McpScraperProxyModeSchema.default("location").describe("MCP Scraper proxy mode for Reddit discovery. Use location by default so MCP Scraper owns CAPTCHA/proxy retries."),
+  proxyZip: import_zod.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting."),
+  debug: import_zod.z.boolean().default(false).describe("Include sanitized MCP Scraper retry/proxy diagnostics for Reddit discovery."),
   maxPosts: import_zod.z.number().int().min(1).max(10).default(5).describe("Maximum Reddit posts to read with MCP Scraper browser-agent."),
   readWithBrowserAgent: import_zod.z.boolean().default(true).describe("Keep true. Reads Reddit candidates through MCP Scraper browser-agent."),
   profile: import_zod.z.string().min(1).max(128).optional().describe("Optional MCP Scraper browser-agent saved profile name.")
@@ -121,7 +134,7 @@ var ThorbitOnPageGetAnalysisInputSchema = {
 };
 
 // src/content-onpage-mcp-server.ts
-var VERSION = "0.1.0";
+var VERSION = "0.1.2";
 function readOnlyAnnotations(title, openWorldHint = true) {
   return {
     title,
@@ -170,13 +183,13 @@ function buildThorbitContentOnPageMcpServer(client) {
   });
   registerTool("thorbit_content_harvest_serp", {
     title: "Harvest SERP And PAA Evidence",
-    description: "Harvest Google SERP/PAA evidence through MCP Scraper only. Returns PAA questions, organic results, forums, videos, AI Overview fields when available, and provider stats for source-backed content strategy.",
+    description: "Harvest Google SERP/PAA evidence through MCP Scraper only. Returns the full evidence surface from MCP Scraper: PAA flat questions, PAA tree, organic SERP, local pack, videos/shorts, forums, whatPeopleSaying, AI Overview text/citations/sections, AI Mode, entity IDs, stats, diagnostics, and retry attempts. Split topic from location when possible. Keep proxyMode as location for US city/state SERPs so MCP Scraper rotates fresh residential proxy IDs and browser sessions across retryable CAPTCHA, proxy tunnel, proxy availability, and location-mismatch failures. Pass proxyZip for known city-center ZIP targeting and debug true when retry/proxy diagnostics are needed.",
     inputSchema: ThorbitContentHarvestSerpInputSchema,
     annotations: readOnlyAnnotations("Harvest SERP And PAA Evidence")
   });
   registerTool("thorbit_content_reddit_research", {
     title: "Research Reddit With MCP Scraper Browser Agent",
-    description: "Find Reddit candidates through MCP Scraper SERP harvest, then read selected posts through MCP Scraper browser-agent by default. Use for authentic audience language, objections, pain points, and questions. Do not use generic web scraping fallbacks for Reddit.",
+    description: "Find Reddit candidates through MCP Scraper SERP harvest, then read selected posts through MCP Scraper browser-agent by default. Use for authentic audience language, objections, pain points, and questions. Keep proxyMode as location and pass location/proxyZip when the Reddit research has a local market. Do not use generic web scraping fallbacks for Reddit.",
     inputSchema: ThorbitContentRedditResearchInputSchema,
     annotations: readOnlyAnnotations("Research Reddit With Browser Agent")
   });

package/dist/bin/thorbit-content-mcp.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../bin/thorbit-content-mcp.ts","../../src/content-onpage-api-client.ts","../../src/content-onpage-mcp-env.ts","../../src/content-onpage-mcp-server.ts","../../src/content-onpage-mcp-response-formatters.ts","../../src/content-onpage-mcp-tool-schemas.ts"],"sourcesContent":["import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { ThorbitContentOnPageApiClient } from '../src/content-onpage-api-client.js'\nimport { resolveThorbitContentOnPageMcpEnv } from '../src/content-onpage-mcp-env.js'\nimport { buildThorbitContentOnPageMcpServer } from '../src/content-onpage-mcp-server.js'\n\nasync function main() {\n  const env = resolveThorbitContentOnPageMcpEnv()\n  const client = new ThorbitContentOnPageApiClient(env)\n  const server = buildThorbitContentOnPageMcpServer(client)\n  await server.connect(new StdioServerTransport())\n}\n\nmain().catch(error => {\n  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`)\n  process.exit(1)\n})\n","import type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nexport type ThorbitContentOnPageMcpEnvelope =\n  | {\n      ok: true\n      result: unknown\n      warnings?: string[]\n      requestId: string\n      usage?: Record<string, unknown>\n    }\n  | {\n      ok: false\n      error: {\n        code: string\n        message: string\n        details?: unknown\n      }\n      requestId: string\n    }\n\nexport class ThorbitContentOnPageApiClient {\n  private readonly baseUrl: string\n  private readonly apiKey: string\n\n  constructor(options: { baseUrl: string; apiKey: string }) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '')\n    this.apiKey = options.apiKey\n  }\n\n  async callTool(toolName: ThorbitContentOnPageMcpToolName, input: unknown): Promise<ThorbitContentOnPageMcpEnvelope> {\n    const response = await fetch(`${this.baseUrl}/api/v1/mcp/content-onpage/${toolName}`, {\n      method: 'POST',\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(input ?? {}),\n    })\n\n    const body = await response.json().catch(() => null) as ThorbitContentOnPageMcpEnvelope | null\n    if (body && typeof body === 'object' && 'ok' in body) return body\n\n    return {\n      ok: false,\n      requestId: 'unavailable',\n      error: {\n        code: response.ok ? 'invalid_response' : `http_${response.status}`,\n        message: response.ok ? 'Thorbit returned an invalid MCP response' : `Thorbit API request failed with HTTP ${response.status}`,\n      },\n    }\n  }\n}\n","import { readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\nexport type ThorbitContentOnPageMcpEnv = {\n  apiKey: string\n  baseUrl: string\n}\n\nfunction readApiKeyFile(): string | undefined {\n  const explicitPath = process.env.THORBIT_CONTENT_MCP_KEY_PATH?.trim()\n  const paths = [explicitPath, join(homedir(), '.thorbit-content-mcp-key')].filter(Boolean) as string[]\n  for (const path of paths) {\n    try {\n      const value = readFileSync(path, 'utf8').trim()\n      if (value) return value\n    } catch {\n      continue\n    }\n  }\n  return undefined\n}\n\nexport function resolveThorbitContentOnPageMcpEnv(): ThorbitContentOnPageMcpEnv {\n  const apiKey = (\n    process.env.THORBIT_API_KEY ||\n    process.env.THORBIT_MCP_API_KEY ||\n    process.env.THORBIT_CONTENT_MCP_API_KEY ||\n    readApiKeyFile()\n  )?.trim()\n\n  if (!apiKey) {\n    throw new Error('THORBIT_API_KEY, THORBIT_MCP_API_KEY, or ~/.thorbit-content-mcp-key is required')\n  }\n\n  return {\n    apiKey,\n    baseUrl: (process.env.THORBIT_BASE_URL || process.env.THORBIT_CONTENT_MCP_BASE_URL || 'https://thorbit.ai').trim(),\n  }\n}\n","import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js'\nimport type { ZodRawShape } from 'zod'\nimport type { ThorbitContentOnPageApiClient } from './content-onpage-api-client.js'\nimport { formatThorbitContentOnPageMcpToolResult } from './content-onpage-mcp-response-formatters.js'\nimport {\n  ThorbitContentExtractUrlInputSchema,\n  ThorbitContentHarvestSerpInputSchema,\n  ThorbitContentRedditResearchInputSchema,\n  ThorbitOnPageGetAnalysisInputSchema,\n  ThorbitOnPageStartAnalysisInputSchema,\n} from './content-onpage-mcp-tool-schemas.js'\nimport type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nconst VERSION = '0.1.0'\n\ntype ThorbitContentOnPageToolConfig<InputArgs extends ZodRawShape> = {\n  title: string\n  description: string\n  inputSchema: InputArgs\n  annotations: ToolAnnotations\n}\n\nfunction readOnlyAnnotations(title: string, openWorldHint = true) {\n  return {\n    title,\n    readOnlyHint: true,\n    destructiveHint: false,\n    idempotentHint: true,\n    openWorldHint,\n  }\n}\n\nfunction writeAnnotations(title: string, openWorldHint = false) {\n  return {\n    title,\n    readOnlyHint: false,\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint,\n  }\n}\n\nexport function buildThorbitContentOnPageMcpServer(client: ThorbitContentOnPageApiClient): McpServer {\n  const server = new McpServer({ name: 'thorbit-content-mcp', version: VERSION })\n\n  server.registerResource(\n    'analysis',\n    new ResourceTemplate('thorbit-content://analyses/{analysisPublicId}', { list: undefined }),\n    {\n      title: 'Thorbit On-Page Analysis',\n      description: 'Status, score, signal counts, and summary for one Thorbit on-page analysis.',\n      mimeType: 'application/json',\n    },\n    async (uri, variables) => {\n      const analysisPublicId = Array.isArray(variables.analysisPublicId)\n        ? variables.analysisPublicId[0]\n        : variables.analysisPublicId\n      const envelope = await client.callTool('thorbit_onpage_get_analysis', { analysisPublicId: String(analysisPublicId) })\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  function registerTool<T extends ThorbitContentOnPageMcpToolName>(\n    toolName: T,\n    config: ThorbitContentOnPageToolConfig<ZodRawShape>,\n  ): void {\n    server.registerTool(toolName, config, async (input) => {\n      const envelope = await client.callTool(toolName, input)\n      return formatThorbitContentOnPageMcpToolResult(toolName, envelope)\n    })\n  }\n\n  registerTool('thorbit_content_extract_url', {\n    title: 'Extract URL For Content Analysis',\n    description: 'Extract a public URL through MCP Scraper only. Use this before content audits, source ingestion, outline planning, or on-page comparisons. Browser fallback is enabled by default for JS-heavy pages.',\n    inputSchema: ThorbitContentExtractUrlInputSchema,\n    annotations: readOnlyAnnotations('Extract URL For Content Analysis'),\n  })\n\n  registerTool('thorbit_content_harvest_serp', {\n    title: 'Harvest SERP And PAA Evidence',\n    description: 'Harvest Google SERP/PAA evidence through MCP Scraper only. Returns PAA questions, organic results, forums, videos, AI Overview fields when available, and provider stats for source-backed content strategy.',\n    inputSchema: ThorbitContentHarvestSerpInputSchema,\n    annotations: readOnlyAnnotations('Harvest SERP And PAA Evidence'),\n  })\n\n  registerTool('thorbit_content_reddit_research', {\n    title: 'Research Reddit With MCP Scraper Browser Agent',\n    description: 'Find Reddit candidates through MCP Scraper SERP harvest, then read selected posts through MCP Scraper browser-agent by default. Use for authentic audience language, objections, pain points, and questions. Do not use generic web scraping fallbacks for Reddit.',\n    inputSchema: ThorbitContentRedditResearchInputSchema,\n    annotations: readOnlyAnnotations('Research Reddit With Browser Agent'),\n  })\n\n  registerTool('thorbit_onpage_start_analysis', {\n    title: 'Start Thorbit On-Page Analysis',\n    description: 'Start a Thorbit on-page analysis for a project keyword. Can run keyword-only analysis or score provided inline content. Hosted Thorbit dispatches the durable analysis workflow and meters usage against the MCP API key.',\n    inputSchema: ThorbitOnPageStartAnalysisInputSchema,\n    annotations: writeAnnotations('Start Thorbit On-Page Analysis'),\n  })\n\n  registerTool('thorbit_onpage_get_analysis', {\n    title: 'Read Thorbit On-Page Analysis',\n    description: 'Read persisted on-page analysis status, score, signal counts, and content report summary by analysis public ID. Use after thorbit_onpage_start_analysis to poll durable results.',\n    inputSchema: ThorbitOnPageGetAnalysisInputSchema,\n    annotations: readOnlyAnnotations('Read Thorbit On-Page Analysis', false),\n  })\n\n  return server\n}\n","import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js'\nimport type { ThorbitContentOnPageMcpEnvelope } from './content-onpage-api-client.js'\nimport type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nexport function formatThorbitContentOnPageMcpToolResult(\n  toolName: ThorbitContentOnPageMcpToolName,\n  envelope: ThorbitContentOnPageMcpEnvelope,\n): CallToolResult {\n  const text = JSON.stringify({\n    toolName,\n    ...envelope,\n  }, null, 2)\n  return {\n    content: [{ type: 'text', text }],\n    isError: !envelope.ok,\n  }\n}\n","import { z } from 'zod'\n\nexport const ThorbitContentExtractUrlInputSchema = {\n  url: z.string().url().describe('Public URL to extract through MCP Scraper.'),\n  browserFallback: z.boolean().default(true).describe('Use MCP Scraper browser fallback for JS-heavy pages. Default true.'),\n  extractBranding: z.boolean().default(false).describe('Ask MCP Scraper to extract brand colors, fonts, logo, and favicon when supported.'),\n  downloadMedia: z.boolean().default(false).describe('Ask MCP Scraper to download page media when supported.'),\n  maxCharacters: z.number().int().min(500).max(500000).default(80000).describe('Maximum extracted content characters returned to the MCP caller.'),\n}\n\nexport const ThorbitContentHarvestSerpInputSchema = {\n  query: z.string().min(1).max(400).describe('Search query for MCP Scraper SERP/PAA harvest.'),\n  location: z.string().min(1).max(160).optional().describe('Optional search location, such as Denver, Colorado, United States.'),\n  gl: z.string().length(2).optional().describe('Optional Google country code, such as us.'),\n  hl: z.string().min(2).max(12).optional().describe('Optional Google interface language, such as en.'),\n  maxQuestions: z.number().int().min(1).max(150).default(30).describe('Maximum PAA questions when serpOnly is false.'),\n  includeSerp: z.boolean().default(true).describe('Include organic SERP results. Default true.'),\n  serpOnly: z.boolean().default(false).describe('Use fast SERP-only mode when PAA expansion is not needed.'),\n}\n\nexport const ThorbitContentRedditResearchInputSchema = {\n  query: z.string().min(1).max(400).describe('Topic, product, service, or pain point to research on Reddit.'),\n  location: z.string().min(1).max(160).optional().describe('Optional location to bias MCP Scraper SERP discovery.'),\n  maxPosts: z.number().int().min(1).max(10).default(5).describe('Maximum Reddit posts to read with MCP Scraper browser-agent.'),\n  readWithBrowserAgent: z.boolean().default(true).describe('Keep true. Reads Reddit candidates through MCP Scraper browser-agent.'),\n  profile: z.string().min(1).max(128).optional().describe('Optional MCP Scraper browser-agent saved profile name.'),\n}\n\nexport const ThorbitOnPageStartAnalysisInputSchema = {\n  projectPublicId: z.string().min(1).describe('Thorbit project public ID.'),\n  keyword: z.string().min(1).max(200).describe('Target keyword or query for on-page analysis.'),\n  force: z.boolean().default(false).describe('Force restart if an analysis is already running.'),\n  source: z.discriminatedUnion('mode', [\n    z.object({ mode: z.literal('keyword_only') }).strict(),\n    z.object({\n      mode: z.literal('inline_content'),\n      title: z.string().min(1).max(255).optional(),\n      text: z.string().min(20).max(500000),\n      sourceUrl: z.string().url().optional(),\n    }).strict(),\n  ]).default({ mode: 'keyword_only' }).describe('Use keyword_only for research-only analysis or inline_content to score provided content.'),\n}\n\nexport const ThorbitOnPageGetAnalysisInputSchema = {\n  analysisPublicId: z.string().min(1).describe('On-page analysis public ID returned by thorbit_onpage_start_analysis.'),\n}\n\nexport const ThorbitContentOnPageMcpToolInputSchemas = {\n  thorbit_content_extract_url: ThorbitContentExtractUrlInputSchema,\n  thorbit_content_harvest_serp: ThorbitContentHarvestSerpInputSchema,\n  thorbit_content_reddit_research: ThorbitContentRedditResearchInputSchema,\n  thorbit_onpage_start_analysis: ThorbitOnPageStartAnalysisInputSchema,\n  thorbit_onpage_get_analysis: ThorbitOnPageGetAnalysisInputSchema,\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../bin/thorbit-content-mcp.ts","../../src/content-onpage-api-client.ts","../../src/content-onpage-mcp-env.ts","../../src/content-onpage-mcp-server.ts","../../src/content-onpage-mcp-response-formatters.ts","../../src/content-onpage-mcp-tool-schemas.ts"],"sourcesContent":["import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { ThorbitContentOnPageApiClient } from '../src/content-onpage-api-client.js'\nimport { resolveThorbitContentOnPageMcpEnv } from '../src/content-onpage-mcp-env.js'\nimport { buildThorbitContentOnPageMcpServer } from '../src/content-onpage-mcp-server.js'\n\nasync function main() {\n  const env = resolveThorbitContentOnPageMcpEnv()\n  const client = new ThorbitContentOnPageApiClient(env)\n  const server = buildThorbitContentOnPageMcpServer(client)\n  await server.connect(new StdioServerTransport())\n}\n\nmain().catch(error => {\n  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`)\n  process.exit(1)\n})\n","import type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nexport type ThorbitContentOnPageMcpEnvelope =\n  | {\n      ok: true\n      result: unknown\n      warnings?: string[]\n      requestId: string\n      usage?: Record<string, unknown>\n    }\n  | {\n      ok: false\n      error: {\n        code: string\n        message: string\n        details?: unknown\n      }\n      requestId: string\n    }\n\nexport class ThorbitContentOnPageApiClient {\n  private readonly baseUrl: string\n  private readonly apiKey: string\n\n  constructor(options: { baseUrl: string; apiKey: string }) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '')\n    this.apiKey = options.apiKey\n  }\n\n  async callTool(toolName: ThorbitContentOnPageMcpToolName, input: unknown): Promise<ThorbitContentOnPageMcpEnvelope> {\n    const response = await fetch(`${this.baseUrl}/api/v1/mcp/content-onpage/${toolName}`, {\n      method: 'POST',\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(input ?? {}),\n    })\n\n    const body = await response.json().catch(() => null) as ThorbitContentOnPageMcpEnvelope | null\n    if (body && typeof body === 'object' && 'ok' in body) return body\n\n    return {\n      ok: false,\n      requestId: 'unavailable',\n      error: {\n        code: response.ok ? 'invalid_response' : `http_${response.status}`,\n        message: response.ok ? 'Thorbit returned an invalid MCP response' : `Thorbit API request failed with HTTP ${response.status}`,\n      },\n    }\n  }\n}\n","import { readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\nexport type ThorbitContentOnPageMcpEnv = {\n  apiKey: string\n  baseUrl: string\n}\n\nfunction readApiKeyFile(): string | undefined {\n  const explicitPath = process.env.THORBIT_CONTENT_MCP_KEY_PATH?.trim()\n  const paths = [explicitPath, join(homedir(), '.thorbit-content-mcp-key')].filter(Boolean) as string[]\n  for (const path of paths) {\n    try {\n      const value = readFileSync(path, 'utf8').trim()\n      if (value) return value\n    } catch {\n      continue\n    }\n  }\n  return undefined\n}\n\nexport function resolveThorbitContentOnPageMcpEnv(): ThorbitContentOnPageMcpEnv {\n  const apiKey = (\n    process.env.THORBIT_API_KEY ||\n    process.env.THORBIT_MCP_API_KEY ||\n    process.env.THORBIT_CONTENT_MCP_API_KEY ||\n    readApiKeyFile()\n  )?.trim()\n\n  if (!apiKey) {\n    throw new Error('THORBIT_API_KEY, THORBIT_MCP_API_KEY, or ~/.thorbit-content-mcp-key is required')\n  }\n\n  return {\n    apiKey,\n    baseUrl: (process.env.THORBIT_BASE_URL || process.env.THORBIT_CONTENT_MCP_BASE_URL || 'https://thorbit.ai').trim(),\n  }\n}\n","import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js'\nimport type { ZodRawShape } from 'zod'\nimport type { ThorbitContentOnPageApiClient } from './content-onpage-api-client.js'\nimport { formatThorbitContentOnPageMcpToolResult } from './content-onpage-mcp-response-formatters.js'\nimport {\n  ThorbitContentExtractUrlInputSchema,\n  ThorbitContentHarvestSerpInputSchema,\n  ThorbitContentRedditResearchInputSchema,\n  ThorbitOnPageGetAnalysisInputSchema,\n  ThorbitOnPageStartAnalysisInputSchema,\n} from './content-onpage-mcp-tool-schemas.js'\nimport type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nconst VERSION = '0.1.2'\n\ntype ThorbitContentOnPageToolConfig<InputArgs extends ZodRawShape> = {\n  title: string\n  description: string\n  inputSchema: InputArgs\n  annotations: ToolAnnotations\n}\n\nfunction readOnlyAnnotations(title: string, openWorldHint = true) {\n  return {\n    title,\n    readOnlyHint: true,\n    destructiveHint: false,\n    idempotentHint: true,\n    openWorldHint,\n  }\n}\n\nfunction writeAnnotations(title: string, openWorldHint = false) {\n  return {\n    title,\n    readOnlyHint: false,\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint,\n  }\n}\n\nexport function buildThorbitContentOnPageMcpServer(client: ThorbitContentOnPageApiClient): McpServer {\n  const server = new McpServer({ name: 'thorbit-content-mcp', version: VERSION })\n\n  server.registerResource(\n    'analysis',\n    new ResourceTemplate('thorbit-content://analyses/{analysisPublicId}', { list: undefined }),\n    {\n      title: 'Thorbit On-Page Analysis',\n      description: 'Status, score, signal counts, and summary for one Thorbit on-page analysis.',\n      mimeType: 'application/json',\n    },\n    async (uri, variables) => {\n      const analysisPublicId = Array.isArray(variables.analysisPublicId)\n        ? variables.analysisPublicId[0]\n        : variables.analysisPublicId\n      const envelope = await client.callTool('thorbit_onpage_get_analysis', { analysisPublicId: String(analysisPublicId) })\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  function registerTool<T extends ThorbitContentOnPageMcpToolName>(\n    toolName: T,\n    config: ThorbitContentOnPageToolConfig<ZodRawShape>,\n  ): void {\n    server.registerTool(toolName, config, async (input) => {\n      const envelope = await client.callTool(toolName, input)\n      return formatThorbitContentOnPageMcpToolResult(toolName, envelope)\n    })\n  }\n\n  registerTool('thorbit_content_extract_url', {\n    title: 'Extract URL For Content Analysis',\n    description: 'Extract a public URL through MCP Scraper only. Use this before content audits, source ingestion, outline planning, or on-page comparisons. Browser fallback is enabled by default for JS-heavy pages.',\n    inputSchema: ThorbitContentExtractUrlInputSchema,\n    annotations: readOnlyAnnotations('Extract URL For Content Analysis'),\n  })\n\n  registerTool('thorbit_content_harvest_serp', {\n    title: 'Harvest SERP And PAA Evidence',\n    description: 'Harvest Google SERP/PAA evidence through MCP Scraper only. Returns the full evidence surface from MCP Scraper: PAA flat questions, PAA tree, organic SERP, local pack, videos/shorts, forums, whatPeopleSaying, AI Overview text/citations/sections, AI Mode, entity IDs, stats, diagnostics, and retry attempts. Split topic from location when possible. Keep proxyMode as location for US city/state SERPs so MCP Scraper rotates fresh residential proxy IDs and browser sessions across retryable CAPTCHA, proxy tunnel, proxy availability, and location-mismatch failures. Pass proxyZip for known city-center ZIP targeting and debug true when retry/proxy diagnostics are needed.',\n    inputSchema: ThorbitContentHarvestSerpInputSchema,\n    annotations: readOnlyAnnotations('Harvest SERP And PAA Evidence'),\n  })\n\n  registerTool('thorbit_content_reddit_research', {\n    title: 'Research Reddit With MCP Scraper Browser Agent',\n    description: 'Find Reddit candidates through MCP Scraper SERP harvest, then read selected posts through MCP Scraper browser-agent by default. Use for authentic audience language, objections, pain points, and questions. Keep proxyMode as location and pass location/proxyZip when the Reddit research has a local market. Do not use generic web scraping fallbacks for Reddit.',\n    inputSchema: ThorbitContentRedditResearchInputSchema,\n    annotations: readOnlyAnnotations('Research Reddit With Browser Agent'),\n  })\n\n  registerTool('thorbit_onpage_start_analysis', {\n    title: 'Start Thorbit On-Page Analysis',\n    description: 'Start a Thorbit on-page analysis for a project keyword. Can run keyword-only analysis or score provided inline content. Hosted Thorbit dispatches the durable analysis workflow and meters usage against the MCP API key.',\n    inputSchema: ThorbitOnPageStartAnalysisInputSchema,\n    annotations: writeAnnotations('Start Thorbit On-Page Analysis'),\n  })\n\n  registerTool('thorbit_onpage_get_analysis', {\n    title: 'Read Thorbit On-Page Analysis',\n    description: 'Read persisted on-page analysis status, score, signal counts, and content report summary by analysis public ID. Use after thorbit_onpage_start_analysis to poll durable results.',\n    inputSchema: ThorbitOnPageGetAnalysisInputSchema,\n    annotations: readOnlyAnnotations('Read Thorbit On-Page Analysis', false),\n  })\n\n  return server\n}\n","import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js'\nimport type { ThorbitContentOnPageMcpEnvelope } from './content-onpage-api-client.js'\nimport type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nexport function formatThorbitContentOnPageMcpToolResult(\n  toolName: ThorbitContentOnPageMcpToolName,\n  envelope: ThorbitContentOnPageMcpEnvelope,\n): CallToolResult {\n  const text = JSON.stringify({\n    toolName,\n    ...envelope,\n  }, null, 2)\n  return {\n    content: [{ type: 'text', text }],\n    isError: !envelope.ok,\n  }\n}\n","import { z } from 'zod'\n\nexport const ThorbitContentExtractUrlInputSchema = {\n  url: z.string().url().describe('Public URL to extract through MCP Scraper.'),\n  browserFallback: z.boolean().default(true).describe('Use MCP Scraper browser fallback for JS-heavy pages. Default true.'),\n  extractBranding: z.boolean().default(false).describe('Ask MCP Scraper to extract brand colors, fonts, logo, and favicon when supported.'),\n  downloadMedia: z.boolean().default(false).describe('Ask MCP Scraper to download page media when supported.'),\n  maxCharacters: z.number().int().min(500).max(500000).default(80000).describe('Maximum extracted content characters returned to the MCP caller.'),\n}\n\nconst McpScraperProxyModeSchema = z.enum(['location', 'configured', 'none'])\nconst McpScraperSerpDeviceSchema = z.enum(['desktop', 'mobile'])\n\nexport const ThorbitContentHarvestSerpInputSchema = {\n  query: z.string().min(1).max(400).describe('Core search topic. Separate location when possible, e.g. query=\"best CRM\" and location=\"Denver, CO\".'),\n  location: z.string().min(1).max(160).optional().describe('Optional search location, such as Denver, CO. Required for precise residential proxy targeting.'),\n  gl: z.string().length(2).optional().describe('Optional Google country code, such as us.'),\n  hl: z.string().min(2).max(12).optional().describe('Optional Google interface language, such as en.'),\n  device: McpScraperSerpDeviceSchema.default('desktop').describe('SERP device context. Use desktop by default; use mobile only when requested.'),\n  maxQuestions: z.number().int().min(1).max(200).default(30).describe('Maximum PAA questions when serpOnly is false.'),\n  includeSerp: z.boolean().default(true).describe('Include organic SERP results. Default true.'),\n  serpOnly: z.boolean().default(false).describe('Use fast SERP-only mode when PAA expansion is not needed.'),\n  proxyMode: McpScraperProxyModeSchema.default('location').describe('MCP Scraper proxy mode. Use location by default for US city/state SERPs so MCP Scraper rotates fresh residential proxy IDs and browser sessions across retryable CAPTCHA/proxy/location failures.'),\n  proxyZip: z.string().regex(/^\\d{5}$/).optional().describe('Optional US ZIP override for residential location proxy targeting. Use when a specific ZIP or city-center ZIP is known.'),\n  debug: z.boolean().default(false).describe('Include sanitized MCP Scraper browser/proxy/location diagnostics and attempt telemetry. Use true when debugging CAPTCHA, proxy selection, or localization.'),\n  pages: z.number().int().min(1).max(2).default(1).describe('Number of Google result pages to fetch in SERP-only mode.'),\n}\n\nexport const ThorbitContentRedditResearchInputSchema = {\n  query: z.string().min(1).max(400).describe('Topic, product, service, or pain point to research on Reddit.'),\n  location: z.string().min(1).max(160).optional().describe('Optional location to bias MCP Scraper SERP discovery and residential proxy targeting.'),\n  gl: z.string().length(2).optional().describe('Optional Google country code, such as us.'),\n  hl: z.string().min(2).max(12).optional().describe('Optional Google interface language, such as en.'),\n  device: McpScraperSerpDeviceSchema.default('desktop').describe('SERP device context for Reddit discovery.'),\n  proxyMode: McpScraperProxyModeSchema.default('location').describe('MCP Scraper proxy mode for Reddit discovery. Use location by default so MCP Scraper owns CAPTCHA/proxy retries.'),\n  proxyZip: z.string().regex(/^\\d{5}$/).optional().describe('Optional US ZIP override for residential location proxy targeting.'),\n  debug: z.boolean().default(false).describe('Include sanitized MCP Scraper retry/proxy diagnostics for Reddit discovery.'),\n  maxPosts: z.number().int().min(1).max(10).default(5).describe('Maximum Reddit posts to read with MCP Scraper browser-agent.'),\n  readWithBrowserAgent: z.boolean().default(true).describe('Keep true. Reads Reddit candidates through MCP Scraper browser-agent.'),\n  profile: z.string().min(1).max(128).optional().describe('Optional MCP Scraper browser-agent saved profile name.'),\n}\n\nexport const ThorbitOnPageStartAnalysisInputSchema = {\n  projectPublicId: z.string().min(1).describe('Thorbit project public ID.'),\n  keyword: z.string().min(1).max(200).describe('Target keyword or query for on-page analysis.'),\n  force: z.boolean().default(false).describe('Force restart if an analysis is already running.'),\n  source: z.discriminatedUnion('mode', [\n    z.object({ mode: z.literal('keyword_only') }).strict(),\n    z.object({\n      mode: z.literal('inline_content'),\n      title: z.string().min(1).max(255).optional(),\n      text: z.string().min(20).max(500000),\n      sourceUrl: z.string().url().optional(),\n    }).strict(),\n  ]).default({ mode: 'keyword_only' }).describe('Use keyword_only for research-only analysis or inline_content to score provided content.'),\n}\n\nexport const ThorbitOnPageGetAnalysisInputSchema = {\n  analysisPublicId: z.string().min(1).describe('On-page analysis public ID returned by thorbit_onpage_start_analysis.'),\n}\n\nexport const ThorbitContentOnPageMcpToolInputSchemas = {\n  thorbit_content_extract_url: ThorbitContentExtractUrlInputSchema,\n  thorbit_content_harvest_serp: ThorbitContentHarvestSerpInputSchema,\n  thorbit_content_reddit_research: ThorbitContentRedditResearchInputSchema,\n  thorbit_onpage_start_analysis: ThorbitOnPageStartAnalysisInputSchema,\n  thorbit_onpage_get_analysis: ThorbitOnPageGetAnalysisInputSchema,\n}\n"],"mappings":"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","names":[]}

package/dist/bin/thorbit-content-mcp.js

@@ -85,18 +85,31 @@ var ThorbitContentExtractUrlInputSchema = {
   downloadMedia: z.boolean().default(false).describe("Ask MCP Scraper to download page media when supported."),
   maxCharacters: z.number().int().min(500).max(5e5).default(8e4).describe("Maximum extracted content characters returned to the MCP caller.")
 };
+var McpScraperProxyModeSchema = z.enum(["location", "configured", "none"]);
+var McpScraperSerpDeviceSchema = z.enum(["desktop", "mobile"]);
 var ThorbitContentHarvestSerpInputSchema = {
-  query: z.string().min(1).max(400).describe("Search query for MCP Scraper SERP/PAA harvest."),
-  location: z.string().min(1).max(160).optional().describe("Optional search location, such as Denver, Colorado, United States."),
+  query: z.string().min(1).max(400).describe('Core search topic. Separate location when possible, e.g. query="best CRM" and location="Denver, CO".'),
+  location: z.string().min(1).max(160).optional().describe("Optional search location, such as Denver, CO. Required for precise residential proxy targeting."),
   gl: z.string().length(2).optional().describe("Optional Google country code, such as us."),
   hl: z.string().min(2).max(12).optional().describe("Optional Google interface language, such as en."),
-  maxQuestions: z.number().int().min(1).max(150).default(30).describe("Maximum PAA questions when serpOnly is false."),
+  device: McpScraperSerpDeviceSchema.default("desktop").describe("SERP device context. Use desktop by default; use mobile only when requested."),
+  maxQuestions: z.number().int().min(1).max(200).default(30).describe("Maximum PAA questions when serpOnly is false."),
   includeSerp: z.boolean().default(true).describe("Include organic SERP results. Default true."),
-  serpOnly: z.boolean().default(false).describe("Use fast SERP-only mode when PAA expansion is not needed.")
+  serpOnly: z.boolean().default(false).describe("Use fast SERP-only mode when PAA expansion is not needed."),
+  proxyMode: McpScraperProxyModeSchema.default("location").describe("MCP Scraper proxy mode. Use location by default for US city/state SERPs so MCP Scraper rotates fresh residential proxy IDs and browser sessions across retryable CAPTCHA/proxy/location failures."),
+  proxyZip: z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting. Use when a specific ZIP or city-center ZIP is known."),
+  debug: z.boolean().default(false).describe("Include sanitized MCP Scraper browser/proxy/location diagnostics and attempt telemetry. Use true when debugging CAPTCHA, proxy selection, or localization."),
+  pages: z.number().int().min(1).max(2).default(1).describe("Number of Google result pages to fetch in SERP-only mode.")
 };
 var ThorbitContentRedditResearchInputSchema = {
   query: z.string().min(1).max(400).describe("Topic, product, service, or pain point to research on Reddit."),
-  location: z.string().min(1).max(160).optional().describe("Optional location to bias MCP Scraper SERP discovery."),
+  location: z.string().min(1).max(160).optional().describe("Optional location to bias MCP Scraper SERP discovery and residential proxy targeting."),
+  gl: z.string().length(2).optional().describe("Optional Google country code, such as us."),
+  hl: z.string().min(2).max(12).optional().describe("Optional Google interface language, such as en."),
+  device: McpScraperSerpDeviceSchema.default("desktop").describe("SERP device context for Reddit discovery."),
+  proxyMode: McpScraperProxyModeSchema.default("location").describe("MCP Scraper proxy mode for Reddit discovery. Use location by default so MCP Scraper owns CAPTCHA/proxy retries."),
+  proxyZip: z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting."),
+  debug: z.boolean().default(false).describe("Include sanitized MCP Scraper retry/proxy diagnostics for Reddit discovery."),
   maxPosts: z.number().int().min(1).max(10).default(5).describe("Maximum Reddit posts to read with MCP Scraper browser-agent."),
   readWithBrowserAgent: z.boolean().default(true).describe("Keep true. Reads Reddit candidates through MCP Scraper browser-agent."),
   profile: z.string().min(1).max(128).optional().describe("Optional MCP Scraper browser-agent saved profile name.")
@@ -120,7 +133,7 @@ var ThorbitOnPageGetAnalysisInputSchema = {
 };
 
 // src/content-onpage-mcp-server.ts
-var VERSION = "0.1.0";
+var VERSION = "0.1.2";
 function readOnlyAnnotations(title, openWorldHint = true) {
   return {
     title,
@@ -169,13 +182,13 @@ function buildThorbitContentOnPageMcpServer(client) {
   });
   registerTool("thorbit_content_harvest_serp", {
     title: "Harvest SERP And PAA Evidence",
-    description: "Harvest Google SERP/PAA evidence through MCP Scraper only. Returns PAA questions, organic results, forums, videos, AI Overview fields when available, and provider stats for source-backed content strategy.",
+    description: "Harvest Google SERP/PAA evidence through MCP Scraper only. Returns the full evidence surface from MCP Scraper: PAA flat questions, PAA tree, organic SERP, local pack, videos/shorts, forums, whatPeopleSaying, AI Overview text/citations/sections, AI Mode, entity IDs, stats, diagnostics, and retry attempts. Split topic from location when possible. Keep proxyMode as location for US city/state SERPs so MCP Scraper rotates fresh residential proxy IDs and browser sessions across retryable CAPTCHA, proxy tunnel, proxy availability, and location-mismatch failures. Pass proxyZip for known city-center ZIP targeting and debug true when retry/proxy diagnostics are needed.",
     inputSchema: ThorbitContentHarvestSerpInputSchema,
     annotations: readOnlyAnnotations("Harvest SERP And PAA Evidence")
   });
   registerTool("thorbit_content_reddit_research", {
     title: "Research Reddit With MCP Scraper Browser Agent",
-    description: "Find Reddit candidates through MCP Scraper SERP harvest, then read selected posts through MCP Scraper browser-agent by default. Use for authentic audience language, objections, pain points, and questions. Do not use generic web scraping fallbacks for Reddit.",
+    description: "Find Reddit candidates through MCP Scraper SERP harvest, then read selected posts through MCP Scraper browser-agent by default. Use for authentic audience language, objections, pain points, and questions. Keep proxyMode as location and pass location/proxyZip when the Reddit research has a local market. Do not use generic web scraping fallbacks for Reddit.",
     inputSchema: ThorbitContentRedditResearchInputSchema,
     annotations: readOnlyAnnotations("Research Reddit With Browser Agent")
   });

package/dist/bin/thorbit-content-mcp.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../bin/thorbit-content-mcp.ts","../../src/content-onpage-api-client.ts","../../src/content-onpage-mcp-env.ts","../../src/content-onpage-mcp-server.ts","../../src/content-onpage-mcp-response-formatters.ts","../../src/content-onpage-mcp-tool-schemas.ts"],"sourcesContent":["import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { ThorbitContentOnPageApiClient } from '../src/content-onpage-api-client.js'\nimport { resolveThorbitContentOnPageMcpEnv } from '../src/content-onpage-mcp-env.js'\nimport { buildThorbitContentOnPageMcpServer } from '../src/content-onpage-mcp-server.js'\n\nasync function main() {\n  const env = resolveThorbitContentOnPageMcpEnv()\n  const client = new ThorbitContentOnPageApiClient(env)\n  const server = buildThorbitContentOnPageMcpServer(client)\n  await server.connect(new StdioServerTransport())\n}\n\nmain().catch(error => {\n  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`)\n  process.exit(1)\n})\n","import type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nexport type ThorbitContentOnPageMcpEnvelope =\n  | {\n      ok: true\n      result: unknown\n      warnings?: string[]\n      requestId: string\n      usage?: Record<string, unknown>\n    }\n  | {\n      ok: false\n      error: {\n        code: string\n        message: string\n        details?: unknown\n      }\n      requestId: string\n    }\n\nexport class ThorbitContentOnPageApiClient {\n  private readonly baseUrl: string\n  private readonly apiKey: string\n\n  constructor(options: { baseUrl: string; apiKey: string }) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '')\n    this.apiKey = options.apiKey\n  }\n\n  async callTool(toolName: ThorbitContentOnPageMcpToolName, input: unknown): Promise<ThorbitContentOnPageMcpEnvelope> {\n    const response = await fetch(`${this.baseUrl}/api/v1/mcp/content-onpage/${toolName}`, {\n      method: 'POST',\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(input ?? {}),\n    })\n\n    const body = await response.json().catch(() => null) as ThorbitContentOnPageMcpEnvelope | null\n    if (body && typeof body === 'object' && 'ok' in body) return body\n\n    return {\n      ok: false,\n      requestId: 'unavailable',\n      error: {\n        code: response.ok ? 'invalid_response' : `http_${response.status}`,\n        message: response.ok ? 'Thorbit returned an invalid MCP response' : `Thorbit API request failed with HTTP ${response.status}`,\n      },\n    }\n  }\n}\n","import { readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\nexport type ThorbitContentOnPageMcpEnv = {\n  apiKey: string\n  baseUrl: string\n}\n\nfunction readApiKeyFile(): string | undefined {\n  const explicitPath = process.env.THORBIT_CONTENT_MCP_KEY_PATH?.trim()\n  const paths = [explicitPath, join(homedir(), '.thorbit-content-mcp-key')].filter(Boolean) as string[]\n  for (const path of paths) {\n    try {\n      const value = readFileSync(path, 'utf8').trim()\n      if (value) return value\n    } catch {\n      continue\n    }\n  }\n  return undefined\n}\n\nexport function resolveThorbitContentOnPageMcpEnv(): ThorbitContentOnPageMcpEnv {\n  const apiKey = (\n    process.env.THORBIT_API_KEY ||\n    process.env.THORBIT_MCP_API_KEY ||\n    process.env.THORBIT_CONTENT_MCP_API_KEY ||\n    readApiKeyFile()\n  )?.trim()\n\n  if (!apiKey) {\n    throw new Error('THORBIT_API_KEY, THORBIT_MCP_API_KEY, or ~/.thorbit-content-mcp-key is required')\n  }\n\n  return {\n    apiKey,\n    baseUrl: (process.env.THORBIT_BASE_URL || process.env.THORBIT_CONTENT_MCP_BASE_URL || 'https://thorbit.ai').trim(),\n  }\n}\n","import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js'\nimport type { ZodRawShape } from 'zod'\nimport type { ThorbitContentOnPageApiClient } from './content-onpage-api-client.js'\nimport { formatThorbitContentOnPageMcpToolResult } from './content-onpage-mcp-response-formatters.js'\nimport {\n  ThorbitContentExtractUrlInputSchema,\n  ThorbitContentHarvestSerpInputSchema,\n  ThorbitContentRedditResearchInputSchema,\n  ThorbitOnPageGetAnalysisInputSchema,\n  ThorbitOnPageStartAnalysisInputSchema,\n} from './content-onpage-mcp-tool-schemas.js'\nimport type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nconst VERSION = '0.1.0'\n\ntype ThorbitContentOnPageToolConfig<InputArgs extends ZodRawShape> = {\n  title: string\n  description: string\n  inputSchema: InputArgs\n  annotations: ToolAnnotations\n}\n\nfunction readOnlyAnnotations(title: string, openWorldHint = true) {\n  return {\n    title,\n    readOnlyHint: true,\n    destructiveHint: false,\n    idempotentHint: true,\n    openWorldHint,\n  }\n}\n\nfunction writeAnnotations(title: string, openWorldHint = false) {\n  return {\n    title,\n    readOnlyHint: false,\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint,\n  }\n}\n\nexport function buildThorbitContentOnPageMcpServer(client: ThorbitContentOnPageApiClient): McpServer {\n  const server = new McpServer({ name: 'thorbit-content-mcp', version: VERSION })\n\n  server.registerResource(\n    'analysis',\n    new ResourceTemplate('thorbit-content://analyses/{analysisPublicId}', { list: undefined }),\n    {\n      title: 'Thorbit On-Page Analysis',\n      description: 'Status, score, signal counts, and summary for one Thorbit on-page analysis.',\n      mimeType: 'application/json',\n    },\n    async (uri, variables) => {\n      const analysisPublicId = Array.isArray(variables.analysisPublicId)\n        ? variables.analysisPublicId[0]\n        : variables.analysisPublicId\n      const envelope = await client.callTool('thorbit_onpage_get_analysis', { analysisPublicId: String(analysisPublicId) })\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  function registerTool<T extends ThorbitContentOnPageMcpToolName>(\n    toolName: T,\n    config: ThorbitContentOnPageToolConfig<ZodRawShape>,\n  ): void {\n    server.registerTool(toolName, config, async (input) => {\n      const envelope = await client.callTool(toolName, input)\n      return formatThorbitContentOnPageMcpToolResult(toolName, envelope)\n    })\n  }\n\n  registerTool('thorbit_content_extract_url', {\n    title: 'Extract URL For Content Analysis',\n    description: 'Extract a public URL through MCP Scraper only. Use this before content audits, source ingestion, outline planning, or on-page comparisons. Browser fallback is enabled by default for JS-heavy pages.',\n    inputSchema: ThorbitContentExtractUrlInputSchema,\n    annotations: readOnlyAnnotations('Extract URL For Content Analysis'),\n  })\n\n  registerTool('thorbit_content_harvest_serp', {\n    title: 'Harvest SERP And PAA Evidence',\n    description: 'Harvest Google SERP/PAA evidence through MCP Scraper only. Returns PAA questions, organic results, forums, videos, AI Overview fields when available, and provider stats for source-backed content strategy.',\n    inputSchema: ThorbitContentHarvestSerpInputSchema,\n    annotations: readOnlyAnnotations('Harvest SERP And PAA Evidence'),\n  })\n\n  registerTool('thorbit_content_reddit_research', {\n    title: 'Research Reddit With MCP Scraper Browser Agent',\n    description: 'Find Reddit candidates through MCP Scraper SERP harvest, then read selected posts through MCP Scraper browser-agent by default. Use for authentic audience language, objections, pain points, and questions. Do not use generic web scraping fallbacks for Reddit.',\n    inputSchema: ThorbitContentRedditResearchInputSchema,\n    annotations: readOnlyAnnotations('Research Reddit With Browser Agent'),\n  })\n\n  registerTool('thorbit_onpage_start_analysis', {\n    title: 'Start Thorbit On-Page Analysis',\n    description: 'Start a Thorbit on-page analysis for a project keyword. Can run keyword-only analysis or score provided inline content. Hosted Thorbit dispatches the durable analysis workflow and meters usage against the MCP API key.',\n    inputSchema: ThorbitOnPageStartAnalysisInputSchema,\n    annotations: writeAnnotations('Start Thorbit On-Page Analysis'),\n  })\n\n  registerTool('thorbit_onpage_get_analysis', {\n    title: 'Read Thorbit On-Page Analysis',\n    description: 'Read persisted on-page analysis status, score, signal counts, and content report summary by analysis public ID. Use after thorbit_onpage_start_analysis to poll durable results.',\n    inputSchema: ThorbitOnPageGetAnalysisInputSchema,\n    annotations: readOnlyAnnotations('Read Thorbit On-Page Analysis', false),\n  })\n\n  return server\n}\n","import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js'\nimport type { ThorbitContentOnPageMcpEnvelope } from './content-onpage-api-client.js'\nimport type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nexport function formatThorbitContentOnPageMcpToolResult(\n  toolName: ThorbitContentOnPageMcpToolName,\n  envelope: ThorbitContentOnPageMcpEnvelope,\n): CallToolResult {\n  const text = JSON.stringify({\n    toolName,\n    ...envelope,\n  }, null, 2)\n  return {\n    content: [{ type: 'text', text }],\n    isError: !envelope.ok,\n  }\n}\n","import { z } from 'zod'\n\nexport const ThorbitContentExtractUrlInputSchema = {\n  url: z.string().url().describe('Public URL to extract through MCP Scraper.'),\n  browserFallback: z.boolean().default(true).describe('Use MCP Scraper browser fallback for JS-heavy pages. Default true.'),\n  extractBranding: z.boolean().default(false).describe('Ask MCP Scraper to extract brand colors, fonts, logo, and favicon when supported.'),\n  downloadMedia: z.boolean().default(false).describe('Ask MCP Scraper to download page media when supported.'),\n  maxCharacters: z.number().int().min(500).max(500000).default(80000).describe('Maximum extracted content characters returned to the MCP caller.'),\n}\n\nexport const ThorbitContentHarvestSerpInputSchema = {\n  query: z.string().min(1).max(400).describe('Search query for MCP Scraper SERP/PAA harvest.'),\n  location: z.string().min(1).max(160).optional().describe('Optional search location, such as Denver, Colorado, United States.'),\n  gl: z.string().length(2).optional().describe('Optional Google country code, such as us.'),\n  hl: z.string().min(2).max(12).optional().describe('Optional Google interface language, such as en.'),\n  maxQuestions: z.number().int().min(1).max(150).default(30).describe('Maximum PAA questions when serpOnly is false.'),\n  includeSerp: z.boolean().default(true).describe('Include organic SERP results. Default true.'),\n  serpOnly: z.boolean().default(false).describe('Use fast SERP-only mode when PAA expansion is not needed.'),\n}\n\nexport const ThorbitContentRedditResearchInputSchema = {\n  query: z.string().min(1).max(400).describe('Topic, product, service, or pain point to research on Reddit.'),\n  location: z.string().min(1).max(160).optional().describe('Optional location to bias MCP Scraper SERP discovery.'),\n  maxPosts: z.number().int().min(1).max(10).default(5).describe('Maximum Reddit posts to read with MCP Scraper browser-agent.'),\n  readWithBrowserAgent: z.boolean().default(true).describe('Keep true. Reads Reddit candidates through MCP Scraper browser-agent.'),\n  profile: z.string().min(1).max(128).optional().describe('Optional MCP Scraper browser-agent saved profile name.'),\n}\n\nexport const ThorbitOnPageStartAnalysisInputSchema = {\n  projectPublicId: z.string().min(1).describe('Thorbit project public ID.'),\n  keyword: z.string().min(1).max(200).describe('Target keyword or query for on-page analysis.'),\n  force: z.boolean().default(false).describe('Force restart if an analysis is already running.'),\n  source: z.discriminatedUnion('mode', [\n    z.object({ mode: z.literal('keyword_only') }).strict(),\n    z.object({\n      mode: z.literal('inline_content'),\n      title: z.string().min(1).max(255).optional(),\n      text: z.string().min(20).max(500000),\n      sourceUrl: z.string().url().optional(),\n    }).strict(),\n  ]).default({ mode: 'keyword_only' }).describe('Use keyword_only for research-only analysis or inline_content to score provided content.'),\n}\n\nexport const ThorbitOnPageGetAnalysisInputSchema = {\n  analysisPublicId: z.string().min(1).describe('On-page analysis public ID returned by thorbit_onpage_start_analysis.'),\n}\n\nexport const ThorbitContentOnPageMcpToolInputSchemas = {\n  thorbit_content_extract_url: ThorbitContentExtractUrlInputSchema,\n  thorbit_content_harvest_serp: ThorbitContentHarvestSerpInputSchema,\n  thorbit_content_reddit_research: ThorbitContentRedditResearchInputSchema,\n  thorbit_onpage_start_analysis: ThorbitOnPageStartAnalysisInputSchema,\n  thorbit_onpage_get_analysis: ThorbitOnPageGetAnalysisInputSchema,\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../bin/thorbit-content-mcp.ts","../../src/content-onpage-api-client.ts","../../src/content-onpage-mcp-env.ts","../../src/content-onpage-mcp-server.ts","../../src/content-onpage-mcp-response-formatters.ts","../../src/content-onpage-mcp-tool-schemas.ts"],"sourcesContent":["import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { ThorbitContentOnPageApiClient } from '../src/content-onpage-api-client.js'\nimport { resolveThorbitContentOnPageMcpEnv } from '../src/content-onpage-mcp-env.js'\nimport { buildThorbitContentOnPageMcpServer } from '../src/content-onpage-mcp-server.js'\n\nasync function main() {\n  const env = resolveThorbitContentOnPageMcpEnv()\n  const client = new ThorbitContentOnPageApiClient(env)\n  const server = buildThorbitContentOnPageMcpServer(client)\n  await server.connect(new StdioServerTransport())\n}\n\nmain().catch(error => {\n  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`)\n  process.exit(1)\n})\n","import type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nexport type ThorbitContentOnPageMcpEnvelope =\n  | {\n      ok: true\n      result: unknown\n      warnings?: string[]\n      requestId: string\n      usage?: Record<string, unknown>\n    }\n  | {\n      ok: false\n      error: {\n        code: string\n        message: string\n        details?: unknown\n      }\n      requestId: string\n    }\n\nexport class ThorbitContentOnPageApiClient {\n  private readonly baseUrl: string\n  private readonly apiKey: string\n\n  constructor(options: { baseUrl: string; apiKey: string }) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '')\n    this.apiKey = options.apiKey\n  }\n\n  async callTool(toolName: ThorbitContentOnPageMcpToolName, input: unknown): Promise<ThorbitContentOnPageMcpEnvelope> {\n    const response = await fetch(`${this.baseUrl}/api/v1/mcp/content-onpage/${toolName}`, {\n      method: 'POST',\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(input ?? {}),\n    })\n\n    const body = await response.json().catch(() => null) as ThorbitContentOnPageMcpEnvelope | null\n    if (body && typeof body === 'object' && 'ok' in body) return body\n\n    return {\n      ok: false,\n      requestId: 'unavailable',\n      error: {\n        code: response.ok ? 'invalid_response' : `http_${response.status}`,\n        message: response.ok ? 'Thorbit returned an invalid MCP response' : `Thorbit API request failed with HTTP ${response.status}`,\n      },\n    }\n  }\n}\n","import { readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\nexport type ThorbitContentOnPageMcpEnv = {\n  apiKey: string\n  baseUrl: string\n}\n\nfunction readApiKeyFile(): string | undefined {\n  const explicitPath = process.env.THORBIT_CONTENT_MCP_KEY_PATH?.trim()\n  const paths = [explicitPath, join(homedir(), '.thorbit-content-mcp-key')].filter(Boolean) as string[]\n  for (const path of paths) {\n    try {\n      const value = readFileSync(path, 'utf8').trim()\n      if (value) return value\n    } catch {\n      continue\n    }\n  }\n  return undefined\n}\n\nexport function resolveThorbitContentOnPageMcpEnv(): ThorbitContentOnPageMcpEnv {\n  const apiKey = (\n    process.env.THORBIT_API_KEY ||\n    process.env.THORBIT_MCP_API_KEY ||\n    process.env.THORBIT_CONTENT_MCP_API_KEY ||\n    readApiKeyFile()\n  )?.trim()\n\n  if (!apiKey) {\n    throw new Error('THORBIT_API_KEY, THORBIT_MCP_API_KEY, or ~/.thorbit-content-mcp-key is required')\n  }\n\n  return {\n    apiKey,\n    baseUrl: (process.env.THORBIT_BASE_URL || process.env.THORBIT_CONTENT_MCP_BASE_URL || 'https://thorbit.ai').trim(),\n  }\n}\n","import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js'\nimport type { ZodRawShape } from 'zod'\nimport type { ThorbitContentOnPageApiClient } from './content-onpage-api-client.js'\nimport { formatThorbitContentOnPageMcpToolResult } from './content-onpage-mcp-response-formatters.js'\nimport {\n  ThorbitContentExtractUrlInputSchema,\n  ThorbitContentHarvestSerpInputSchema,\n  ThorbitContentRedditResearchInputSchema,\n  ThorbitOnPageGetAnalysisInputSchema,\n  ThorbitOnPageStartAnalysisInputSchema,\n} from './content-onpage-mcp-tool-schemas.js'\nimport type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nconst VERSION = '0.1.2'\n\ntype ThorbitContentOnPageToolConfig<InputArgs extends ZodRawShape> = {\n  title: string\n  description: string\n  inputSchema: InputArgs\n  annotations: ToolAnnotations\n}\n\nfunction readOnlyAnnotations(title: string, openWorldHint = true) {\n  return {\n    title,\n    readOnlyHint: true,\n    destructiveHint: false,\n    idempotentHint: true,\n    openWorldHint,\n  }\n}\n\nfunction writeAnnotations(title: string, openWorldHint = false) {\n  return {\n    title,\n    readOnlyHint: false,\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint,\n  }\n}\n\nexport function buildThorbitContentOnPageMcpServer(client: ThorbitContentOnPageApiClient): McpServer {\n  const server = new McpServer({ name: 'thorbit-content-mcp', version: VERSION })\n\n  server.registerResource(\n    'analysis',\n    new ResourceTemplate('thorbit-content://analyses/{analysisPublicId}', { list: undefined }),\n    {\n      title: 'Thorbit On-Page Analysis',\n      description: 'Status, score, signal counts, and summary for one Thorbit on-page analysis.',\n      mimeType: 'application/json',\n    },\n    async (uri, variables) => {\n      const analysisPublicId = Array.isArray(variables.analysisPublicId)\n        ? variables.analysisPublicId[0]\n        : variables.analysisPublicId\n      const envelope = await client.callTool('thorbit_onpage_get_analysis', { analysisPublicId: String(analysisPublicId) })\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  function registerTool<T extends ThorbitContentOnPageMcpToolName>(\n    toolName: T,\n    config: ThorbitContentOnPageToolConfig<ZodRawShape>,\n  ): void {\n    server.registerTool(toolName, config, async (input) => {\n      const envelope = await client.callTool(toolName, input)\n      return formatThorbitContentOnPageMcpToolResult(toolName, envelope)\n    })\n  }\n\n  registerTool('thorbit_content_extract_url', {\n    title: 'Extract URL For Content Analysis',\n    description: 'Extract a public URL through MCP Scraper only. Use this before content audits, source ingestion, outline planning, or on-page comparisons. Browser fallback is enabled by default for JS-heavy pages.',\n    inputSchema: ThorbitContentExtractUrlInputSchema,\n    annotations: readOnlyAnnotations('Extract URL For Content Analysis'),\n  })\n\n  registerTool('thorbit_content_harvest_serp', {\n    title: 'Harvest SERP And PAA Evidence',\n    description: 'Harvest Google SERP/PAA evidence through MCP Scraper only. Returns the full evidence surface from MCP Scraper: PAA flat questions, PAA tree, organic SERP, local pack, videos/shorts, forums, whatPeopleSaying, AI Overview text/citations/sections, AI Mode, entity IDs, stats, diagnostics, and retry attempts. Split topic from location when possible. Keep proxyMode as location for US city/state SERPs so MCP Scraper rotates fresh residential proxy IDs and browser sessions across retryable CAPTCHA, proxy tunnel, proxy availability, and location-mismatch failures. Pass proxyZip for known city-center ZIP targeting and debug true when retry/proxy diagnostics are needed.',\n    inputSchema: ThorbitContentHarvestSerpInputSchema,\n    annotations: readOnlyAnnotations('Harvest SERP And PAA Evidence'),\n  })\n\n  registerTool('thorbit_content_reddit_research', {\n    title: 'Research Reddit With MCP Scraper Browser Agent',\n    description: 'Find Reddit candidates through MCP Scraper SERP harvest, then read selected posts through MCP Scraper browser-agent by default. Use for authentic audience language, objections, pain points, and questions. Keep proxyMode as location and pass location/proxyZip when the Reddit research has a local market. Do not use generic web scraping fallbacks for Reddit.',\n    inputSchema: ThorbitContentRedditResearchInputSchema,\n    annotations: readOnlyAnnotations('Research Reddit With Browser Agent'),\n  })\n\n  registerTool('thorbit_onpage_start_analysis', {\n    title: 'Start Thorbit On-Page Analysis',\n    description: 'Start a Thorbit on-page analysis for a project keyword. Can run keyword-only analysis or score provided inline content. Hosted Thorbit dispatches the durable analysis workflow and meters usage against the MCP API key.',\n    inputSchema: ThorbitOnPageStartAnalysisInputSchema,\n    annotations: writeAnnotations('Start Thorbit On-Page Analysis'),\n  })\n\n  registerTool('thorbit_onpage_get_analysis', {\n    title: 'Read Thorbit On-Page Analysis',\n    description: 'Read persisted on-page analysis status, score, signal counts, and content report summary by analysis public ID. Use after thorbit_onpage_start_analysis to poll durable results.',\n    inputSchema: ThorbitOnPageGetAnalysisInputSchema,\n    annotations: readOnlyAnnotations('Read Thorbit On-Page Analysis', false),\n  })\n\n  return server\n}\n","import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js'\nimport type { ThorbitContentOnPageMcpEnvelope } from './content-onpage-api-client.js'\nimport type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nexport function formatThorbitContentOnPageMcpToolResult(\n  toolName: ThorbitContentOnPageMcpToolName,\n  envelope: ThorbitContentOnPageMcpEnvelope,\n): CallToolResult {\n  const text = JSON.stringify({\n    toolName,\n    ...envelope,\n  }, null, 2)\n  return {\n    content: [{ type: 'text', text }],\n    isError: !envelope.ok,\n  }\n}\n","import { z } from 'zod'\n\nexport const ThorbitContentExtractUrlInputSchema = {\n  url: z.string().url().describe('Public URL to extract through MCP Scraper.'),\n  browserFallback: z.boolean().default(true).describe('Use MCP Scraper browser fallback for JS-heavy pages. Default true.'),\n  extractBranding: z.boolean().default(false).describe('Ask MCP Scraper to extract brand colors, fonts, logo, and favicon when supported.'),\n  downloadMedia: z.boolean().default(false).describe('Ask MCP Scraper to download page media when supported.'),\n  maxCharacters: z.number().int().min(500).max(500000).default(80000).describe('Maximum extracted content characters returned to the MCP caller.'),\n}\n\nconst McpScraperProxyModeSchema = z.enum(['location', 'configured', 'none'])\nconst McpScraperSerpDeviceSchema = z.enum(['desktop', 'mobile'])\n\nexport const ThorbitContentHarvestSerpInputSchema = {\n  query: z.string().min(1).max(400).describe('Core search topic. Separate location when possible, e.g. query=\"best CRM\" and location=\"Denver, CO\".'),\n  location: z.string().min(1).max(160).optional().describe('Optional search location, such as Denver, CO. Required for precise residential proxy targeting.'),\n  gl: z.string().length(2).optional().describe('Optional Google country code, such as us.'),\n  hl: z.string().min(2).max(12).optional().describe('Optional Google interface language, such as en.'),\n  device: McpScraperSerpDeviceSchema.default('desktop').describe('SERP device context. Use desktop by default; use mobile only when requested.'),\n  maxQuestions: z.number().int().min(1).max(200).default(30).describe('Maximum PAA questions when serpOnly is false.'),\n  includeSerp: z.boolean().default(true).describe('Include organic SERP results. Default true.'),\n  serpOnly: z.boolean().default(false).describe('Use fast SERP-only mode when PAA expansion is not needed.'),\n  proxyMode: McpScraperProxyModeSchema.default('location').describe('MCP Scraper proxy mode. Use location by default for US city/state SERPs so MCP Scraper rotates fresh residential proxy IDs and browser sessions across retryable CAPTCHA/proxy/location failures.'),\n  proxyZip: z.string().regex(/^\\d{5}$/).optional().describe('Optional US ZIP override for residential location proxy targeting. Use when a specific ZIP or city-center ZIP is known.'),\n  debug: z.boolean().default(false).describe('Include sanitized MCP Scraper browser/proxy/location diagnostics and attempt telemetry. Use true when debugging CAPTCHA, proxy selection, or localization.'),\n  pages: z.number().int().min(1).max(2).default(1).describe('Number of Google result pages to fetch in SERP-only mode.'),\n}\n\nexport const ThorbitContentRedditResearchInputSchema = {\n  query: z.string().min(1).max(400).describe('Topic, product, service, or pain point to research on Reddit.'),\n  location: z.string().min(1).max(160).optional().describe('Optional location to bias MCP Scraper SERP discovery and residential proxy targeting.'),\n  gl: z.string().length(2).optional().describe('Optional Google country code, such as us.'),\n  hl: z.string().min(2).max(12).optional().describe('Optional Google interface language, such as en.'),\n  device: McpScraperSerpDeviceSchema.default('desktop').describe('SERP device context for Reddit discovery.'),\n  proxyMode: McpScraperProxyModeSchema.default('location').describe('MCP Scraper proxy mode for Reddit discovery. Use location by default so MCP Scraper owns CAPTCHA/proxy retries.'),\n  proxyZip: z.string().regex(/^\\d{5}$/).optional().describe('Optional US ZIP override for residential location proxy targeting.'),\n  debug: z.boolean().default(false).describe('Include sanitized MCP Scraper retry/proxy diagnostics for Reddit discovery.'),\n  maxPosts: z.number().int().min(1).max(10).default(5).describe('Maximum Reddit posts to read with MCP Scraper browser-agent.'),\n  readWithBrowserAgent: z.boolean().default(true).describe('Keep true. Reads Reddit candidates through MCP Scraper browser-agent.'),\n  profile: z.string().min(1).max(128).optional().describe('Optional MCP Scraper browser-agent saved profile name.'),\n}\n\nexport const ThorbitOnPageStartAnalysisInputSchema = {\n  projectPublicId: z.string().min(1).describe('Thorbit project public ID.'),\n  keyword: z.string().min(1).max(200).describe('Target keyword or query for on-page analysis.'),\n  force: z.boolean().default(false).describe('Force restart if an analysis is already running.'),\n  source: z.discriminatedUnion('mode', [\n    z.object({ mode: z.literal('keyword_only') }).strict(),\n    z.object({\n      mode: z.literal('inline_content'),\n      title: z.string().min(1).max(255).optional(),\n      text: z.string().min(20).max(500000),\n      sourceUrl: z.string().url().optional(),\n    }).strict(),\n  ]).default({ mode: 'keyword_only' }).describe('Use keyword_only for research-only analysis or inline_content to score provided content.'),\n}\n\nexport const ThorbitOnPageGetAnalysisInputSchema = {\n  analysisPublicId: z.string().min(1).describe('On-page analysis public ID returned by thorbit_onpage_start_analysis.'),\n}\n\nexport const ThorbitContentOnPageMcpToolInputSchemas = {\n  thorbit_content_extract_url: ThorbitContentExtractUrlInputSchema,\n  thorbit_content_harvest_serp: ThorbitContentHarvestSerpInputSchema,\n  thorbit_content_reddit_research: ThorbitContentRedditResearchInputSchema,\n  thorbit_onpage_start_analysis: ThorbitOnPageStartAnalysisInputSchema,\n  thorbit_onpage_get_analysis: ThorbitOnPageGetAnalysisInputSchema,\n}\n"],"mappings":";;;AAAA,SAAS,4BAA4B;;;ACoB9B,IAAM,gCAAN,MAAoC;AAAA,EACxB;AAAA,EACA;AAAA,EAEjB,YAAY,SAA8C;AACxD,SAAK,UAAU,QAAQ,QAAQ,QAAQ,OAAO,EAAE;AAChD,SAAK,SAAS,QAAQ;AAAA,EACxB;AAAA,EAEA,MAAM,SAAS,UAA2C,OAA0D;AAClH,UAAM,WAAW,MAAM,MAAM,GAAG,KAAK,OAAO,8BAA8B,QAAQ,IAAI;AAAA,MACpF,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,eAAe,UAAU,KAAK,MAAM;AAAA,QACpC,gBAAgB;AAAA,MAClB;AAAA,MACA,MAAM,KAAK,UAAU,SAAS,CAAC,CAAC;AAAA,IAClC,CAAC;AAED,UAAM,OAAO,MAAM,SAAS,KAAK,EAAE,MAAM,MAAM,IAAI;AACnD,QAAI,QAAQ,OAAO,SAAS,YAAY,QAAQ,KAAM,QAAO;AAE7D,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,WAAW;AAAA,MACX,OAAO;AAAA,QACL,MAAM,SAAS,KAAK,qBAAqB,QAAQ,SAAS,MAAM;AAAA,QAChE,SAAS,SAAS,KAAK,6CAA6C,wCAAwC,SAAS,MAAM;AAAA,MAC7H;AAAA,IACF;AAAA,EACF;AACF;;;ACnDA,SAAS,oBAAoB;AAC7B,SAAS,eAAe;AACxB,SAAS,YAAY;AAOrB,SAAS,iBAAqC;AAC5C,QAAM,eAAe,QAAQ,IAAI,8BAA8B,KAAK;AACpE,QAAM,QAAQ,CAAC,cAAc,KAAK,QAAQ,GAAG,0BAA0B,CAAC,EAAE,OAAO,OAAO;AACxF,aAAW,QAAQ,OAAO;AACxB,QAAI;AACF,YAAM,QAAQ,aAAa,MAAM,MAAM,EAAE,KAAK;AAC9C,UAAI,MAAO,QAAO;AAAA,IACpB,QAAQ;AACN;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,oCAAgE;AAC9E,QAAM,UACJ,QAAQ,IAAI,mBACZ,QAAQ,IAAI,uBACZ,QAAQ,IAAI,+BACZ,eAAe,IACd,KAAK;AAER,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,iFAAiF;AAAA,EACnG;AAEA,SAAO;AAAA,IACL;AAAA,IACA,UAAU,QAAQ,IAAI,oBAAoB,QAAQ,IAAI,gCAAgC,sBAAsB,KAAK;AAAA,EACnH;AACF;;;ACvCA,SAAS,WAAW,wBAAwB;;;ACIrC,SAAS,wCACd,UACA,UACgB;AAChB,QAAM,OAAO,KAAK,UAAU;AAAA,IAC1B;AAAA,IACA,GAAG;AAAA,EACL,GAAG,MAAM,CAAC;AACV,SAAO;AAAA,IACL,SAAS,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC;AAAA,IAChC,SAAS,CAAC,SAAS;AAAA,EACrB;AACF;;;AChBA,SAAS,SAAS;AAEX,IAAM,sCAAsC;AAAA,EACjD,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,4CAA4C;AAAA,EAC3E,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE,SAAS,oEAAoE;AAAA,EACxH,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,KAAK,EAAE,SAAS,mFAAmF;AAAA,EACxI,eAAe,EAAE,QAAQ,EAAE,QAAQ,KAAK,EAAE,SAAS,wDAAwD;AAAA,EAC3G,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,IAAI,GAAM,EAAE,QAAQ,GAAK,EAAE,SAAS,kEAAkE;AACjJ;AAEA,IAAM,4BAA4B,EAAE,KAAK,CAAC,YAAY,cAAc,MAAM,CAAC;AAC3E,IAAM,6BAA6B,EAAE,KAAK,CAAC,WAAW,QAAQ,CAAC;AAExD,IAAM,uCAAuC;AAAA,EAClD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,sGAAsG;AAAA,EACjJ,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,iGAAiG;AAAA,EAC1J,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,SAAS,2CAA2C;AAAA,EACxF,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,iDAAiD;AAAA,EACnG,QAAQ,2BAA2B,QAAQ,SAAS,EAAE,SAAS,8EAA8E;AAAA,EAC7I,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,QAAQ,EAAE,EAAE,SAAS,+CAA+C;AAAA,EACnH,aAAa,EAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE,SAAS,6CAA6C;AAAA,EAC7F,UAAU,EAAE,QAAQ,EAAE,QAAQ,KAAK,EAAE,SAAS,2DAA2D;AAAA,EACzG,WAAW,0BAA0B,QAAQ,UAAU,EAAE,SAAS,mMAAmM;AAAA,EACrQ,UAAU,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,EAAE,SAAS,yHAAyH;AAAA,EACnL,OAAO,EAAE,QAAQ,EAAE,QAAQ,KAAK,EAAE,SAAS,4JAA4J;AAAA,EACvM,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,SAAS,2DAA2D;AACvH;AAEO,IAAM,0CAA0C;AAAA,EACrD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,+DAA+D;AAAA,EAC1G,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,uFAAuF;AAAA,EAChJ,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,SAAS,2CAA2C;AAAA,EACxF,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,iDAAiD;AAAA,EACnG,QAAQ,2BAA2B,QAAQ,SAAS,EAAE,SAAS,2CAA2C;AAAA,EAC1G,WAAW,0BAA0B,QAAQ,UAAU,EAAE,SAAS,iHAAiH;AAAA,EACnL,UAAU,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,EAAE,SAAS,oEAAoE;AAAA,EAC9H,OAAO,EAAE,QAAQ,EAAE,QAAQ,KAAK,EAAE,SAAS,6EAA6E;AAAA,EACxH,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,EAAE,SAAS,8DAA8D;AAAA,EAC5H,sBAAsB,EAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE,SAAS,uEAAuE;AAAA,EAChI,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,wDAAwD;AAClH;AAEO,IAAM,wCAAwC;AAAA,EACnD,iBAAiB,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,4BAA4B;AAAA,EACxE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,+CAA+C;AAAA,EAC5F,OAAO,EAAE,QAAQ,EAAE,QAAQ,KAAK,EAAE,SAAS,kDAAkD;AAAA,EAC7F,QAAQ,EAAE,mBAAmB,QAAQ;AAAA,IACnC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,cAAc,EAAE,CAAC,EAAE,OAAO;AAAA,IACrD,EAAE,OAAO;AAAA,MACP,MAAM,EAAE,QAAQ,gBAAgB;AAAA,MAChC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,MAC3C,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,GAAM;AAAA,MACnC,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS;AAAA,IACvC,CAAC,EAAE,OAAO;AAAA,EACZ,CAAC,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC,EAAE,SAAS,0FAA0F;AAC1I;AAEO,IAAM,sCAAsC;AAAA,EACjD,kBAAkB,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,uEAAuE;AACtH;;;AF7CA,IAAM,UAAU;AAShB,SAAS,oBAAoB,OAAe,gBAAgB,MAAM;AAChE,SAAO;AAAA,IACL;AAAA,IACA,cAAc;AAAA,IACd,iBAAiB;AAAA,IACjB,gBAAgB;AAAA,IAChB;AAAA,EACF;AACF;AAEA,SAAS,iBAAiB,OAAe,gBAAgB,OAAO;AAC9D,SAAO;AAAA,IACL;AAAA,IACA,cAAc;AAAA,IACd,iBAAiB;AAAA,IACjB,gBAAgB;AAAA,IAChB;AAAA,EACF;AACF;AAEO,SAAS,mCAAmC,QAAkD;AACnG,QAAM,SAAS,IAAI,UAAU,EAAE,MAAM,uBAAuB,SAAS,QAAQ,CAAC;AAE9E,SAAO;AAAA,IACL;AAAA,IACA,IAAI,iBAAiB,iDAAiD,EAAE,MAAM,OAAU,CAAC;AAAA,IACzF;AAAA,MACE,OAAO;AAAA,MACP,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,OAAO,KAAK,cAAc;AACxB,YAAM,mBAAmB,MAAM,QAAQ,UAAU,gBAAgB,IAC7D,UAAU,iBAAiB,CAAC,IAC5B,UAAU;AACd,YAAM,WAAW,MAAM,OAAO,SAAS,+BAA+B,EAAE,kBAAkB,OAAO,gBAAgB,EAAE,CAAC;AACpH,aAAO,EAAE,UAAU,CAAC,EAAE,KAAK,IAAI,MAAM,UAAU,oBAAoB,MAAM,KAAK,UAAU,UAAU,MAAM,CAAC,EAAE,CAAC,EAAE;AAAA,IAChH;AAAA,EACF;AAEA,WAAS,aACP,UACA,QACM;AACN,WAAO,aAAa,UAAU,QAAQ,OAAO,UAAU;AACrD,YAAM,WAAW,MAAM,OAAO,SAAS,UAAU,KAAK;AACtD,aAAO,wCAAwC,UAAU,QAAQ;AAAA,IACnE,CAAC;AAAA,EACH;AAEA,eAAa,+BAA+B;AAAA,IAC1C,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,oBAAoB,kCAAkC;AAAA,EACrE,CAAC;AAED,eAAa,gCAAgC;AAAA,IAC3C,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,oBAAoB,+BAA+B;AAAA,EAClE,CAAC;AAED,eAAa,mCAAmC;AAAA,IAC9C,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,oBAAoB,oCAAoC;AAAA,EACvE,CAAC;AAED,eAAa,iCAAiC;AAAA,IAC5C,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,iBAAiB,gCAAgC;AAAA,EAChE,CAAC;AAED,eAAa,+BAA+B;AAAA,IAC1C,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,oBAAoB,iCAAiC,KAAK;AAAA,EACzE,CAAC;AAED,SAAO;AACT;;;AHxGA,eAAe,OAAO;AACpB,QAAM,MAAM,kCAAkC;AAC9C,QAAM,SAAS,IAAI,8BAA8B,GAAG;AACpD,QAAM,SAAS,mCAAmC,MAAM;AACxD,QAAM,OAAO,QAAQ,IAAI,qBAAqB,CAAC;AACjD;AAEA,KAAK,EAAE,MAAM,WAAS;AACpB,UAAQ,OAAO,MAAM,GAAG,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,CAAI;AAClF,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":[]}

package/dist/index.cjs

@@ -82,18 +82,31 @@ var ThorbitContentExtractUrlInputSchema = {
   downloadMedia: import_zod.z.boolean().default(false).describe("Ask MCP Scraper to download page media when supported."),
   maxCharacters: import_zod.z.number().int().min(500).max(5e5).default(8e4).describe("Maximum extracted content characters returned to the MCP caller.")
 };
+var McpScraperProxyModeSchema = import_zod.z.enum(["location", "configured", "none"]);
+var McpScraperSerpDeviceSchema = import_zod.z.enum(["desktop", "mobile"]);
 var ThorbitContentHarvestSerpInputSchema = {
-  query: import_zod.z.string().min(1).max(400).describe("Search query for MCP Scraper SERP/PAA harvest."),
-  location: import_zod.z.string().min(1).max(160).optional().describe("Optional search location, such as Denver, Colorado, United States."),
+  query: import_zod.z.string().min(1).max(400).describe('Core search topic. Separate location when possible, e.g. query="best CRM" and location="Denver, CO".'),
+  location: import_zod.z.string().min(1).max(160).optional().describe("Optional search location, such as Denver, CO. Required for precise residential proxy targeting."),
   gl: import_zod.z.string().length(2).optional().describe("Optional Google country code, such as us."),
   hl: import_zod.z.string().min(2).max(12).optional().describe("Optional Google interface language, such as en."),
-  maxQuestions: import_zod.z.number().int().min(1).max(150).default(30).describe("Maximum PAA questions when serpOnly is false."),
+  device: McpScraperSerpDeviceSchema.default("desktop").describe("SERP device context. Use desktop by default; use mobile only when requested."),
+  maxQuestions: import_zod.z.number().int().min(1).max(200).default(30).describe("Maximum PAA questions when serpOnly is false."),
   includeSerp: import_zod.z.boolean().default(true).describe("Include organic SERP results. Default true."),
-  serpOnly: import_zod.z.boolean().default(false).describe("Use fast SERP-only mode when PAA expansion is not needed.")
+  serpOnly: import_zod.z.boolean().default(false).describe("Use fast SERP-only mode when PAA expansion is not needed."),
+  proxyMode: McpScraperProxyModeSchema.default("location").describe("MCP Scraper proxy mode. Use location by default for US city/state SERPs so MCP Scraper rotates fresh residential proxy IDs and browser sessions across retryable CAPTCHA/proxy/location failures."),
+  proxyZip: import_zod.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting. Use when a specific ZIP or city-center ZIP is known."),
+  debug: import_zod.z.boolean().default(false).describe("Include sanitized MCP Scraper browser/proxy/location diagnostics and attempt telemetry. Use true when debugging CAPTCHA, proxy selection, or localization."),
+  pages: import_zod.z.number().int().min(1).max(2).default(1).describe("Number of Google result pages to fetch in SERP-only mode.")
 };
 var ThorbitContentRedditResearchInputSchema = {
   query: import_zod.z.string().min(1).max(400).describe("Topic, product, service, or pain point to research on Reddit."),
-  location: import_zod.z.string().min(1).max(160).optional().describe("Optional location to bias MCP Scraper SERP discovery."),
+  location: import_zod.z.string().min(1).max(160).optional().describe("Optional location to bias MCP Scraper SERP discovery and residential proxy targeting."),
+  gl: import_zod.z.string().length(2).optional().describe("Optional Google country code, such as us."),
+  hl: import_zod.z.string().min(2).max(12).optional().describe("Optional Google interface language, such as en."),
+  device: McpScraperSerpDeviceSchema.default("desktop").describe("SERP device context for Reddit discovery."),
+  proxyMode: McpScraperProxyModeSchema.default("location").describe("MCP Scraper proxy mode for Reddit discovery. Use location by default so MCP Scraper owns CAPTCHA/proxy retries."),
+  proxyZip: import_zod.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting."),
+  debug: import_zod.z.boolean().default(false).describe("Include sanitized MCP Scraper retry/proxy diagnostics for Reddit discovery."),
   maxPosts: import_zod.z.number().int().min(1).max(10).default(5).describe("Maximum Reddit posts to read with MCP Scraper browser-agent."),
   readWithBrowserAgent: import_zod.z.boolean().default(true).describe("Keep true. Reads Reddit candidates through MCP Scraper browser-agent."),
   profile: import_zod.z.string().min(1).max(128).optional().describe("Optional MCP Scraper browser-agent saved profile name.")
@@ -117,7 +130,7 @@ var ThorbitOnPageGetAnalysisInputSchema = {
 };
 
 // src/content-onpage-mcp-server.ts
-var VERSION = "0.1.0";
+var VERSION = "0.1.2";
 function readOnlyAnnotations(title, openWorldHint = true) {
   return {
     title,
@@ -166,13 +179,13 @@ function buildThorbitContentOnPageMcpServer(client) {
   });
   registerTool("thorbit_content_harvest_serp", {
     title: "Harvest SERP And PAA Evidence",
-    description: "Harvest Google SERP/PAA evidence through MCP Scraper only. Returns PAA questions, organic results, forums, videos, AI Overview fields when available, and provider stats for source-backed content strategy.",
+    description: "Harvest Google SERP/PAA evidence through MCP Scraper only. Returns the full evidence surface from MCP Scraper: PAA flat questions, PAA tree, organic SERP, local pack, videos/shorts, forums, whatPeopleSaying, AI Overview text/citations/sections, AI Mode, entity IDs, stats, diagnostics, and retry attempts. Split topic from location when possible. Keep proxyMode as location for US city/state SERPs so MCP Scraper rotates fresh residential proxy IDs and browser sessions across retryable CAPTCHA, proxy tunnel, proxy availability, and location-mismatch failures. Pass proxyZip for known city-center ZIP targeting and debug true when retry/proxy diagnostics are needed.",
     inputSchema: ThorbitContentHarvestSerpInputSchema,
     annotations: readOnlyAnnotations("Harvest SERP And PAA Evidence")
   });
   registerTool("thorbit_content_reddit_research", {
     title: "Research Reddit With MCP Scraper Browser Agent",
-    description: "Find Reddit candidates through MCP Scraper SERP harvest, then read selected posts through MCP Scraper browser-agent by default. Use for authentic audience language, objections, pain points, and questions. Do not use generic web scraping fallbacks for Reddit.",
+    description: "Find Reddit candidates through MCP Scraper SERP harvest, then read selected posts through MCP Scraper browser-agent by default. Use for authentic audience language, objections, pain points, and questions. Keep proxyMode as location and pass location/proxyZip when the Reddit research has a local market. Do not use generic web scraping fallbacks for Reddit.",
     inputSchema: ThorbitContentRedditResearchInputSchema,
     annotations: readOnlyAnnotations("Research Reddit With Browser Agent")
   });

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/content-onpage-api-client.ts","../src/content-onpage-mcp-server.ts","../src/content-onpage-mcp-response-formatters.ts","../src/content-onpage-mcp-tool-schemas.ts","../src/content-onpage-mcp-env.ts","../src/content-onpage-mcp-tool-names.ts"],"sourcesContent":["export { ThorbitContentOnPageApiClient } from './content-onpage-api-client.js'\nexport { buildThorbitContentOnPageMcpServer } from './content-onpage-mcp-server.js'\nexport { resolveThorbitContentOnPageMcpEnv } from './content-onpage-mcp-env.js'\nexport { ThorbitContentOnPageMcpToolNames } from './content-onpage-mcp-tool-names.js'\n","import type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nexport type ThorbitContentOnPageMcpEnvelope =\n  | {\n      ok: true\n      result: unknown\n      warnings?: string[]\n      requestId: string\n      usage?: Record<string, unknown>\n    }\n  | {\n      ok: false\n      error: {\n        code: string\n        message: string\n        details?: unknown\n      }\n      requestId: string\n    }\n\nexport class ThorbitContentOnPageApiClient {\n  private readonly baseUrl: string\n  private readonly apiKey: string\n\n  constructor(options: { baseUrl: string; apiKey: string }) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '')\n    this.apiKey = options.apiKey\n  }\n\n  async callTool(toolName: ThorbitContentOnPageMcpToolName, input: unknown): Promise<ThorbitContentOnPageMcpEnvelope> {\n    const response = await fetch(`${this.baseUrl}/api/v1/mcp/content-onpage/${toolName}`, {\n      method: 'POST',\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(input ?? {}),\n    })\n\n    const body = await response.json().catch(() => null) as ThorbitContentOnPageMcpEnvelope | null\n    if (body && typeof body === 'object' && 'ok' in body) return body\n\n    return {\n      ok: false,\n      requestId: 'unavailable',\n      error: {\n        code: response.ok ? 'invalid_response' : `http_${response.status}`,\n        message: response.ok ? 'Thorbit returned an invalid MCP response' : `Thorbit API request failed with HTTP ${response.status}`,\n      },\n    }\n  }\n}\n","import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js'\nimport type { ZodRawShape } from 'zod'\nimport type { ThorbitContentOnPageApiClient } from './content-onpage-api-client.js'\nimport { formatThorbitContentOnPageMcpToolResult } from './content-onpage-mcp-response-formatters.js'\nimport {\n  ThorbitContentExtractUrlInputSchema,\n  ThorbitContentHarvestSerpInputSchema,\n  ThorbitContentRedditResearchInputSchema,\n  ThorbitOnPageGetAnalysisInputSchema,\n  ThorbitOnPageStartAnalysisInputSchema,\n} from './content-onpage-mcp-tool-schemas.js'\nimport type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nconst VERSION = '0.1.0'\n\ntype ThorbitContentOnPageToolConfig<InputArgs extends ZodRawShape> = {\n  title: string\n  description: string\n  inputSchema: InputArgs\n  annotations: ToolAnnotations\n}\n\nfunction readOnlyAnnotations(title: string, openWorldHint = true) {\n  return {\n    title,\n    readOnlyHint: true,\n    destructiveHint: false,\n    idempotentHint: true,\n    openWorldHint,\n  }\n}\n\nfunction writeAnnotations(title: string, openWorldHint = false) {\n  return {\n    title,\n    readOnlyHint: false,\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint,\n  }\n}\n\nexport function buildThorbitContentOnPageMcpServer(client: ThorbitContentOnPageApiClient): McpServer {\n  const server = new McpServer({ name: 'thorbit-content-mcp', version: VERSION })\n\n  server.registerResource(\n    'analysis',\n    new ResourceTemplate('thorbit-content://analyses/{analysisPublicId}', { list: undefined }),\n    {\n      title: 'Thorbit On-Page Analysis',\n      description: 'Status, score, signal counts, and summary for one Thorbit on-page analysis.',\n      mimeType: 'application/json',\n    },\n    async (uri, variables) => {\n      const analysisPublicId = Array.isArray(variables.analysisPublicId)\n        ? variables.analysisPublicId[0]\n        : variables.analysisPublicId\n      const envelope = await client.callTool('thorbit_onpage_get_analysis', { analysisPublicId: String(analysisPublicId) })\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  function registerTool<T extends ThorbitContentOnPageMcpToolName>(\n    toolName: T,\n    config: ThorbitContentOnPageToolConfig<ZodRawShape>,\n  ): void {\n    server.registerTool(toolName, config, async (input) => {\n      const envelope = await client.callTool(toolName, input)\n      return formatThorbitContentOnPageMcpToolResult(toolName, envelope)\n    })\n  }\n\n  registerTool('thorbit_content_extract_url', {\n    title: 'Extract URL For Content Analysis',\n    description: 'Extract a public URL through MCP Scraper only. Use this before content audits, source ingestion, outline planning, or on-page comparisons. Browser fallback is enabled by default for JS-heavy pages.',\n    inputSchema: ThorbitContentExtractUrlInputSchema,\n    annotations: readOnlyAnnotations('Extract URL For Content Analysis'),\n  })\n\n  registerTool('thorbit_content_harvest_serp', {\n    title: 'Harvest SERP And PAA Evidence',\n    description: 'Harvest Google SERP/PAA evidence through MCP Scraper only. Returns PAA questions, organic results, forums, videos, AI Overview fields when available, and provider stats for source-backed content strategy.',\n    inputSchema: ThorbitContentHarvestSerpInputSchema,\n    annotations: readOnlyAnnotations('Harvest SERP And PAA Evidence'),\n  })\n\n  registerTool('thorbit_content_reddit_research', {\n    title: 'Research Reddit With MCP Scraper Browser Agent',\n    description: 'Find Reddit candidates through MCP Scraper SERP harvest, then read selected posts through MCP Scraper browser-agent by default. Use for authentic audience language, objections, pain points, and questions. Do not use generic web scraping fallbacks for Reddit.',\n    inputSchema: ThorbitContentRedditResearchInputSchema,\n    annotations: readOnlyAnnotations('Research Reddit With Browser Agent'),\n  })\n\n  registerTool('thorbit_onpage_start_analysis', {\n    title: 'Start Thorbit On-Page Analysis',\n    description: 'Start a Thorbit on-page analysis for a project keyword. Can run keyword-only analysis or score provided inline content. Hosted Thorbit dispatches the durable analysis workflow and meters usage against the MCP API key.',\n    inputSchema: ThorbitOnPageStartAnalysisInputSchema,\n    annotations: writeAnnotations('Start Thorbit On-Page Analysis'),\n  })\n\n  registerTool('thorbit_onpage_get_analysis', {\n    title: 'Read Thorbit On-Page Analysis',\n    description: 'Read persisted on-page analysis status, score, signal counts, and content report summary by analysis public ID. Use after thorbit_onpage_start_analysis to poll durable results.',\n    inputSchema: ThorbitOnPageGetAnalysisInputSchema,\n    annotations: readOnlyAnnotations('Read Thorbit On-Page Analysis', false),\n  })\n\n  return server\n}\n","import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js'\nimport type { ThorbitContentOnPageMcpEnvelope } from './content-onpage-api-client.js'\nimport type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nexport function formatThorbitContentOnPageMcpToolResult(\n  toolName: ThorbitContentOnPageMcpToolName,\n  envelope: ThorbitContentOnPageMcpEnvelope,\n): CallToolResult {\n  const text = JSON.stringify({\n    toolName,\n    ...envelope,\n  }, null, 2)\n  return {\n    content: [{ type: 'text', text }],\n    isError: !envelope.ok,\n  }\n}\n","import { z } from 'zod'\n\nexport const ThorbitContentExtractUrlInputSchema = {\n  url: z.string().url().describe('Public URL to extract through MCP Scraper.'),\n  browserFallback: z.boolean().default(true).describe('Use MCP Scraper browser fallback for JS-heavy pages. Default true.'),\n  extractBranding: z.boolean().default(false).describe('Ask MCP Scraper to extract brand colors, fonts, logo, and favicon when supported.'),\n  downloadMedia: z.boolean().default(false).describe('Ask MCP Scraper to download page media when supported.'),\n  maxCharacters: z.number().int().min(500).max(500000).default(80000).describe('Maximum extracted content characters returned to the MCP caller.'),\n}\n\nexport const ThorbitContentHarvestSerpInputSchema = {\n  query: z.string().min(1).max(400).describe('Search query for MCP Scraper SERP/PAA harvest.'),\n  location: z.string().min(1).max(160).optional().describe('Optional search location, such as Denver, Colorado, United States.'),\n  gl: z.string().length(2).optional().describe('Optional Google country code, such as us.'),\n  hl: z.string().min(2).max(12).optional().describe('Optional Google interface language, such as en.'),\n  maxQuestions: z.number().int().min(1).max(150).default(30).describe('Maximum PAA questions when serpOnly is false.'),\n  includeSerp: z.boolean().default(true).describe('Include organic SERP results. Default true.'),\n  serpOnly: z.boolean().default(false).describe('Use fast SERP-only mode when PAA expansion is not needed.'),\n}\n\nexport const ThorbitContentRedditResearchInputSchema = {\n  query: z.string().min(1).max(400).describe('Topic, product, service, or pain point to research on Reddit.'),\n  location: z.string().min(1).max(160).optional().describe('Optional location to bias MCP Scraper SERP discovery.'),\n  maxPosts: z.number().int().min(1).max(10).default(5).describe('Maximum Reddit posts to read with MCP Scraper browser-agent.'),\n  readWithBrowserAgent: z.boolean().default(true).describe('Keep true. Reads Reddit candidates through MCP Scraper browser-agent.'),\n  profile: z.string().min(1).max(128).optional().describe('Optional MCP Scraper browser-agent saved profile name.'),\n}\n\nexport const ThorbitOnPageStartAnalysisInputSchema = {\n  projectPublicId: z.string().min(1).describe('Thorbit project public ID.'),\n  keyword: z.string().min(1).max(200).describe('Target keyword or query for on-page analysis.'),\n  force: z.boolean().default(false).describe('Force restart if an analysis is already running.'),\n  source: z.discriminatedUnion('mode', [\n    z.object({ mode: z.literal('keyword_only') }).strict(),\n    z.object({\n      mode: z.literal('inline_content'),\n      title: z.string().min(1).max(255).optional(),\n      text: z.string().min(20).max(500000),\n      sourceUrl: z.string().url().optional(),\n    }).strict(),\n  ]).default({ mode: 'keyword_only' }).describe('Use keyword_only for research-only analysis or inline_content to score provided content.'),\n}\n\nexport const ThorbitOnPageGetAnalysisInputSchema = {\n  analysisPublicId: z.string().min(1).describe('On-page analysis public ID returned by thorbit_onpage_start_analysis.'),\n}\n\nexport const ThorbitContentOnPageMcpToolInputSchemas = {\n  thorbit_content_extract_url: ThorbitContentExtractUrlInputSchema,\n  thorbit_content_harvest_serp: ThorbitContentHarvestSerpInputSchema,\n  thorbit_content_reddit_research: ThorbitContentRedditResearchInputSchema,\n  thorbit_onpage_start_analysis: ThorbitOnPageStartAnalysisInputSchema,\n  thorbit_onpage_get_analysis: ThorbitOnPageGetAnalysisInputSchema,\n}\n","import { readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\nexport type ThorbitContentOnPageMcpEnv = {\n  apiKey: string\n  baseUrl: string\n}\n\nfunction readApiKeyFile(): string | undefined {\n  const explicitPath = process.env.THORBIT_CONTENT_MCP_KEY_PATH?.trim()\n  const paths = [explicitPath, join(homedir(), '.thorbit-content-mcp-key')].filter(Boolean) as string[]\n  for (const path of paths) {\n    try {\n      const value = readFileSync(path, 'utf8').trim()\n      if (value) return value\n    } catch {\n      continue\n    }\n  }\n  return undefined\n}\n\nexport function resolveThorbitContentOnPageMcpEnv(): ThorbitContentOnPageMcpEnv {\n  const apiKey = (\n    process.env.THORBIT_API_KEY ||\n    process.env.THORBIT_MCP_API_KEY ||\n    process.env.THORBIT_CONTENT_MCP_API_KEY ||\n    readApiKeyFile()\n  )?.trim()\n\n  if (!apiKey) {\n    throw new Error('THORBIT_API_KEY, THORBIT_MCP_API_KEY, or ~/.thorbit-content-mcp-key is required')\n  }\n\n  return {\n    apiKey,\n    baseUrl: (process.env.THORBIT_BASE_URL || process.env.THORBIT_CONTENT_MCP_BASE_URL || 'https://thorbit.ai').trim(),\n  }\n}\n","export const ThorbitContentOnPageMcpToolNames = [\n  'thorbit_content_extract_url',\n  'thorbit_content_harvest_serp',\n  'thorbit_content_reddit_research',\n  'thorbit_onpage_start_analysis',\n  'thorbit_onpage_get_analysis',\n] as const\n\nexport type ThorbitContentOnPageMcpToolName = typeof ThorbitContentOnPageMcpToolNames[number]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACoBO,IAAM,gCAAN,MAAoC;AAAA,EACxB;AAAA,EACA;AAAA,EAEjB,YAAY,SAA8C;AACxD,SAAK,UAAU,QAAQ,QAAQ,QAAQ,OAAO,EAAE;AAChD,SAAK,SAAS,QAAQ;AAAA,EACxB;AAAA,EAEA,MAAM,SAAS,UAA2C,OAA0D;AAClH,UAAM,WAAW,MAAM,MAAM,GAAG,KAAK,OAAO,8BAA8B,QAAQ,IAAI;AAAA,MACpF,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,eAAe,UAAU,KAAK,MAAM;AAAA,QACpC,gBAAgB;AAAA,MAClB;AAAA,MACA,MAAM,KAAK,UAAU,SAAS,CAAC,CAAC;AAAA,IAClC,CAAC;AAED,UAAM,OAAO,MAAM,SAAS,KAAK,EAAE,MAAM,MAAM,IAAI;AACnD,QAAI,QAAQ,OAAO,SAAS,YAAY,QAAQ,KAAM,QAAO;AAE7D,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,WAAW;AAAA,MACX,OAAO;AAAA,QACL,MAAM,SAAS,KAAK,qBAAqB,QAAQ,SAAS,MAAM;AAAA,QAChE,SAAS,SAAS,KAAK,6CAA6C,wCAAwC,SAAS,MAAM;AAAA,MAC7H;AAAA,IACF;AAAA,EACF;AACF;;;ACnDA,iBAA4C;;;ACIrC,SAAS,wCACd,UACA,UACgB;AAChB,QAAM,OAAO,KAAK,UAAU;AAAA,IAC1B;AAAA,IACA,GAAG;AAAA,EACL,GAAG,MAAM,CAAC;AACV,SAAO;AAAA,IACL,SAAS,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC;AAAA,IAChC,SAAS,CAAC,SAAS;AAAA,EACrB;AACF;;;AChBA,iBAAkB;AAEX,IAAM,sCAAsC;AAAA,EACjD,KAAK,aAAE,OAAO,EAAE,IAAI,EAAE,SAAS,4CAA4C;AAAA,EAC3E,iBAAiB,aAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE,SAAS,oEAAoE;AAAA,EACxH,iBAAiB,aAAE,QAAQ,EAAE,QAAQ,KAAK,EAAE,SAAS,mFAAmF;AAAA,EACxI,eAAe,aAAE,QAAQ,EAAE,QAAQ,KAAK,EAAE,SAAS,wDAAwD;AAAA,EAC3G,eAAe,aAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,IAAI,GAAM,EAAE,QAAQ,GAAK,EAAE,SAAS,kEAAkE;AACjJ;AAEO,IAAM,uCAAuC;AAAA,EAClD,OAAO,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,gDAAgD;AAAA,EAC3F,UAAU,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,oEAAoE;AAAA,EAC7H,IAAI,aAAE,OAAO,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,SAAS,2CAA2C;AAAA,EACxF,IAAI,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,iDAAiD;AAAA,EACnG,cAAc,aAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,QAAQ,EAAE,EAAE,SAAS,+CAA+C;AAAA,EACnH,aAAa,aAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE,SAAS,6CAA6C;AAAA,EAC7F,UAAU,aAAE,QAAQ,EAAE,QAAQ,KAAK,EAAE,SAAS,2DAA2D;AAC3G;AAEO,IAAM,0CAA0C;AAAA,EACrD,OAAO,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,+DAA+D;AAAA,EAC1G,UAAU,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,uDAAuD;AAAA,EAChH,UAAU,aAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,EAAE,SAAS,8DAA8D;AAAA,EAC5H,sBAAsB,aAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE,SAAS,uEAAuE;AAAA,EAChI,SAAS,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,wDAAwD;AAClH;AAEO,IAAM,wCAAwC;AAAA,EACnD,iBAAiB,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,4BAA4B;AAAA,EACxE,SAAS,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,+CAA+C;AAAA,EAC5F,OAAO,aAAE,QAAQ,EAAE,QAAQ,KAAK,EAAE,SAAS,kDAAkD;AAAA,EAC7F,QAAQ,aAAE,mBAAmB,QAAQ;AAAA,IACnC,aAAE,OAAO,EAAE,MAAM,aAAE,QAAQ,cAAc,EAAE,CAAC,EAAE,OAAO;AAAA,IACrD,aAAE,OAAO;AAAA,MACP,MAAM,aAAE,QAAQ,gBAAgB;AAAA,MAChC,OAAO,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,MAC3C,MAAM,aAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,GAAM;AAAA,MACnC,WAAW,aAAE,OAAO,EAAE,IAAI,EAAE,SAAS;AAAA,IACvC,CAAC,EAAE,OAAO;AAAA,EACZ,CAAC,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC,EAAE,SAAS,0FAA0F;AAC1I;AAEO,IAAM,sCAAsC;AAAA,EACjD,kBAAkB,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,uEAAuE;AACtH;;;AF/BA,IAAM,UAAU;AAShB,SAAS,oBAAoB,OAAe,gBAAgB,MAAM;AAChE,SAAO;AAAA,IACL;AAAA,IACA,cAAc;AAAA,IACd,iBAAiB;AAAA,IACjB,gBAAgB;AAAA,IAChB;AAAA,EACF;AACF;AAEA,SAAS,iBAAiB,OAAe,gBAAgB,OAAO;AAC9D,SAAO;AAAA,IACL;AAAA,IACA,cAAc;AAAA,IACd,iBAAiB;AAAA,IACjB,gBAAgB;AAAA,IAChB;AAAA,EACF;AACF;AAEO,SAAS,mCAAmC,QAAkD;AACnG,QAAM,SAAS,IAAI,qBAAU,EAAE,MAAM,uBAAuB,SAAS,QAAQ,CAAC;AAE9E,SAAO;AAAA,IACL;AAAA,IACA,IAAI,4BAAiB,iDAAiD,EAAE,MAAM,OAAU,CAAC;AAAA,IACzF;AAAA,MACE,OAAO;AAAA,MACP,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,OAAO,KAAK,cAAc;AACxB,YAAM,mBAAmB,MAAM,QAAQ,UAAU,gBAAgB,IAC7D,UAAU,iBAAiB,CAAC,IAC5B,UAAU;AACd,YAAM,WAAW,MAAM,OAAO,SAAS,+BAA+B,EAAE,kBAAkB,OAAO,gBAAgB,EAAE,CAAC;AACpH,aAAO,EAAE,UAAU,CAAC,EAAE,KAAK,IAAI,MAAM,UAAU,oBAAoB,MAAM,KAAK,UAAU,UAAU,MAAM,CAAC,EAAE,CAAC,EAAE;AAAA,IAChH;AAAA,EACF;AAEA,WAAS,aACP,UACA,QACM;AACN,WAAO,aAAa,UAAU,QAAQ,OAAO,UAAU;AACrD,YAAM,WAAW,MAAM,OAAO,SAAS,UAAU,KAAK;AACtD,aAAO,wCAAwC,UAAU,QAAQ;AAAA,IACnE,CAAC;AAAA,EACH;AAEA,eAAa,+BAA+B;AAAA,IAC1C,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,oBAAoB,kCAAkC;AAAA,EACrE,CAAC;AAED,eAAa,gCAAgC;AAAA,IAC3C,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,oBAAoB,+BAA+B;AAAA,EAClE,CAAC;AAED,eAAa,mCAAmC;AAAA,IAC9C,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,oBAAoB,oCAAoC;AAAA,EACvE,CAAC;AAED,eAAa,iCAAiC;AAAA,IAC5C,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,iBAAiB,gCAAgC;AAAA,EAChE,CAAC;AAED,eAAa,+BAA+B;AAAA,IAC1C,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,oBAAoB,iCAAiC,KAAK;AAAA,EACzE,CAAC;AAED,SAAO;AACT;;;AG7GA,qBAA6B;AAC7B,qBAAwB;AACxB,uBAAqB;AAOrB,SAAS,iBAAqC;AAC5C,QAAM,eAAe,QAAQ,IAAI,8BAA8B,KAAK;AACpE,QAAM,QAAQ,CAAC,kBAAc,2BAAK,wBAAQ,GAAG,0BAA0B,CAAC,EAAE,OAAO,OAAO;AACxF,aAAW,QAAQ,OAAO;AACxB,QAAI;AACF,YAAM,YAAQ,6BAAa,MAAM,MAAM,EAAE,KAAK;AAC9C,UAAI,MAAO,QAAO;AAAA,IACpB,QAAQ;AACN;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,oCAAgE;AAC9E,QAAM,UACJ,QAAQ,IAAI,mBACZ,QAAQ,IAAI,uBACZ,QAAQ,IAAI,+BACZ,eAAe,IACd,KAAK;AAER,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,iFAAiF;AAAA,EACnG;AAEA,SAAO;AAAA,IACL;AAAA,IACA,UAAU,QAAQ,IAAI,oBAAoB,QAAQ,IAAI,gCAAgC,sBAAsB,KAAK;AAAA,EACnH;AACF;;;ACvCO,IAAM,mCAAmC;AAAA,EAC9C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/content-onpage-api-client.ts","../src/content-onpage-mcp-server.ts","../src/content-onpage-mcp-response-formatters.ts","../src/content-onpage-mcp-tool-schemas.ts","../src/content-onpage-mcp-env.ts","../src/content-onpage-mcp-tool-names.ts"],"sourcesContent":["export { ThorbitContentOnPageApiClient } from './content-onpage-api-client.js'\nexport { buildThorbitContentOnPageMcpServer } from './content-onpage-mcp-server.js'\nexport { resolveThorbitContentOnPageMcpEnv } from './content-onpage-mcp-env.js'\nexport { ThorbitContentOnPageMcpToolNames } from './content-onpage-mcp-tool-names.js'\n","import type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nexport type ThorbitContentOnPageMcpEnvelope =\n  | {\n      ok: true\n      result: unknown\n      warnings?: string[]\n      requestId: string\n      usage?: Record<string, unknown>\n    }\n  | {\n      ok: false\n      error: {\n        code: string\n        message: string\n        details?: unknown\n      }\n      requestId: string\n    }\n\nexport class ThorbitContentOnPageApiClient {\n  private readonly baseUrl: string\n  private readonly apiKey: string\n\n  constructor(options: { baseUrl: string; apiKey: string }) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '')\n    this.apiKey = options.apiKey\n  }\n\n  async callTool(toolName: ThorbitContentOnPageMcpToolName, input: unknown): Promise<ThorbitContentOnPageMcpEnvelope> {\n    const response = await fetch(`${this.baseUrl}/api/v1/mcp/content-onpage/${toolName}`, {\n      method: 'POST',\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(input ?? {}),\n    })\n\n    const body = await response.json().catch(() => null) as ThorbitContentOnPageMcpEnvelope | null\n    if (body && typeof body === 'object' && 'ok' in body) return body\n\n    return {\n      ok: false,\n      requestId: 'unavailable',\n      error: {\n        code: response.ok ? 'invalid_response' : `http_${response.status}`,\n        message: response.ok ? 'Thorbit returned an invalid MCP response' : `Thorbit API request failed with HTTP ${response.status}`,\n      },\n    }\n  }\n}\n","import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js'\nimport type { ZodRawShape } from 'zod'\nimport type { ThorbitContentOnPageApiClient } from './content-onpage-api-client.js'\nimport { formatThorbitContentOnPageMcpToolResult } from './content-onpage-mcp-response-formatters.js'\nimport {\n  ThorbitContentExtractUrlInputSchema,\n  ThorbitContentHarvestSerpInputSchema,\n  ThorbitContentRedditResearchInputSchema,\n  ThorbitOnPageGetAnalysisInputSchema,\n  ThorbitOnPageStartAnalysisInputSchema,\n} from './content-onpage-mcp-tool-schemas.js'\nimport type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nconst VERSION = '0.1.2'\n\ntype ThorbitContentOnPageToolConfig<InputArgs extends ZodRawShape> = {\n  title: string\n  description: string\n  inputSchema: InputArgs\n  annotations: ToolAnnotations\n}\n\nfunction readOnlyAnnotations(title: string, openWorldHint = true) {\n  return {\n    title,\n    readOnlyHint: true,\n    destructiveHint: false,\n    idempotentHint: true,\n    openWorldHint,\n  }\n}\n\nfunction writeAnnotations(title: string, openWorldHint = false) {\n  return {\n    title,\n    readOnlyHint: false,\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint,\n  }\n}\n\nexport function buildThorbitContentOnPageMcpServer(client: ThorbitContentOnPageApiClient): McpServer {\n  const server = new McpServer({ name: 'thorbit-content-mcp', version: VERSION })\n\n  server.registerResource(\n    'analysis',\n    new ResourceTemplate('thorbit-content://analyses/{analysisPublicId}', { list: undefined }),\n    {\n      title: 'Thorbit On-Page Analysis',\n      description: 'Status, score, signal counts, and summary for one Thorbit on-page analysis.',\n      mimeType: 'application/json',\n    },\n    async (uri, variables) => {\n      const analysisPublicId = Array.isArray(variables.analysisPublicId)\n        ? variables.analysisPublicId[0]\n        : variables.analysisPublicId\n      const envelope = await client.callTool('thorbit_onpage_get_analysis', { analysisPublicId: String(analysisPublicId) })\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  function registerTool<T extends ThorbitContentOnPageMcpToolName>(\n    toolName: T,\n    config: ThorbitContentOnPageToolConfig<ZodRawShape>,\n  ): void {\n    server.registerTool(toolName, config, async (input) => {\n      const envelope = await client.callTool(toolName, input)\n      return formatThorbitContentOnPageMcpToolResult(toolName, envelope)\n    })\n  }\n\n  registerTool('thorbit_content_extract_url', {\n    title: 'Extract URL For Content Analysis',\n    description: 'Extract a public URL through MCP Scraper only. Use this before content audits, source ingestion, outline planning, or on-page comparisons. Browser fallback is enabled by default for JS-heavy pages.',\n    inputSchema: ThorbitContentExtractUrlInputSchema,\n    annotations: readOnlyAnnotations('Extract URL For Content Analysis'),\n  })\n\n  registerTool('thorbit_content_harvest_serp', {\n    title: 'Harvest SERP And PAA Evidence',\n    description: 'Harvest Google SERP/PAA evidence through MCP Scraper only. Returns the full evidence surface from MCP Scraper: PAA flat questions, PAA tree, organic SERP, local pack, videos/shorts, forums, whatPeopleSaying, AI Overview text/citations/sections, AI Mode, entity IDs, stats, diagnostics, and retry attempts. Split topic from location when possible. Keep proxyMode as location for US city/state SERPs so MCP Scraper rotates fresh residential proxy IDs and browser sessions across retryable CAPTCHA, proxy tunnel, proxy availability, and location-mismatch failures. Pass proxyZip for known city-center ZIP targeting and debug true when retry/proxy diagnostics are needed.',\n    inputSchema: ThorbitContentHarvestSerpInputSchema,\n    annotations: readOnlyAnnotations('Harvest SERP And PAA Evidence'),\n  })\n\n  registerTool('thorbit_content_reddit_research', {\n    title: 'Research Reddit With MCP Scraper Browser Agent',\n    description: 'Find Reddit candidates through MCP Scraper SERP harvest, then read selected posts through MCP Scraper browser-agent by default. Use for authentic audience language, objections, pain points, and questions. Keep proxyMode as location and pass location/proxyZip when the Reddit research has a local market. Do not use generic web scraping fallbacks for Reddit.',\n    inputSchema: ThorbitContentRedditResearchInputSchema,\n    annotations: readOnlyAnnotations('Research Reddit With Browser Agent'),\n  })\n\n  registerTool('thorbit_onpage_start_analysis', {\n    title: 'Start Thorbit On-Page Analysis',\n    description: 'Start a Thorbit on-page analysis for a project keyword. Can run keyword-only analysis or score provided inline content. Hosted Thorbit dispatches the durable analysis workflow and meters usage against the MCP API key.',\n    inputSchema: ThorbitOnPageStartAnalysisInputSchema,\n    annotations: writeAnnotations('Start Thorbit On-Page Analysis'),\n  })\n\n  registerTool('thorbit_onpage_get_analysis', {\n    title: 'Read Thorbit On-Page Analysis',\n    description: 'Read persisted on-page analysis status, score, signal counts, and content report summary by analysis public ID. Use after thorbit_onpage_start_analysis to poll durable results.',\n    inputSchema: ThorbitOnPageGetAnalysisInputSchema,\n    annotations: readOnlyAnnotations('Read Thorbit On-Page Analysis', false),\n  })\n\n  return server\n}\n","import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js'\nimport type { ThorbitContentOnPageMcpEnvelope } from './content-onpage-api-client.js'\nimport type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nexport function formatThorbitContentOnPageMcpToolResult(\n  toolName: ThorbitContentOnPageMcpToolName,\n  envelope: ThorbitContentOnPageMcpEnvelope,\n): CallToolResult {\n  const text = JSON.stringify({\n    toolName,\n    ...envelope,\n  }, null, 2)\n  return {\n    content: [{ type: 'text', text }],\n    isError: !envelope.ok,\n  }\n}\n","import { z } from 'zod'\n\nexport const ThorbitContentExtractUrlInputSchema = {\n  url: z.string().url().describe('Public URL to extract through MCP Scraper.'),\n  browserFallback: z.boolean().default(true).describe('Use MCP Scraper browser fallback for JS-heavy pages. Default true.'),\n  extractBranding: z.boolean().default(false).describe('Ask MCP Scraper to extract brand colors, fonts, logo, and favicon when supported.'),\n  downloadMedia: z.boolean().default(false).describe('Ask MCP Scraper to download page media when supported.'),\n  maxCharacters: z.number().int().min(500).max(500000).default(80000).describe('Maximum extracted content characters returned to the MCP caller.'),\n}\n\nconst McpScraperProxyModeSchema = z.enum(['location', 'configured', 'none'])\nconst McpScraperSerpDeviceSchema = z.enum(['desktop', 'mobile'])\n\nexport const ThorbitContentHarvestSerpInputSchema = {\n  query: z.string().min(1).max(400).describe('Core search topic. Separate location when possible, e.g. query=\"best CRM\" and location=\"Denver, CO\".'),\n  location: z.string().min(1).max(160).optional().describe('Optional search location, such as Denver, CO. Required for precise residential proxy targeting.'),\n  gl: z.string().length(2).optional().describe('Optional Google country code, such as us.'),\n  hl: z.string().min(2).max(12).optional().describe('Optional Google interface language, such as en.'),\n  device: McpScraperSerpDeviceSchema.default('desktop').describe('SERP device context. Use desktop by default; use mobile only when requested.'),\n  maxQuestions: z.number().int().min(1).max(200).default(30).describe('Maximum PAA questions when serpOnly is false.'),\n  includeSerp: z.boolean().default(true).describe('Include organic SERP results. Default true.'),\n  serpOnly: z.boolean().default(false).describe('Use fast SERP-only mode when PAA expansion is not needed.'),\n  proxyMode: McpScraperProxyModeSchema.default('location').describe('MCP Scraper proxy mode. Use location by default for US city/state SERPs so MCP Scraper rotates fresh residential proxy IDs and browser sessions across retryable CAPTCHA/proxy/location failures.'),\n  proxyZip: z.string().regex(/^\\d{5}$/).optional().describe('Optional US ZIP override for residential location proxy targeting. Use when a specific ZIP or city-center ZIP is known.'),\n  debug: z.boolean().default(false).describe('Include sanitized MCP Scraper browser/proxy/location diagnostics and attempt telemetry. Use true when debugging CAPTCHA, proxy selection, or localization.'),\n  pages: z.number().int().min(1).max(2).default(1).describe('Number of Google result pages to fetch in SERP-only mode.'),\n}\n\nexport const ThorbitContentRedditResearchInputSchema = {\n  query: z.string().min(1).max(400).describe('Topic, product, service, or pain point to research on Reddit.'),\n  location: z.string().min(1).max(160).optional().describe('Optional location to bias MCP Scraper SERP discovery and residential proxy targeting.'),\n  gl: z.string().length(2).optional().describe('Optional Google country code, such as us.'),\n  hl: z.string().min(2).max(12).optional().describe('Optional Google interface language, such as en.'),\n  device: McpScraperSerpDeviceSchema.default('desktop').describe('SERP device context for Reddit discovery.'),\n  proxyMode: McpScraperProxyModeSchema.default('location').describe('MCP Scraper proxy mode for Reddit discovery. Use location by default so MCP Scraper owns CAPTCHA/proxy retries.'),\n  proxyZip: z.string().regex(/^\\d{5}$/).optional().describe('Optional US ZIP override for residential location proxy targeting.'),\n  debug: z.boolean().default(false).describe('Include sanitized MCP Scraper retry/proxy diagnostics for Reddit discovery.'),\n  maxPosts: z.number().int().min(1).max(10).default(5).describe('Maximum Reddit posts to read with MCP Scraper browser-agent.'),\n  readWithBrowserAgent: z.boolean().default(true).describe('Keep true. Reads Reddit candidates through MCP Scraper browser-agent.'),\n  profile: z.string().min(1).max(128).optional().describe('Optional MCP Scraper browser-agent saved profile name.'),\n}\n\nexport const ThorbitOnPageStartAnalysisInputSchema = {\n  projectPublicId: z.string().min(1).describe('Thorbit project public ID.'),\n  keyword: z.string().min(1).max(200).describe('Target keyword or query for on-page analysis.'),\n  force: z.boolean().default(false).describe('Force restart if an analysis is already running.'),\n  source: z.discriminatedUnion('mode', [\n    z.object({ mode: z.literal('keyword_only') }).strict(),\n    z.object({\n      mode: z.literal('inline_content'),\n      title: z.string().min(1).max(255).optional(),\n      text: z.string().min(20).max(500000),\n      sourceUrl: z.string().url().optional(),\n    }).strict(),\n  ]).default({ mode: 'keyword_only' }).describe('Use keyword_only for research-only analysis or inline_content to score provided content.'),\n}\n\nexport const ThorbitOnPageGetAnalysisInputSchema = {\n  analysisPublicId: z.string().min(1).describe('On-page analysis public ID returned by thorbit_onpage_start_analysis.'),\n}\n\nexport const ThorbitContentOnPageMcpToolInputSchemas = {\n  thorbit_content_extract_url: ThorbitContentExtractUrlInputSchema,\n  thorbit_content_harvest_serp: ThorbitContentHarvestSerpInputSchema,\n  thorbit_content_reddit_research: ThorbitContentRedditResearchInputSchema,\n  thorbit_onpage_start_analysis: ThorbitOnPageStartAnalysisInputSchema,\n  thorbit_onpage_get_analysis: ThorbitOnPageGetAnalysisInputSchema,\n}\n","import { readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\nexport type ThorbitContentOnPageMcpEnv = {\n  apiKey: string\n  baseUrl: string\n}\n\nfunction readApiKeyFile(): string | undefined {\n  const explicitPath = process.env.THORBIT_CONTENT_MCP_KEY_PATH?.trim()\n  const paths = [explicitPath, join(homedir(), '.thorbit-content-mcp-key')].filter(Boolean) as string[]\n  for (const path of paths) {\n    try {\n      const value = readFileSync(path, 'utf8').trim()\n      if (value) return value\n    } catch {\n      continue\n    }\n  }\n  return undefined\n}\n\nexport function resolveThorbitContentOnPageMcpEnv(): ThorbitContentOnPageMcpEnv {\n  const apiKey = (\n    process.env.THORBIT_API_KEY ||\n    process.env.THORBIT_MCP_API_KEY ||\n    process.env.THORBIT_CONTENT_MCP_API_KEY ||\n    readApiKeyFile()\n  )?.trim()\n\n  if (!apiKey) {\n    throw new Error('THORBIT_API_KEY, THORBIT_MCP_API_KEY, or ~/.thorbit-content-mcp-key is required')\n  }\n\n  return {\n    apiKey,\n    baseUrl: (process.env.THORBIT_BASE_URL || process.env.THORBIT_CONTENT_MCP_BASE_URL || 'https://thorbit.ai').trim(),\n  }\n}\n","export const ThorbitContentOnPageMcpToolNames = [\n  'thorbit_content_extract_url',\n  'thorbit_content_harvest_serp',\n  'thorbit_content_reddit_research',\n  'thorbit_onpage_start_analysis',\n  'thorbit_onpage_get_analysis',\n] as const\n\nexport type ThorbitContentOnPageMcpToolName = typeof ThorbitContentOnPageMcpToolNames[number]\n"],"mappings":"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","names":[]}

package/dist/index.js

@@ -54,18 +54,31 @@ var ThorbitContentExtractUrlInputSchema = {
   downloadMedia: z.boolean().default(false).describe("Ask MCP Scraper to download page media when supported."),
   maxCharacters: z.number().int().min(500).max(5e5).default(8e4).describe("Maximum extracted content characters returned to the MCP caller.")
 };
+var McpScraperProxyModeSchema = z.enum(["location", "configured", "none"]);
+var McpScraperSerpDeviceSchema = z.enum(["desktop", "mobile"]);
 var ThorbitContentHarvestSerpInputSchema = {
-  query: z.string().min(1).max(400).describe("Search query for MCP Scraper SERP/PAA harvest."),
-  location: z.string().min(1).max(160).optional().describe("Optional search location, such as Denver, Colorado, United States."),
+  query: z.string().min(1).max(400).describe('Core search topic. Separate location when possible, e.g. query="best CRM" and location="Denver, CO".'),
+  location: z.string().min(1).max(160).optional().describe("Optional search location, such as Denver, CO. Required for precise residential proxy targeting."),
   gl: z.string().length(2).optional().describe("Optional Google country code, such as us."),
   hl: z.string().min(2).max(12).optional().describe("Optional Google interface language, such as en."),
-  maxQuestions: z.number().int().min(1).max(150).default(30).describe("Maximum PAA questions when serpOnly is false."),
+  device: McpScraperSerpDeviceSchema.default("desktop").describe("SERP device context. Use desktop by default; use mobile only when requested."),
+  maxQuestions: z.number().int().min(1).max(200).default(30).describe("Maximum PAA questions when serpOnly is false."),
   includeSerp: z.boolean().default(true).describe("Include organic SERP results. Default true."),
-  serpOnly: z.boolean().default(false).describe("Use fast SERP-only mode when PAA expansion is not needed.")
+  serpOnly: z.boolean().default(false).describe("Use fast SERP-only mode when PAA expansion is not needed."),
+  proxyMode: McpScraperProxyModeSchema.default("location").describe("MCP Scraper proxy mode. Use location by default for US city/state SERPs so MCP Scraper rotates fresh residential proxy IDs and browser sessions across retryable CAPTCHA/proxy/location failures."),
+  proxyZip: z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting. Use when a specific ZIP or city-center ZIP is known."),
+  debug: z.boolean().default(false).describe("Include sanitized MCP Scraper browser/proxy/location diagnostics and attempt telemetry. Use true when debugging CAPTCHA, proxy selection, or localization."),
+  pages: z.number().int().min(1).max(2).default(1).describe("Number of Google result pages to fetch in SERP-only mode.")
 };
 var ThorbitContentRedditResearchInputSchema = {
   query: z.string().min(1).max(400).describe("Topic, product, service, or pain point to research on Reddit."),
-  location: z.string().min(1).max(160).optional().describe("Optional location to bias MCP Scraper SERP discovery."),
+  location: z.string().min(1).max(160).optional().describe("Optional location to bias MCP Scraper SERP discovery and residential proxy targeting."),
+  gl: z.string().length(2).optional().describe("Optional Google country code, such as us."),
+  hl: z.string().min(2).max(12).optional().describe("Optional Google interface language, such as en."),
+  device: McpScraperSerpDeviceSchema.default("desktop").describe("SERP device context for Reddit discovery."),
+  proxyMode: McpScraperProxyModeSchema.default("location").describe("MCP Scraper proxy mode for Reddit discovery. Use location by default so MCP Scraper owns CAPTCHA/proxy retries."),
+  proxyZip: z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override for residential location proxy targeting."),
+  debug: z.boolean().default(false).describe("Include sanitized MCP Scraper retry/proxy diagnostics for Reddit discovery."),
   maxPosts: z.number().int().min(1).max(10).default(5).describe("Maximum Reddit posts to read with MCP Scraper browser-agent."),
   readWithBrowserAgent: z.boolean().default(true).describe("Keep true. Reads Reddit candidates through MCP Scraper browser-agent."),
   profile: z.string().min(1).max(128).optional().describe("Optional MCP Scraper browser-agent saved profile name.")
@@ -89,7 +102,7 @@ var ThorbitOnPageGetAnalysisInputSchema = {
 };
 
 // src/content-onpage-mcp-server.ts
-var VERSION = "0.1.0";
+var VERSION = "0.1.2";
 function readOnlyAnnotations(title, openWorldHint = true) {
   return {
     title,
@@ -138,13 +151,13 @@ function buildThorbitContentOnPageMcpServer(client) {
   });
   registerTool("thorbit_content_harvest_serp", {
     title: "Harvest SERP And PAA Evidence",
-    description: "Harvest Google SERP/PAA evidence through MCP Scraper only. Returns PAA questions, organic results, forums, videos, AI Overview fields when available, and provider stats for source-backed content strategy.",
+    description: "Harvest Google SERP/PAA evidence through MCP Scraper only. Returns the full evidence surface from MCP Scraper: PAA flat questions, PAA tree, organic SERP, local pack, videos/shorts, forums, whatPeopleSaying, AI Overview text/citations/sections, AI Mode, entity IDs, stats, diagnostics, and retry attempts. Split topic from location when possible. Keep proxyMode as location for US city/state SERPs so MCP Scraper rotates fresh residential proxy IDs and browser sessions across retryable CAPTCHA, proxy tunnel, proxy availability, and location-mismatch failures. Pass proxyZip for known city-center ZIP targeting and debug true when retry/proxy diagnostics are needed.",
     inputSchema: ThorbitContentHarvestSerpInputSchema,
     annotations: readOnlyAnnotations("Harvest SERP And PAA Evidence")
   });
   registerTool("thorbit_content_reddit_research", {
     title: "Research Reddit With MCP Scraper Browser Agent",
-    description: "Find Reddit candidates through MCP Scraper SERP harvest, then read selected posts through MCP Scraper browser-agent by default. Use for authentic audience language, objections, pain points, and questions. Do not use generic web scraping fallbacks for Reddit.",
+    description: "Find Reddit candidates through MCP Scraper SERP harvest, then read selected posts through MCP Scraper browser-agent by default. Use for authentic audience language, objections, pain points, and questions. Keep proxyMode as location and pass location/proxyZip when the Reddit research has a local market. Do not use generic web scraping fallbacks for Reddit.",
     inputSchema: ThorbitContentRedditResearchInputSchema,
     annotations: readOnlyAnnotations("Research Reddit With Browser Agent")
   });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/content-onpage-api-client.ts","../src/content-onpage-mcp-server.ts","../src/content-onpage-mcp-response-formatters.ts","../src/content-onpage-mcp-tool-schemas.ts","../src/content-onpage-mcp-env.ts","../src/content-onpage-mcp-tool-names.ts"],"sourcesContent":["import type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nexport type ThorbitContentOnPageMcpEnvelope =\n  | {\n      ok: true\n      result: unknown\n      warnings?: string[]\n      requestId: string\n      usage?: Record<string, unknown>\n    }\n  | {\n      ok: false\n      error: {\n        code: string\n        message: string\n        details?: unknown\n      }\n      requestId: string\n    }\n\nexport class ThorbitContentOnPageApiClient {\n  private readonly baseUrl: string\n  private readonly apiKey: string\n\n  constructor(options: { baseUrl: string; apiKey: string }) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '')\n    this.apiKey = options.apiKey\n  }\n\n  async callTool(toolName: ThorbitContentOnPageMcpToolName, input: unknown): Promise<ThorbitContentOnPageMcpEnvelope> {\n    const response = await fetch(`${this.baseUrl}/api/v1/mcp/content-onpage/${toolName}`, {\n      method: 'POST',\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(input ?? {}),\n    })\n\n    const body = await response.json().catch(() => null) as ThorbitContentOnPageMcpEnvelope | null\n    if (body && typeof body === 'object' && 'ok' in body) return body\n\n    return {\n      ok: false,\n      requestId: 'unavailable',\n      error: {\n        code: response.ok ? 'invalid_response' : `http_${response.status}`,\n        message: response.ok ? 'Thorbit returned an invalid MCP response' : `Thorbit API request failed with HTTP ${response.status}`,\n      },\n    }\n  }\n}\n","import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js'\nimport type { ZodRawShape } from 'zod'\nimport type { ThorbitContentOnPageApiClient } from './content-onpage-api-client.js'\nimport { formatThorbitContentOnPageMcpToolResult } from './content-onpage-mcp-response-formatters.js'\nimport {\n  ThorbitContentExtractUrlInputSchema,\n  ThorbitContentHarvestSerpInputSchema,\n  ThorbitContentRedditResearchInputSchema,\n  ThorbitOnPageGetAnalysisInputSchema,\n  ThorbitOnPageStartAnalysisInputSchema,\n} from './content-onpage-mcp-tool-schemas.js'\nimport type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nconst VERSION = '0.1.0'\n\ntype ThorbitContentOnPageToolConfig<InputArgs extends ZodRawShape> = {\n  title: string\n  description: string\n  inputSchema: InputArgs\n  annotations: ToolAnnotations\n}\n\nfunction readOnlyAnnotations(title: string, openWorldHint = true) {\n  return {\n    title,\n    readOnlyHint: true,\n    destructiveHint: false,\n    idempotentHint: true,\n    openWorldHint,\n  }\n}\n\nfunction writeAnnotations(title: string, openWorldHint = false) {\n  return {\n    title,\n    readOnlyHint: false,\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint,\n  }\n}\n\nexport function buildThorbitContentOnPageMcpServer(client: ThorbitContentOnPageApiClient): McpServer {\n  const server = new McpServer({ name: 'thorbit-content-mcp', version: VERSION })\n\n  server.registerResource(\n    'analysis',\n    new ResourceTemplate('thorbit-content://analyses/{analysisPublicId}', { list: undefined }),\n    {\n      title: 'Thorbit On-Page Analysis',\n      description: 'Status, score, signal counts, and summary for one Thorbit on-page analysis.',\n      mimeType: 'application/json',\n    },\n    async (uri, variables) => {\n      const analysisPublicId = Array.isArray(variables.analysisPublicId)\n        ? variables.analysisPublicId[0]\n        : variables.analysisPublicId\n      const envelope = await client.callTool('thorbit_onpage_get_analysis', { analysisPublicId: String(analysisPublicId) })\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  function registerTool<T extends ThorbitContentOnPageMcpToolName>(\n    toolName: T,\n    config: ThorbitContentOnPageToolConfig<ZodRawShape>,\n  ): void {\n    server.registerTool(toolName, config, async (input) => {\n      const envelope = await client.callTool(toolName, input)\n      return formatThorbitContentOnPageMcpToolResult(toolName, envelope)\n    })\n  }\n\n  registerTool('thorbit_content_extract_url', {\n    title: 'Extract URL For Content Analysis',\n    description: 'Extract a public URL through MCP Scraper only. Use this before content audits, source ingestion, outline planning, or on-page comparisons. Browser fallback is enabled by default for JS-heavy pages.',\n    inputSchema: ThorbitContentExtractUrlInputSchema,\n    annotations: readOnlyAnnotations('Extract URL For Content Analysis'),\n  })\n\n  registerTool('thorbit_content_harvest_serp', {\n    title: 'Harvest SERP And PAA Evidence',\n    description: 'Harvest Google SERP/PAA evidence through MCP Scraper only. Returns PAA questions, organic results, forums, videos, AI Overview fields when available, and provider stats for source-backed content strategy.',\n    inputSchema: ThorbitContentHarvestSerpInputSchema,\n    annotations: readOnlyAnnotations('Harvest SERP And PAA Evidence'),\n  })\n\n  registerTool('thorbit_content_reddit_research', {\n    title: 'Research Reddit With MCP Scraper Browser Agent',\n    description: 'Find Reddit candidates through MCP Scraper SERP harvest, then read selected posts through MCP Scraper browser-agent by default. Use for authentic audience language, objections, pain points, and questions. Do not use generic web scraping fallbacks for Reddit.',\n    inputSchema: ThorbitContentRedditResearchInputSchema,\n    annotations: readOnlyAnnotations('Research Reddit With Browser Agent'),\n  })\n\n  registerTool('thorbit_onpage_start_analysis', {\n    title: 'Start Thorbit On-Page Analysis',\n    description: 'Start a Thorbit on-page analysis for a project keyword. Can run keyword-only analysis or score provided inline content. Hosted Thorbit dispatches the durable analysis workflow and meters usage against the MCP API key.',\n    inputSchema: ThorbitOnPageStartAnalysisInputSchema,\n    annotations: writeAnnotations('Start Thorbit On-Page Analysis'),\n  })\n\n  registerTool('thorbit_onpage_get_analysis', {\n    title: 'Read Thorbit On-Page Analysis',\n    description: 'Read persisted on-page analysis status, score, signal counts, and content report summary by analysis public ID. Use after thorbit_onpage_start_analysis to poll durable results.',\n    inputSchema: ThorbitOnPageGetAnalysisInputSchema,\n    annotations: readOnlyAnnotations('Read Thorbit On-Page Analysis', false),\n  })\n\n  return server\n}\n","import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js'\nimport type { ThorbitContentOnPageMcpEnvelope } from './content-onpage-api-client.js'\nimport type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nexport function formatThorbitContentOnPageMcpToolResult(\n  toolName: ThorbitContentOnPageMcpToolName,\n  envelope: ThorbitContentOnPageMcpEnvelope,\n): CallToolResult {\n  const text = JSON.stringify({\n    toolName,\n    ...envelope,\n  }, null, 2)\n  return {\n    content: [{ type: 'text', text }],\n    isError: !envelope.ok,\n  }\n}\n","import { z } from 'zod'\n\nexport const ThorbitContentExtractUrlInputSchema = {\n  url: z.string().url().describe('Public URL to extract through MCP Scraper.'),\n  browserFallback: z.boolean().default(true).describe('Use MCP Scraper browser fallback for JS-heavy pages. Default true.'),\n  extractBranding: z.boolean().default(false).describe('Ask MCP Scraper to extract brand colors, fonts, logo, and favicon when supported.'),\n  downloadMedia: z.boolean().default(false).describe('Ask MCP Scraper to download page media when supported.'),\n  maxCharacters: z.number().int().min(500).max(500000).default(80000).describe('Maximum extracted content characters returned to the MCP caller.'),\n}\n\nexport const ThorbitContentHarvestSerpInputSchema = {\n  query: z.string().min(1).max(400).describe('Search query for MCP Scraper SERP/PAA harvest.'),\n  location: z.string().min(1).max(160).optional().describe('Optional search location, such as Denver, Colorado, United States.'),\n  gl: z.string().length(2).optional().describe('Optional Google country code, such as us.'),\n  hl: z.string().min(2).max(12).optional().describe('Optional Google interface language, such as en.'),\n  maxQuestions: z.number().int().min(1).max(150).default(30).describe('Maximum PAA questions when serpOnly is false.'),\n  includeSerp: z.boolean().default(true).describe('Include organic SERP results. Default true.'),\n  serpOnly: z.boolean().default(false).describe('Use fast SERP-only mode when PAA expansion is not needed.'),\n}\n\nexport const ThorbitContentRedditResearchInputSchema = {\n  query: z.string().min(1).max(400).describe('Topic, product, service, or pain point to research on Reddit.'),\n  location: z.string().min(1).max(160).optional().describe('Optional location to bias MCP Scraper SERP discovery.'),\n  maxPosts: z.number().int().min(1).max(10).default(5).describe('Maximum Reddit posts to read with MCP Scraper browser-agent.'),\n  readWithBrowserAgent: z.boolean().default(true).describe('Keep true. Reads Reddit candidates through MCP Scraper browser-agent.'),\n  profile: z.string().min(1).max(128).optional().describe('Optional MCP Scraper browser-agent saved profile name.'),\n}\n\nexport const ThorbitOnPageStartAnalysisInputSchema = {\n  projectPublicId: z.string().min(1).describe('Thorbit project public ID.'),\n  keyword: z.string().min(1).max(200).describe('Target keyword or query for on-page analysis.'),\n  force: z.boolean().default(false).describe('Force restart if an analysis is already running.'),\n  source: z.discriminatedUnion('mode', [\n    z.object({ mode: z.literal('keyword_only') }).strict(),\n    z.object({\n      mode: z.literal('inline_content'),\n      title: z.string().min(1).max(255).optional(),\n      text: z.string().min(20).max(500000),\n      sourceUrl: z.string().url().optional(),\n    }).strict(),\n  ]).default({ mode: 'keyword_only' }).describe('Use keyword_only for research-only analysis or inline_content to score provided content.'),\n}\n\nexport const ThorbitOnPageGetAnalysisInputSchema = {\n  analysisPublicId: z.string().min(1).describe('On-page analysis public ID returned by thorbit_onpage_start_analysis.'),\n}\n\nexport const ThorbitContentOnPageMcpToolInputSchemas = {\n  thorbit_content_extract_url: ThorbitContentExtractUrlInputSchema,\n  thorbit_content_harvest_serp: ThorbitContentHarvestSerpInputSchema,\n  thorbit_content_reddit_research: ThorbitContentRedditResearchInputSchema,\n  thorbit_onpage_start_analysis: ThorbitOnPageStartAnalysisInputSchema,\n  thorbit_onpage_get_analysis: ThorbitOnPageGetAnalysisInputSchema,\n}\n","import { readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\nexport type ThorbitContentOnPageMcpEnv = {\n  apiKey: string\n  baseUrl: string\n}\n\nfunction readApiKeyFile(): string | undefined {\n  const explicitPath = process.env.THORBIT_CONTENT_MCP_KEY_PATH?.trim()\n  const paths = [explicitPath, join(homedir(), '.thorbit-content-mcp-key')].filter(Boolean) as string[]\n  for (const path of paths) {\n    try {\n      const value = readFileSync(path, 'utf8').trim()\n      if (value) return value\n    } catch {\n      continue\n    }\n  }\n  return undefined\n}\n\nexport function resolveThorbitContentOnPageMcpEnv(): ThorbitContentOnPageMcpEnv {\n  const apiKey = (\n    process.env.THORBIT_API_KEY ||\n    process.env.THORBIT_MCP_API_KEY ||\n    process.env.THORBIT_CONTENT_MCP_API_KEY ||\n    readApiKeyFile()\n  )?.trim()\n\n  if (!apiKey) {\n    throw new Error('THORBIT_API_KEY, THORBIT_MCP_API_KEY, or ~/.thorbit-content-mcp-key is required')\n  }\n\n  return {\n    apiKey,\n    baseUrl: (process.env.THORBIT_BASE_URL || process.env.THORBIT_CONTENT_MCP_BASE_URL || 'https://thorbit.ai').trim(),\n  }\n}\n","export const ThorbitContentOnPageMcpToolNames = [\n  'thorbit_content_extract_url',\n  'thorbit_content_harvest_serp',\n  'thorbit_content_reddit_research',\n  'thorbit_onpage_start_analysis',\n  'thorbit_onpage_get_analysis',\n] as const\n\nexport type ThorbitContentOnPageMcpToolName = typeof ThorbitContentOnPageMcpToolNames[number]\n"],"mappings":";;;AAoBO,IAAM,gCAAN,MAAoC;AAAA,EACxB;AAAA,EACA;AAAA,EAEjB,YAAY,SAA8C;AACxD,SAAK,UAAU,QAAQ,QAAQ,QAAQ,OAAO,EAAE;AAChD,SAAK,SAAS,QAAQ;AAAA,EACxB;AAAA,EAEA,MAAM,SAAS,UAA2C,OAA0D;AAClH,UAAM,WAAW,MAAM,MAAM,GAAG,KAAK,OAAO,8BAA8B,QAAQ,IAAI;AAAA,MACpF,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,eAAe,UAAU,KAAK,MAAM;AAAA,QACpC,gBAAgB;AAAA,MAClB;AAAA,MACA,MAAM,KAAK,UAAU,SAAS,CAAC,CAAC;AAAA,IAClC,CAAC;AAED,UAAM,OAAO,MAAM,SAAS,KAAK,EAAE,MAAM,MAAM,IAAI;AACnD,QAAI,QAAQ,OAAO,SAAS,YAAY,QAAQ,KAAM,QAAO;AAE7D,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,WAAW;AAAA,MACX,OAAO;AAAA,QACL,MAAM,SAAS,KAAK,qBAAqB,QAAQ,SAAS,MAAM;AAAA,QAChE,SAAS,SAAS,KAAK,6CAA6C,wCAAwC,SAAS,MAAM;AAAA,MAC7H;AAAA,IACF;AAAA,EACF;AACF;;;ACnDA,SAAS,WAAW,wBAAwB;;;ACIrC,SAAS,wCACd,UACA,UACgB;AAChB,QAAM,OAAO,KAAK,UAAU;AAAA,IAC1B;AAAA,IACA,GAAG;AAAA,EACL,GAAG,MAAM,CAAC;AACV,SAAO;AAAA,IACL,SAAS,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC;AAAA,IAChC,SAAS,CAAC,SAAS;AAAA,EACrB;AACF;;;AChBA,SAAS,SAAS;AAEX,IAAM,sCAAsC;AAAA,EACjD,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,4CAA4C;AAAA,EAC3E,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE,SAAS,oEAAoE;AAAA,EACxH,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,KAAK,EAAE,SAAS,mFAAmF;AAAA,EACxI,eAAe,EAAE,QAAQ,EAAE,QAAQ,KAAK,EAAE,SAAS,wDAAwD;AAAA,EAC3G,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,IAAI,GAAM,EAAE,QAAQ,GAAK,EAAE,SAAS,kEAAkE;AACjJ;AAEO,IAAM,uCAAuC;AAAA,EAClD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,gDAAgD;AAAA,EAC3F,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,oEAAoE;AAAA,EAC7H,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,SAAS,2CAA2C;AAAA,EACxF,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,iDAAiD;AAAA,EACnG,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,QAAQ,EAAE,EAAE,SAAS,+CAA+C;AAAA,EACnH,aAAa,EAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE,SAAS,6CAA6C;AAAA,EAC7F,UAAU,EAAE,QAAQ,EAAE,QAAQ,KAAK,EAAE,SAAS,2DAA2D;AAC3G;AAEO,IAAM,0CAA0C;AAAA,EACrD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,+DAA+D;AAAA,EAC1G,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,uDAAuD;AAAA,EAChH,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,EAAE,SAAS,8DAA8D;AAAA,EAC5H,sBAAsB,EAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE,SAAS,uEAAuE;AAAA,EAChI,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,wDAAwD;AAClH;AAEO,IAAM,wCAAwC;AAAA,EACnD,iBAAiB,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,4BAA4B;AAAA,EACxE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,+CAA+C;AAAA,EAC5F,OAAO,EAAE,QAAQ,EAAE,QAAQ,KAAK,EAAE,SAAS,kDAAkD;AAAA,EAC7F,QAAQ,EAAE,mBAAmB,QAAQ;AAAA,IACnC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,cAAc,EAAE,CAAC,EAAE,OAAO;AAAA,IACrD,EAAE,OAAO;AAAA,MACP,MAAM,EAAE,QAAQ,gBAAgB;AAAA,MAChC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,MAC3C,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,GAAM;AAAA,MACnC,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS;AAAA,IACvC,CAAC,EAAE,OAAO;AAAA,EACZ,CAAC,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC,EAAE,SAAS,0FAA0F;AAC1I;AAEO,IAAM,sCAAsC;AAAA,EACjD,kBAAkB,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,uEAAuE;AACtH;;;AF/BA,IAAM,UAAU;AAShB,SAAS,oBAAoB,OAAe,gBAAgB,MAAM;AAChE,SAAO;AAAA,IACL;AAAA,IACA,cAAc;AAAA,IACd,iBAAiB;AAAA,IACjB,gBAAgB;AAAA,IAChB;AAAA,EACF;AACF;AAEA,SAAS,iBAAiB,OAAe,gBAAgB,OAAO;AAC9D,SAAO;AAAA,IACL;AAAA,IACA,cAAc;AAAA,IACd,iBAAiB;AAAA,IACjB,gBAAgB;AAAA,IAChB;AAAA,EACF;AACF;AAEO,SAAS,mCAAmC,QAAkD;AACnG,QAAM,SAAS,IAAI,UAAU,EAAE,MAAM,uBAAuB,SAAS,QAAQ,CAAC;AAE9E,SAAO;AAAA,IACL;AAAA,IACA,IAAI,iBAAiB,iDAAiD,EAAE,MAAM,OAAU,CAAC;AAAA,IACzF;AAAA,MACE,OAAO;AAAA,MACP,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,OAAO,KAAK,cAAc;AACxB,YAAM,mBAAmB,MAAM,QAAQ,UAAU,gBAAgB,IAC7D,UAAU,iBAAiB,CAAC,IAC5B,UAAU;AACd,YAAM,WAAW,MAAM,OAAO,SAAS,+BAA+B,EAAE,kBAAkB,OAAO,gBAAgB,EAAE,CAAC;AACpH,aAAO,EAAE,UAAU,CAAC,EAAE,KAAK,IAAI,MAAM,UAAU,oBAAoB,MAAM,KAAK,UAAU,UAAU,MAAM,CAAC,EAAE,CAAC,EAAE;AAAA,IAChH;AAAA,EACF;AAEA,WAAS,aACP,UACA,QACM;AACN,WAAO,aAAa,UAAU,QAAQ,OAAO,UAAU;AACrD,YAAM,WAAW,MAAM,OAAO,SAAS,UAAU,KAAK;AACtD,aAAO,wCAAwC,UAAU,QAAQ;AAAA,IACnE,CAAC;AAAA,EACH;AAEA,eAAa,+BAA+B;AAAA,IAC1C,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,oBAAoB,kCAAkC;AAAA,EACrE,CAAC;AAED,eAAa,gCAAgC;AAAA,IAC3C,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,oBAAoB,+BAA+B;AAAA,EAClE,CAAC;AAED,eAAa,mCAAmC;AAAA,IAC9C,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,oBAAoB,oCAAoC;AAAA,EACvE,CAAC;AAED,eAAa,iCAAiC;AAAA,IAC5C,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,iBAAiB,gCAAgC;AAAA,EAChE,CAAC;AAED,eAAa,+BAA+B;AAAA,IAC1C,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,oBAAoB,iCAAiC,KAAK;AAAA,EACzE,CAAC;AAED,SAAO;AACT;;;AG7GA,SAAS,oBAAoB;AAC7B,SAAS,eAAe;AACxB,SAAS,YAAY;AAOrB,SAAS,iBAAqC;AAC5C,QAAM,eAAe,QAAQ,IAAI,8BAA8B,KAAK;AACpE,QAAM,QAAQ,CAAC,cAAc,KAAK,QAAQ,GAAG,0BAA0B,CAAC,EAAE,OAAO,OAAO;AACxF,aAAW,QAAQ,OAAO;AACxB,QAAI;AACF,YAAM,QAAQ,aAAa,MAAM,MAAM,EAAE,KAAK;AAC9C,UAAI,MAAO,QAAO;AAAA,IACpB,QAAQ;AACN;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,oCAAgE;AAC9E,QAAM,UACJ,QAAQ,IAAI,mBACZ,QAAQ,IAAI,uBACZ,QAAQ,IAAI,+BACZ,eAAe,IACd,KAAK;AAER,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,iFAAiF;AAAA,EACnG;AAEA,SAAO;AAAA,IACL;AAAA,IACA,UAAU,QAAQ,IAAI,oBAAoB,QAAQ,IAAI,gCAAgC,sBAAsB,KAAK;AAAA,EACnH;AACF;;;ACvCO,IAAM,mCAAmC;AAAA,EAC9C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;","names":[]}
+{"version":3,"sources":["../src/content-onpage-api-client.ts","../src/content-onpage-mcp-server.ts","../src/content-onpage-mcp-response-formatters.ts","../src/content-onpage-mcp-tool-schemas.ts","../src/content-onpage-mcp-env.ts","../src/content-onpage-mcp-tool-names.ts"],"sourcesContent":["import type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nexport type ThorbitContentOnPageMcpEnvelope =\n  | {\n      ok: true\n      result: unknown\n      warnings?: string[]\n      requestId: string\n      usage?: Record<string, unknown>\n    }\n  | {\n      ok: false\n      error: {\n        code: string\n        message: string\n        details?: unknown\n      }\n      requestId: string\n    }\n\nexport class ThorbitContentOnPageApiClient {\n  private readonly baseUrl: string\n  private readonly apiKey: string\n\n  constructor(options: { baseUrl: string; apiKey: string }) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '')\n    this.apiKey = options.apiKey\n  }\n\n  async callTool(toolName: ThorbitContentOnPageMcpToolName, input: unknown): Promise<ThorbitContentOnPageMcpEnvelope> {\n    const response = await fetch(`${this.baseUrl}/api/v1/mcp/content-onpage/${toolName}`, {\n      method: 'POST',\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(input ?? {}),\n    })\n\n    const body = await response.json().catch(() => null) as ThorbitContentOnPageMcpEnvelope | null\n    if (body && typeof body === 'object' && 'ok' in body) return body\n\n    return {\n      ok: false,\n      requestId: 'unavailable',\n      error: {\n        code: response.ok ? 'invalid_response' : `http_${response.status}`,\n        message: response.ok ? 'Thorbit returned an invalid MCP response' : `Thorbit API request failed with HTTP ${response.status}`,\n      },\n    }\n  }\n}\n","import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js'\nimport type { ZodRawShape } from 'zod'\nimport type { ThorbitContentOnPageApiClient } from './content-onpage-api-client.js'\nimport { formatThorbitContentOnPageMcpToolResult } from './content-onpage-mcp-response-formatters.js'\nimport {\n  ThorbitContentExtractUrlInputSchema,\n  ThorbitContentHarvestSerpInputSchema,\n  ThorbitContentRedditResearchInputSchema,\n  ThorbitOnPageGetAnalysisInputSchema,\n  ThorbitOnPageStartAnalysisInputSchema,\n} from './content-onpage-mcp-tool-schemas.js'\nimport type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nconst VERSION = '0.1.2'\n\ntype ThorbitContentOnPageToolConfig<InputArgs extends ZodRawShape> = {\n  title: string\n  description: string\n  inputSchema: InputArgs\n  annotations: ToolAnnotations\n}\n\nfunction readOnlyAnnotations(title: string, openWorldHint = true) {\n  return {\n    title,\n    readOnlyHint: true,\n    destructiveHint: false,\n    idempotentHint: true,\n    openWorldHint,\n  }\n}\n\nfunction writeAnnotations(title: string, openWorldHint = false) {\n  return {\n    title,\n    readOnlyHint: false,\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint,\n  }\n}\n\nexport function buildThorbitContentOnPageMcpServer(client: ThorbitContentOnPageApiClient): McpServer {\n  const server = new McpServer({ name: 'thorbit-content-mcp', version: VERSION })\n\n  server.registerResource(\n    'analysis',\n    new ResourceTemplate('thorbit-content://analyses/{analysisPublicId}', { list: undefined }),\n    {\n      title: 'Thorbit On-Page Analysis',\n      description: 'Status, score, signal counts, and summary for one Thorbit on-page analysis.',\n      mimeType: 'application/json',\n    },\n    async (uri, variables) => {\n      const analysisPublicId = Array.isArray(variables.analysisPublicId)\n        ? variables.analysisPublicId[0]\n        : variables.analysisPublicId\n      const envelope = await client.callTool('thorbit_onpage_get_analysis', { analysisPublicId: String(analysisPublicId) })\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  function registerTool<T extends ThorbitContentOnPageMcpToolName>(\n    toolName: T,\n    config: ThorbitContentOnPageToolConfig<ZodRawShape>,\n  ): void {\n    server.registerTool(toolName, config, async (input) => {\n      const envelope = await client.callTool(toolName, input)\n      return formatThorbitContentOnPageMcpToolResult(toolName, envelope)\n    })\n  }\n\n  registerTool('thorbit_content_extract_url', {\n    title: 'Extract URL For Content Analysis',\n    description: 'Extract a public URL through MCP Scraper only. Use this before content audits, source ingestion, outline planning, or on-page comparisons. Browser fallback is enabled by default for JS-heavy pages.',\n    inputSchema: ThorbitContentExtractUrlInputSchema,\n    annotations: readOnlyAnnotations('Extract URL For Content Analysis'),\n  })\n\n  registerTool('thorbit_content_harvest_serp', {\n    title: 'Harvest SERP And PAA Evidence',\n    description: 'Harvest Google SERP/PAA evidence through MCP Scraper only. Returns the full evidence surface from MCP Scraper: PAA flat questions, PAA tree, organic SERP, local pack, videos/shorts, forums, whatPeopleSaying, AI Overview text/citations/sections, AI Mode, entity IDs, stats, diagnostics, and retry attempts. Split topic from location when possible. Keep proxyMode as location for US city/state SERPs so MCP Scraper rotates fresh residential proxy IDs and browser sessions across retryable CAPTCHA, proxy tunnel, proxy availability, and location-mismatch failures. Pass proxyZip for known city-center ZIP targeting and debug true when retry/proxy diagnostics are needed.',\n    inputSchema: ThorbitContentHarvestSerpInputSchema,\n    annotations: readOnlyAnnotations('Harvest SERP And PAA Evidence'),\n  })\n\n  registerTool('thorbit_content_reddit_research', {\n    title: 'Research Reddit With MCP Scraper Browser Agent',\n    description: 'Find Reddit candidates through MCP Scraper SERP harvest, then read selected posts through MCP Scraper browser-agent by default. Use for authentic audience language, objections, pain points, and questions. Keep proxyMode as location and pass location/proxyZip when the Reddit research has a local market. Do not use generic web scraping fallbacks for Reddit.',\n    inputSchema: ThorbitContentRedditResearchInputSchema,\n    annotations: readOnlyAnnotations('Research Reddit With Browser Agent'),\n  })\n\n  registerTool('thorbit_onpage_start_analysis', {\n    title: 'Start Thorbit On-Page Analysis',\n    description: 'Start a Thorbit on-page analysis for a project keyword. Can run keyword-only analysis or score provided inline content. Hosted Thorbit dispatches the durable analysis workflow and meters usage against the MCP API key.',\n    inputSchema: ThorbitOnPageStartAnalysisInputSchema,\n    annotations: writeAnnotations('Start Thorbit On-Page Analysis'),\n  })\n\n  registerTool('thorbit_onpage_get_analysis', {\n    title: 'Read Thorbit On-Page Analysis',\n    description: 'Read persisted on-page analysis status, score, signal counts, and content report summary by analysis public ID. Use after thorbit_onpage_start_analysis to poll durable results.',\n    inputSchema: ThorbitOnPageGetAnalysisInputSchema,\n    annotations: readOnlyAnnotations('Read Thorbit On-Page Analysis', false),\n  })\n\n  return server\n}\n","import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js'\nimport type { ThorbitContentOnPageMcpEnvelope } from './content-onpage-api-client.js'\nimport type { ThorbitContentOnPageMcpToolName } from './content-onpage-mcp-tool-names.js'\n\nexport function formatThorbitContentOnPageMcpToolResult(\n  toolName: ThorbitContentOnPageMcpToolName,\n  envelope: ThorbitContentOnPageMcpEnvelope,\n): CallToolResult {\n  const text = JSON.stringify({\n    toolName,\n    ...envelope,\n  }, null, 2)\n  return {\n    content: [{ type: 'text', text }],\n    isError: !envelope.ok,\n  }\n}\n","import { z } from 'zod'\n\nexport const ThorbitContentExtractUrlInputSchema = {\n  url: z.string().url().describe('Public URL to extract through MCP Scraper.'),\n  browserFallback: z.boolean().default(true).describe('Use MCP Scraper browser fallback for JS-heavy pages. Default true.'),\n  extractBranding: z.boolean().default(false).describe('Ask MCP Scraper to extract brand colors, fonts, logo, and favicon when supported.'),\n  downloadMedia: z.boolean().default(false).describe('Ask MCP Scraper to download page media when supported.'),\n  maxCharacters: z.number().int().min(500).max(500000).default(80000).describe('Maximum extracted content characters returned to the MCP caller.'),\n}\n\nconst McpScraperProxyModeSchema = z.enum(['location', 'configured', 'none'])\nconst McpScraperSerpDeviceSchema = z.enum(['desktop', 'mobile'])\n\nexport const ThorbitContentHarvestSerpInputSchema = {\n  query: z.string().min(1).max(400).describe('Core search topic. Separate location when possible, e.g. query=\"best CRM\" and location=\"Denver, CO\".'),\n  location: z.string().min(1).max(160).optional().describe('Optional search location, such as Denver, CO. Required for precise residential proxy targeting.'),\n  gl: z.string().length(2).optional().describe('Optional Google country code, such as us.'),\n  hl: z.string().min(2).max(12).optional().describe('Optional Google interface language, such as en.'),\n  device: McpScraperSerpDeviceSchema.default('desktop').describe('SERP device context. Use desktop by default; use mobile only when requested.'),\n  maxQuestions: z.number().int().min(1).max(200).default(30).describe('Maximum PAA questions when serpOnly is false.'),\n  includeSerp: z.boolean().default(true).describe('Include organic SERP results. Default true.'),\n  serpOnly: z.boolean().default(false).describe('Use fast SERP-only mode when PAA expansion is not needed.'),\n  proxyMode: McpScraperProxyModeSchema.default('location').describe('MCP Scraper proxy mode. Use location by default for US city/state SERPs so MCP Scraper rotates fresh residential proxy IDs and browser sessions across retryable CAPTCHA/proxy/location failures.'),\n  proxyZip: z.string().regex(/^\\d{5}$/).optional().describe('Optional US ZIP override for residential location proxy targeting. Use when a specific ZIP or city-center ZIP is known.'),\n  debug: z.boolean().default(false).describe('Include sanitized MCP Scraper browser/proxy/location diagnostics and attempt telemetry. Use true when debugging CAPTCHA, proxy selection, or localization.'),\n  pages: z.number().int().min(1).max(2).default(1).describe('Number of Google result pages to fetch in SERP-only mode.'),\n}\n\nexport const ThorbitContentRedditResearchInputSchema = {\n  query: z.string().min(1).max(400).describe('Topic, product, service, or pain point to research on Reddit.'),\n  location: z.string().min(1).max(160).optional().describe('Optional location to bias MCP Scraper SERP discovery and residential proxy targeting.'),\n  gl: z.string().length(2).optional().describe('Optional Google country code, such as us.'),\n  hl: z.string().min(2).max(12).optional().describe('Optional Google interface language, such as en.'),\n  device: McpScraperSerpDeviceSchema.default('desktop').describe('SERP device context for Reddit discovery.'),\n  proxyMode: McpScraperProxyModeSchema.default('location').describe('MCP Scraper proxy mode for Reddit discovery. Use location by default so MCP Scraper owns CAPTCHA/proxy retries.'),\n  proxyZip: z.string().regex(/^\\d{5}$/).optional().describe('Optional US ZIP override for residential location proxy targeting.'),\n  debug: z.boolean().default(false).describe('Include sanitized MCP Scraper retry/proxy diagnostics for Reddit discovery.'),\n  maxPosts: z.number().int().min(1).max(10).default(5).describe('Maximum Reddit posts to read with MCP Scraper browser-agent.'),\n  readWithBrowserAgent: z.boolean().default(true).describe('Keep true. Reads Reddit candidates through MCP Scraper browser-agent.'),\n  profile: z.string().min(1).max(128).optional().describe('Optional MCP Scraper browser-agent saved profile name.'),\n}\n\nexport const ThorbitOnPageStartAnalysisInputSchema = {\n  projectPublicId: z.string().min(1).describe('Thorbit project public ID.'),\n  keyword: z.string().min(1).max(200).describe('Target keyword or query for on-page analysis.'),\n  force: z.boolean().default(false).describe('Force restart if an analysis is already running.'),\n  source: z.discriminatedUnion('mode', [\n    z.object({ mode: z.literal('keyword_only') }).strict(),\n    z.object({\n      mode: z.literal('inline_content'),\n      title: z.string().min(1).max(255).optional(),\n      text: z.string().min(20).max(500000),\n      sourceUrl: z.string().url().optional(),\n    }).strict(),\n  ]).default({ mode: 'keyword_only' }).describe('Use keyword_only for research-only analysis or inline_content to score provided content.'),\n}\n\nexport const ThorbitOnPageGetAnalysisInputSchema = {\n  analysisPublicId: z.string().min(1).describe('On-page analysis public ID returned by thorbit_onpage_start_analysis.'),\n}\n\nexport const ThorbitContentOnPageMcpToolInputSchemas = {\n  thorbit_content_extract_url: ThorbitContentExtractUrlInputSchema,\n  thorbit_content_harvest_serp: ThorbitContentHarvestSerpInputSchema,\n  thorbit_content_reddit_research: ThorbitContentRedditResearchInputSchema,\n  thorbit_onpage_start_analysis: ThorbitOnPageStartAnalysisInputSchema,\n  thorbit_onpage_get_analysis: ThorbitOnPageGetAnalysisInputSchema,\n}\n","import { readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\nexport type ThorbitContentOnPageMcpEnv = {\n  apiKey: string\n  baseUrl: string\n}\n\nfunction readApiKeyFile(): string | undefined {\n  const explicitPath = process.env.THORBIT_CONTENT_MCP_KEY_PATH?.trim()\n  const paths = [explicitPath, join(homedir(), '.thorbit-content-mcp-key')].filter(Boolean) as string[]\n  for (const path of paths) {\n    try {\n      const value = readFileSync(path, 'utf8').trim()\n      if (value) return value\n    } catch {\n      continue\n    }\n  }\n  return undefined\n}\n\nexport function resolveThorbitContentOnPageMcpEnv(): ThorbitContentOnPageMcpEnv {\n  const apiKey = (\n    process.env.THORBIT_API_KEY ||\n    process.env.THORBIT_MCP_API_KEY ||\n    process.env.THORBIT_CONTENT_MCP_API_KEY ||\n    readApiKeyFile()\n  )?.trim()\n\n  if (!apiKey) {\n    throw new Error('THORBIT_API_KEY, THORBIT_MCP_API_KEY, or ~/.thorbit-content-mcp-key is required')\n  }\n\n  return {\n    apiKey,\n    baseUrl: (process.env.THORBIT_BASE_URL || process.env.THORBIT_CONTENT_MCP_BASE_URL || 'https://thorbit.ai').trim(),\n  }\n}\n","export const ThorbitContentOnPageMcpToolNames = [\n  'thorbit_content_extract_url',\n  'thorbit_content_harvest_serp',\n  'thorbit_content_reddit_research',\n  'thorbit_onpage_start_analysis',\n  'thorbit_onpage_get_analysis',\n] as const\n\nexport type ThorbitContentOnPageMcpToolName = typeof ThorbitContentOnPageMcpToolNames[number]\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thorbit-content-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "MCP server for Thorbit content research and on-page analysis tools",
   "type": "module",
   "main": "./dist/index.cjs",