thorbit-content-mcp 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -58,7 +58,7 @@ npx -y -p thorbit-content-mcp@latest thorbit-content-mcp-install --key-path ~/.c
58
58
  ## Tools
59
59
 
60
60
  - `thorbit_content_extract_url`: extract a URL through MCP Scraper.
61
- - `thorbit_content_harvest_serp`: harvest SERP/PAA evidence through MCP Scraper. Supports MCP Scraper `proxyMode`, `proxyZip`, `device`, `pages`, and `debug` controls.
61
+ - `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.
62
62
  - `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.
63
63
  - `thorbit_onpage_start_analysis`: start durable Thorbit on-page analysis for a project keyword or inline content.
64
64
  - `thorbit_onpage_get_analysis`: read persisted analysis status, score, signal counts, and summary.
@@ -305,7 +305,7 @@ function renderInstallInstructions(options) {
305
305
  "",
306
306
  paint("Tools", ansi.terracotta, color),
307
307
  " thorbit_content_extract_url Extract a URL through MCP Scraper.",
308
- " thorbit_content_harvest_serp Harvest SERP/PAA evidence through MCP Scraper.",
308
+ " thorbit_content_harvest_serp Harvest full SERP/PAA evidence through MCP Scraper.",
309
309
  " thorbit_content_reddit_research Read Reddit through MCP Scraper browser-agent.",
310
310
  " thorbit_onpage_start_analysis Start durable Thorbit on-page analysis.",
311
311
  " thorbit_onpage_get_analysis Read analysis status and summary.",
@@ -1 +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":[]}
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 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":[]}
@@ -274,7 +274,7 @@ function renderInstallInstructions(options) {
274
274
  "",
275
275
  paint("Tools", ansi.terracotta, color),
276
276
  " thorbit_content_extract_url Extract a URL through MCP Scraper.",
277
- " thorbit_content_harvest_serp Harvest SERP/PAA evidence through MCP Scraper.",
277
+ " thorbit_content_harvest_serp Harvest full SERP/PAA evidence through MCP Scraper.",
278
278
  " thorbit_content_reddit_research Read Reddit through MCP Scraper browser-agent.",
279
279
  " thorbit_onpage_start_analysis Start durable Thorbit on-page analysis.",
280
280
  " thorbit_onpage_get_analysis Read analysis status and summary.",
@@ -1 +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":[]}
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 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":[]}
@@ -134,7 +134,7 @@ var ThorbitOnPageGetAnalysisInputSchema = {
134
134
  };
135
135
 
136
136
  // src/content-onpage-mcp-server.ts
137
- var VERSION = "0.1.1";
137
+ var VERSION = "0.1.2";
138
138
  function readOnlyAnnotations(title, openWorldHint = true) {
139
139
  return {
140
140
  title,
@@ -183,7 +183,7 @@ function buildThorbitContentOnPageMcpServer(client) {
183
183
  });
184
184
  registerTool("thorbit_content_harvest_serp", {
185
185
  title: "Harvest SERP And PAA Evidence",
186
- description: "Harvest Google SERP/PAA evidence through MCP Scraper only. 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.",
186
+ 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.",
187
187
  inputSchema: ThorbitContentHarvestSerpInputSchema,
188
188
  annotations: readOnlyAnnotations("Harvest SERP And PAA Evidence")
189
189
  });
@@ -1 +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.1'\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. 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":[]}
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.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":[]}
@@ -133,7 +133,7 @@ var ThorbitOnPageGetAnalysisInputSchema = {
133
133
  };
134
134
 
135
135
  // src/content-onpage-mcp-server.ts
136
- var VERSION = "0.1.1";
136
+ var VERSION = "0.1.2";
137
137
  function readOnlyAnnotations(title, openWorldHint = true) {
138
138
  return {
139
139
  title,
@@ -182,7 +182,7 @@ function buildThorbitContentOnPageMcpServer(client) {
182
182
  });
183
183
  registerTool("thorbit_content_harvest_serp", {
184
184
  title: "Harvest SERP And PAA Evidence",
185
- description: "Harvest Google SERP/PAA evidence through MCP Scraper only. 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.",
185
+ 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.",
186
186
  inputSchema: ThorbitContentHarvestSerpInputSchema,
187
187
  annotations: readOnlyAnnotations("Harvest SERP And PAA Evidence")
188
188
  });
@@ -1 +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.1'\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. 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":[]}
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.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/index.cjs CHANGED
@@ -130,7 +130,7 @@ var ThorbitOnPageGetAnalysisInputSchema = {
130
130
  };
131
131
 
132
132
  // src/content-onpage-mcp-server.ts
133
- var VERSION = "0.1.1";
133
+ var VERSION = "0.1.2";
134
134
  function readOnlyAnnotations(title, openWorldHint = true) {
135
135
  return {
136
136
  title,
@@ -179,7 +179,7 @@ function buildThorbitContentOnPageMcpServer(client) {
179
179
  });
180
180
  registerTool("thorbit_content_harvest_serp", {
181
181
  title: "Harvest SERP And PAA Evidence",
182
- description: "Harvest Google SERP/PAA evidence through MCP Scraper only. 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.",
182
+ 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.",
183
183
  inputSchema: ThorbitContentHarvestSerpInputSchema,
184
184
  annotations: readOnlyAnnotations("Harvest SERP And PAA Evidence")
185
185
  });
@@ -1 +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.1'\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. 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":[]}
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.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 CHANGED
@@ -102,7 +102,7 @@ var ThorbitOnPageGetAnalysisInputSchema = {
102
102
  };
103
103
 
104
104
  // src/content-onpage-mcp-server.ts
105
- var VERSION = "0.1.1";
105
+ var VERSION = "0.1.2";
106
106
  function readOnlyAnnotations(title, openWorldHint = true) {
107
107
  return {
108
108
  title,
@@ -151,7 +151,7 @@ function buildThorbitContentOnPageMcpServer(client) {
151
151
  });
152
152
  registerTool("thorbit_content_harvest_serp", {
153
153
  title: "Harvest SERP And PAA Evidence",
154
- description: "Harvest Google SERP/PAA evidence through MCP Scraper only. 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.",
154
+ 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.",
155
155
  inputSchema: ThorbitContentHarvestSerpInputSchema,
156
156
  annotations: readOnlyAnnotations("Harvest SERP And PAA Evidence")
157
157
  });
package/dist/index.js.map CHANGED
@@ -1 +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.1'\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. 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":[]}
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.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 CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "thorbit-content-mcp",
3
- "version": "0.1.1",
3
+ "version": "0.1.2",
4
4
  "description": "MCP server for Thorbit content research and on-page analysis tools",
5
5
  "type": "module",
6
6
  "main": "./dist/index.cjs",