thorbit-content-mcp 0.1.0

package/README.md

@@ -0,0 +1,72 @@
+# Thorbit Content MCP
+
+Local stdio MCP server for Thorbit content research and on-page analysis. The package proxies tool calls to hosted Thorbit API routes; hosted Thorbit handles API-key auth, metering, MCP Scraper extraction, MCP Scraper SERP/PAA harvests, MCP Scraper browser-agent Reddit reads, and durable on-page analysis.
+
+## Install
+
+Generate a Thorbit MCP API key from Thorbit Settings -> MCPs with content/onpage scopes:
+
+- `content_onpage:read`
+- `content_onpage:research`
+- `content_onpage:analyze`
+
+Then run:
+
+```bash
+npx -y thorbit-content-mcp@latest
+```
+
+MCP client example:
+
+```json
+{
+  "mcpServers": {
+    "thorbit-content": {
+      "command": "npx",
+      "args": ["-y", "thorbit-content-mcp@latest"],
+      "env": {
+        "THORBIT_API_KEY": "thbt_mcp_..."
+      }
+    }
+  }
+}
+```
+
+Generate the same JSON from the CLI:
+
+```bash
+npx -y -p thorbit-content-mcp@latest thorbit-content-mcp-install --json --api-key thbt_mcp_...
+```
+
+Prefer a key file on shared machines and servers:
+
+```bash
+mkdir -p ~/.config/thorbit
+printf '%s\n' 'thbt_mcp_...' > ~/.config/thorbit/content-mcp-key
+chmod 600 ~/.config/thorbit/content-mcp-key
+npx -y -p thorbit-content-mcp@latest thorbit-content-mcp-install --key-path ~/.config/thorbit/content-mcp-key
+```
+
+## Environment
+
+- `THORBIT_API_KEY` or `THORBIT_MCP_API_KEY`: raw Thorbit MCP API key.
+- `THORBIT_CONTENT_MCP_API_KEY`: content-specific raw key override.
+- `THORBIT_CONTENT_MCP_KEY_PATH`: file containing the API key. Defaults to `~/.thorbit-content-mcp-key`.
+- `THORBIT_BASE_URL`: Thorbit app URL. Defaults to `https://thorbit.ai`.
+- `THORBIT_CONTENT_MCP_BASE_URL`: content-specific Thorbit app URL override.
+
+## Tools
+
+- `thorbit_content_extract_url`: extract a URL through MCP Scraper.
+- `thorbit_content_harvest_serp`: harvest SERP/PAA evidence through MCP Scraper.
+- `thorbit_content_reddit_research`: discover Reddit candidates with MCP Scraper SERP and read posts through MCP Scraper browser-agent by default.
+- `thorbit_onpage_start_analysis`: start durable Thorbit on-page analysis for a project keyword or inline content.
+- `thorbit_onpage_get_analysis`: read persisted analysis status, score, signal counts, and summary.
+
+## Resources
+
+- `thorbit-content://analyses/{analysisPublicId}`: JSON status and summary for one persisted on-page analysis.
+
+## Metering
+
+The package cannot be used without a Thorbit MCP API key. Hosted Thorbit records MCP tool calls and provider costs against that key. Admin unmetered keys can be generated only through the server-side Thorbit operator script, not through public Settings routes.

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

