feat: Claude Code plugin packaging (openclaw format)

- openclaw.plugin.json: plugin manifest
- .mcp.json: MCP server config using start.mjs
- start.mjs: finds/builds rawdoc binary, spawns --serve
- scripts/postinstall.mjs: auto-builds binary on install
- package.json: npm package metadata for plugin registry

Install: /install-plugin RandomCodeSpace/rawdoc

Author: aksOps

.gitignore

@@ -8,8 +8,8 @@ dist/
 .vscode/
 .idea/
 
-# MCP configs
-.mcp.json
+# IDE
+node_modules/
 
 # OS
 .DS_Store

.mcp.json

@@ -0,0 +1,10 @@
+{
+    "mcpServers": {
+        "rawdoc": {
+            "command": "node",
+            "args": [
+                "${CLAUDE_PLUGIN_ROOT}/start.mjs"
+            ]
+        }
+    }
+}

openclaw.plugin.json

@@ -0,0 +1,23 @@
+{
+  "id": "rawdoc",
+  "name": "rawdoc",
+  "kind": "tool",
+  "description": "Fetch web pages as clean markdown for AI agents. Strips noise, extracts content, 95%+ token reduction.",
+  "version": "0.2.0",
+  "sandbox": {
+    "mode": "permissive",
+    "filesystem_access": "none",
+    "system_access": "none"
+  },
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "enabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable or disable the rawdoc plugin."
+      }
+    },
+    "additionalProperties": false
+  }
+}

package.json

@@ -0,0 +1,18 @@
+{
+  "name": "rawdoc",
+  "version": "0.2.0",
+  "description": "Fetch web pages as clean markdown for AI agents",
+  "main": "./start.mjs",
+  "type": "module",
+  "scripts": {
+    "build": "go build -o rawdoc .",
+    "test": "go test -count=1 ./...",
+    "postinstall": "node scripts/postinstall.mjs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/RandomCodeSpace/rawdoc.git"
+  },
+  "keywords": ["mcp", "claude-code", "markdown", "web-scraper", "documentation"],
+  "license": "MIT"
+}

scripts/postinstall.mjs

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+// postinstall: build rawdoc binary if Go is available, otherwise check PATH
+import { execFileSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { platform } from "node:os";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const root = resolve(__dirname, "..");
+const ext = platform() === "win32" ? ".exe" : "";
+const binary = resolve(root, `rawdoc${ext}`);
+
+if (existsSync(binary)) {
+  console.log(`[rawdoc] Binary already exists: ${binary}`);
+  process.exit(0);
+}
+
+// Try building from source
+try {
+  console.log("[rawdoc] Building from source...");
+  execFileSync("go", ["build", "-ldflags=-s -w", "-o", binary, "."], {
+    cwd: root,
+    stdio: "inherit",
+  });
+  console.log(`[rawdoc] Built: ${binary}`);
+  process.exit(0);
+} catch {
+  // Go not available — check if rawdoc is already in PATH
+  try {
+    const which = platform() === "win32" ? "where" : "which";
+    const found = execFileSync(which, [`rawdoc${ext}`], { encoding: "utf8" }).trim();
+    console.log(`[rawdoc] Found in PATH: ${found}`);
+    process.exit(0);
+  } catch {
+    console.error("[rawdoc] Warning: Go not available and rawdoc not in PATH.");
+    console.error("[rawdoc] Install manually: go install github.com/RandomCodeSpace/rawdoc@latest");
+    // Don't fail postinstall — let start.mjs give the error at runtime
+    process.exit(0);
+  }
+}

start.mjs

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+import { execFileSync, spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { platform } from "node:os";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+const os = platform();
+const ext = os === "win32" ? ".exe" : "";
+const binaryName = `rawdoc${ext}`;
+
+// Check for binary in plugin directory first, then PATH
+let binaryPath = resolve(__dirname, binaryName);
+
+if (!existsSync(binaryPath)) {
+  // Try to find in PATH
+  try {
+    const which = os === "win32" ? "where" : "which";
+    binaryPath = execFileSync(which, [binaryName], { encoding: "utf8" }).trim().split("\n")[0];
+  } catch {
+    // Try to build from source if Go is available
+    try {
+      console.error("[rawdoc] Binary not found, building from source...");
+      execFileSync("go", ["build", "-o", resolve(__dirname, binaryName), "."], {
+        cwd: __dirname,
+        stdio: "inherit",
+      });
+      binaryPath = resolve(__dirname, binaryName);
+    } catch {
+      console.error("[rawdoc] Error: rawdoc binary not found and Go is not available to build it.");
+      console.error("[rawdoc] Install with: go install github.com/RandomCodeSpace/rawdoc@latest");
+      process.exit(1);
+    }
+  }
+}
+
+// Spawn rawdoc in MCP server mode, piping stdio
+const child = spawn(binaryPath, ["--serve"], {
+  stdio: ["inherit", "inherit", "inherit"],
+});
+
+child.on("error", (err) => {
+  console.error(`[rawdoc] Failed to start: ${err.message}`);
+  process.exit(1);
+});
+
+child.on("exit", (code) => {
+  process.exit(code ?? 0);
+});