@@ -0,0 +1,352 @@
+#!/usr/bin/env node
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// bin/thorbit-content-mcp-install.ts
+var thorbit_content_mcp_install_exports = {};
+__export(thorbit_content_mcp_install_exports, {
+  buildMcpConfig: () => buildMcpConfig,
+  hasFlag: () => hasFlag,
+  main: () => main,
+  readArg: () => readArg,
+  renderBanner: () => renderBanner,
+  renderHelp: () => renderHelp,
+  renderInstallInstructions: () => renderInstallInstructions,
+  resolveInstallOptions: () => resolveInstallOptions
+});
+module.exports = __toCommonJS(thorbit_content_mcp_install_exports);
+var import_node_fs = require("fs");
+var import_node_url = require("url");
+var import_meta = {};
+function readArg(name, argv = process.argv.slice(2)) {
+  const prefix = `--${name}=`;
+  const inline = argv.find((arg) => arg.startsWith(prefix));
+  if (inline) return inline.slice(prefix.length);
+  const index = argv.indexOf(`--${name}`);
+  return index >= 0 ? argv[index + 1] : void 0;
+}
+function hasFlag(name, argv = process.argv.slice(2)) {
+  return argv.includes(`--${name}`);
+}
+function resolveInstallOptions(argv = process.argv.slice(2)) {
+  return {
+    apiKey: readArg("api-key", argv) ?? process.env.THORBIT_API_KEY ?? process.env.THORBIT_MCP_API_KEY ?? "thbt_mcp_...",
+    baseUrl: readArg("base-url", argv) ?? process.env.THORBIT_BASE_URL,
+    keyPath: readArg("key-path", argv) ?? process.env.THORBIT_CONTENT_MCP_KEY_PATH,
+    serverName: readArg("server-name", argv) ?? "thorbit-content",
+    json: hasFlag("json", argv),
+    color: !hasFlag("no-color", argv),
+    help: hasFlag("help", argv) || hasFlag("h", argv)
+  };
+}
+function buildMcpConfig(options) {
+  const env = options.keyPath ? { THORBIT_CONTENT_MCP_KEY_PATH: options.keyPath } : { THORBIT_API_KEY: options.apiKey };
+  if (options.baseUrl) {
+    env.THORBIT_BASE_URL = options.baseUrl.replace(/\/$/, "");
+  }
+  return {
+    mcpServers: {
+      [options.serverName]: {
+        command: "npx",
+        args: ["-y", "thorbit-content-mcp@latest"],
+        env
+      }
+    }
+  };
+}
+var ansi = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  terracotta: "\x1B[38;2;198;90;54m",
+  cardBg: "\x1B[48;2;31;31;31m",
+  cardBorder: "\x1B[38;2;108;66;50m",
+  clay: "\x1B[38;2;226;138;92m",
+  cream: "\x1B[38;2;255;244;230m",
+  green: "\x1B[38;2;75;181;67m",
+  shadow: "\x1B[38;2;116;70;56m",
+  slate: "\x1B[38;2;174;181;195m",
+  wire: "\x1B[38;2;198;90;54m"
+};
+function paint(value, code, enabled) {
+  return enabled ? `${code}${value}${ansi.reset}` : value;
+}
+function renderHelp(color) {
+  return [
+    renderBanner(color),
+    "",
+    "Usage:",
+    "  npx -y -p thorbit-content-mcp@latest thorbit-content-mcp-install [options]",
+    "",
+    "Options:",
+    "  --api-key <key>        Thorbit MCP API key from Settings -> MCPs.",
+    "  --key-path <path>      File containing the API key. Preferred for shared machines and servers.",
+    "  --base-url <url>       Thorbit app URL. Defaults to https://thorbit.ai.",
+    "  --server-name <name>   MCP client server name. Defaults to thorbit-content.",
+    "  --json                 Print only MCP client JSON.",
+    "  --no-color             Disable ANSI color.",
+    "  --help                 Show this help.",
+    ""
+  ].join("\n");
+}
+function renderBanner(color) {
+  return color ? renderReferenceCardBanner() : renderAsciiBanner();
+}
+var cardWidth = 104;
+var thorbitPixelLetters = {
+  T: [
+    "1111111",
+    "0011000",
+    "0011000",
+    "0011000",
+    "0011000",
+    "0011000",
+    "0011000"
+  ],
+  H: [
+    "110011",
+    "110011",
+    "110011",
+    "111111",
+    "110011",
+    "110011",
+    "110011"
+  ],
+  O: [
+    "011110",
+    "110011",
+    "110011",
+    "110011",
+    "110011",
+    "110011",
+    "011110"
+  ],
+  R: [
+    "111110",
+    "110011",
+    "110011",
+    "111110",
+    "110110",
+    "110011",
+    "110011"
+  ],
+  B: [
+    "111110",
+    "110011",
+    "110011",
+    "111110",
+    "110011",
+    "110011",
+    "111110"
+  ],
+  I: [
+    "1111",
+    "0110",
+    "0110",
+    "0110",
+    "0110",
+    "0110",
+    "1111"
+  ]
+};
+function renderReferenceCardBanner() {
+  const heading = justifyCardContent("  Plain text", "\u29C9", cardWidth);
+  return [
+    `${ansi.cardBorder}\u256D${"\u2500".repeat(cardWidth + 2)}\u256E${ansi.reset}`,
+    renderCardLine(heading, "title"),
+    renderCardLine("", "blank"),
+    ...renderLayeredPixelWordmarkCardLines("THORBIT"),
+    renderCardLine("", "blank"),
+    renderCardLine("  THORBIT CONTENT MCP", "caption"),
+    `${ansi.cardBorder}\u2570${"\u2500".repeat(cardWidth + 2)}\u256F${ansi.reset}`
+  ].join("\n");
+}
+function renderAsciiBanner() {
+  const contentWidth = 96;
+  const border = `+${"-".repeat(contentWidth + 2)}+`;
+  const cardLine = (content = "") => `| ${content.padEnd(contentWidth)} |`;
+  const title = "Plain text";
+  const copy = "[copy]";
+  const lines = [
+    border,
+    cardLine(`${title}${" ".repeat(contentWidth - title.length - copy.length)}${copy}`),
+    cardLine(),
+    ...renderAsciiWordmark("THORBIT").map((line) => cardLine(`  ${line}`)),
+    cardLine(),
+    cardLine("  THORBIT CONTENT MCP"),
+    border
+  ];
+  return lines.join("\n");
+}
+function renderCardLine(content, tone) {
+  const foreground = {
+    title: ansi.cream,
+    mark: ansi.clay,
+    wire: ansi.wire,
+    caption: ansi.terracotta,
+    blank: ansi.slate
+  }[tone];
+  return renderCardLineParts([{ color: foreground, text: content }]);
+}
+function renderCardLineParts(parts) {
+  const visibleWidth = parts.reduce((width, part) => width + part.text.length, 0);
+  const padding = " ".repeat(Math.max(0, cardWidth - visibleWidth));
+  return [
+    `${ansi.cardBorder}\u2502${ansi.reset}`,
+    ansi.cardBg,
+    " ",
+    ...parts.map((part) => `${part.color}${part.text}`),
+    padding,
+    " ",
+    ansi.reset,
+    `${ansi.cardBorder}\u2502${ansi.reset}`
+  ].join("");
+}
+function justifyCardContent(left, right, width) {
+  return `${left}${" ".repeat(Math.max(1, width - left.length - right.length))}${right}`;
+}
+function buildPixelWordmarkMatrix(word) {
+  const rows = Array.from({ length: 7 }, () => []);
+  for (let rowIndex = 0; rowIndex < 7; rowIndex += 1) {
+    word.split("").forEach((letter, letterIndex) => {
+      const pattern = thorbitPixelLetters[letter];
+      if (!pattern) return;
+      if (letterIndex > 0) rows[rowIndex].push(false);
+      rows[rowIndex].push(...pattern[rowIndex].split("").map((cell) => cell === "1"));
+    });
+  }
+  return rows;
+}
+function renderLayeredPixelWordmarkCardLines(word) {
+  const matrix = buildPixelWordmarkMatrix(word);
+  const wordmarkWidth = Math.max(...matrix.map((row) => row.length));
+  const shadowOffsetX = 1;
+  const shadowOffsetY = -1;
+  const outputRows = matrix.length + Math.abs(Math.min(0, shadowOffsetY));
+  const outputWidth = wordmarkWidth + shadowOffsetX;
+  return Array.from({ length: outputRows }, (_, outputRowIndex) => {
+    const rowParts = [{ color: ansi.slate, text: "    " }];
+    for (let columnIndex = 0; columnIndex < outputWidth; columnIndex += 1) {
+      const foregroundRow = outputRowIndex - Math.abs(Math.min(0, shadowOffsetY));
+      const hasForeground = foregroundRow >= 0 && Boolean(matrix[foregroundRow]?.[columnIndex]);
+      const shadowSourceRow = outputRowIndex - shadowOffsetY - Math.abs(Math.min(0, shadowOffsetY));
+      const shadowSourceColumn = columnIndex - shadowOffsetX;
+      const hasShadow = shadowSourceRow >= 0 && shadowSourceColumn >= 0 && Boolean(matrix[shadowSourceRow]?.[shadowSourceColumn]);
+      if (hasForeground) {
+        appendCardPart(rowParts, ansi.clay, "\u2588\u2588");
+      } else if (hasShadow) {
+        appendCardPart(rowParts, ansi.shadow, "\u2591\u2591");
+      } else {
+        appendCardPart(rowParts, ansi.slate, "  ");
+      }
+    }
+    return renderCardLineParts(rowParts);
+  });
+}
+function appendCardPart(parts, color, text) {
+  const previous = parts[parts.length - 1];
+  if (previous?.color === color) {
+    previous.text += text;
+    return;
+  }
+  parts.push({ color, text });
+}
+function renderAsciiWordmark(word) {
+  const matrix = buildPixelWordmarkMatrix(word);
+  const rows = [];
+  for (const matrixRow of matrix) {
+    rows.push(matrixRow.map((cell) => cell ? "#" : " ").join(""));
+  }
+  return rows;
+}
+function renderInstallInstructions(options) {
+  const color = options.color;
+  const json = JSON.stringify(buildMcpConfig(options), null, 2);
+  const keySetup = options.keyPath ? [
+    paint("Key file mode", ansi.terracotta, color),
+    `  chmod 600 ${options.keyPath}`
+  ].join("\n") : [
+    paint("Safer key-file option", ansi.terracotta, color),
+    "  mkdir -p ~/.config/thorbit",
+    "  printf '%s\\n' 'thbt_mcp_...' > ~/.config/thorbit/content-mcp-key",
+    "  chmod 600 ~/.config/thorbit/content-mcp-key",
+    "",
+    "  Then run:",
+    "  npx -y -p thorbit-content-mcp@latest thorbit-content-mcp-install --key-path ~/.config/thorbit/content-mcp-key"
+  ].join("\n");
+  return [
+    renderBanner(color),
+    paint("MCP Scraper research and on-page analysis for MCP agents.", ansi.slate, color),
+    "",
+    `${paint("1.", ansi.terracotta, color)} Generate an API key in Thorbit Settings -> MCPs with content/onpage scopes.`,
+    `${paint("2.", ansi.terracotta, color)} Add this server config to your MCP client:`,
+    "",
+    json,
+    "",
+    `${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)}.`,
+    "",
+    keySetup,
+    "",
+    paint("Tools", ansi.terracotta, color),
+    "  thorbit_content_extract_url       Extract a URL through MCP Scraper.",
+    "  thorbit_content_harvest_serp      Harvest SERP/PAA evidence through MCP Scraper.",
+    "  thorbit_content_reddit_research   Read Reddit through MCP Scraper browser-agent.",
+    "  thorbit_onpage_start_analysis     Start durable Thorbit on-page analysis.",
+    "  thorbit_onpage_get_analysis       Read analysis status and summary.",
+    "",
+    paint("Raw JSON:", ansi.slate, color),
+    "  npx -y -p thorbit-content-mcp@latest thorbit-content-mcp-install --json --api-key thbt_mcp_...",
+    ""
+  ].join("\n");
+}
+function main() {
+  const options = resolveInstallOptions();
+  if (options.help) {
+    process.stdout.write(renderHelp(options.color));
+    return;
+  }
+  if (options.json) {
+    process.stdout.write(`${JSON.stringify(buildMcpConfig(options), null, 2)}
+`);
+    return;
+  }
+  process.stdout.write(renderInstallInstructions(options));
+}
+function isMainModule() {
+  const entry = process.argv[1];
+  if (!entry) return false;
+  try {
+    return (0, import_node_fs.realpathSync)(entry) === (0, import_node_fs.realpathSync)((0, import_node_url.fileURLToPath)(import_meta.url));
+  } catch {
+    return false;
+  }
+}
+if (isMainModule()) main();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildMcpConfig,
+  hasFlag,
+  main,
+  readArg,
+  renderBanner,
+  renderHelp,
+  renderInstallInstructions,
+  resolveInstallOptions
+});
+//# sourceMappingURL=thorbit-content-mcp-install.cjs.map

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

@@ -0,0 +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":[]}

package/dist/bin/thorbit-content-mcp-install.d.cts

@@ -0,0 +1,27 @@
+type InstallOptions = {
+    apiKey: string;
+    baseUrl?: string;
+    keyPath?: string;
+    serverName: string;
+    json: boolean;
+    color: boolean;
+    help: boolean;
+};
+declare function readArg(name: string, argv?: string[]): string | undefined;
+declare function hasFlag(name: string, argv?: string[]): boolean;
+declare function resolveInstallOptions(argv?: string[]): InstallOptions;
+declare function buildMcpConfig(options: InstallOptions): {
+    mcpServers: {
+        [options.serverName]: {
+            command: string;
+            args: string[];
+            env: Record<string, string>;
+        };
+    };
+};
+declare function renderHelp(color: boolean): string;
+declare function renderBanner(color: boolean): string;
+declare function renderInstallInstructions(options: InstallOptions): string;
+declare function main(): void;
+
+export { type InstallOptions, buildMcpConfig, hasFlag, main, readArg, renderBanner, renderHelp, renderInstallInstructions, resolveInstallOptions };

package/dist/bin/thorbit-content-mcp-install.d.ts

@@ -0,0 +1,27 @@
+type InstallOptions = {
+    apiKey: string;
+    baseUrl?: string;
+    keyPath?: string;
+    serverName: string;
+    json: boolean;
+    color: boolean;
+    help: boolean;
+};
+declare function readArg(name: string, argv?: string[]): string | undefined;
+declare function hasFlag(name: string, argv?: string[]): boolean;
+declare function resolveInstallOptions(argv?: string[]): InstallOptions;
+declare function buildMcpConfig(options: InstallOptions): {
+    mcpServers: {
+        [options.serverName]: {
+            command: string;
+            args: string[];
+            env: Record<string, string>;
+        };
+    };
+};
+declare function renderHelp(color: boolean): string;
+declare function renderBanner(color: boolean): string;
+declare function renderInstallInstructions(options: InstallOptions): string;
+declare function main(): void;
+
+export { type InstallOptions, buildMcpConfig, hasFlag, main, readArg, renderBanner, renderHelp, renderInstallInstructions, resolveInstallOptions };