mcp-camoufox 0.5.0 → 0.5.2

package/README.md

@@ -11,7 +11,7 @@
 
 </div>
 
-The most feature-rich stealth browser MCP server. **69 tools** for full browser control powered by [Camoufox](https://github.com/daijro/camoufox) — a Firefox fork with C++ level anti-detection that bypasses Cloudflare, bot detection, and anti-automation.
+The most feature-rich stealth browser MCP server. **79 tools** for full browser control powered by [Camoufox](https://github.com/daijro/camoufox) — a Firefox fork with C++ level anti-detection that bypasses Cloudflare, bot detection, and anti-automation.
 
 > **One command. No Python. No manual setup. Everything auto-installs.**
 
@@ -39,7 +39,7 @@ claude mcp add camoufox -- npx -y mcp-camoufox@latest
 | redf0x1/camofox-mcp | 45 | Yes | No (clone) | Yes |
 | Sekinal/camoufox-mcp | 49 | Yes | No (clone) | Yes |
 | Playwright CLI | 60+ | No | Yes | Yes |
-| **[mcp-camoufox](https://github.com/RobithYusuf/mcp-camoufox)** | **69** | **Yes** | **Yes** | **Yes** |
+| **[mcp-camoufox](https://github.com/RobithYusuf/mcp-camoufox)** | **79** | **Yes** | **Yes** | **Yes** |
 
 ## Setup
 
@@ -234,7 +234,7 @@ Or via UI: Agent Panel > `...` > MCP Servers > Manage MCP Servers > View raw con
 
 That's all. Camoufox browser binary (~80MB) downloads automatically on first launch.
 
-## All 69 Tools
+## All 79 Tools
 
 ### Browser Lifecycle (2)
 
@@ -395,6 +395,30 @@ That's all. Camoufox browser binary (~80MB) downloads automatically on first lau
 | `console_start` / `console_get` | Capture and retrieve browser console messages |
 | `network_start` / `network_get` | Capture and retrieve network requests |
 
+### Compound (reduce round-trips) (4)
+
+| Tool | Description |
+|------|-------------|
+| `wait_and_snapshot` | Wait for selector/text + return snapshot in one call |
+| `back_and_snapshot` | Navigate back + return snapshot |
+| `reload_and_snapshot` | Reload page + return snapshot |
+| `click_and_snapshot` | Click + wait + return snapshot. Perfect for buttons that trigger navigation. |
+
+### Smart Selectors (skip snapshot) (3)
+
+| Tool | Description |
+|------|-------------|
+| `find_by_text` | Find element by visible text, returns ref. Skip `browser_snapshot` when you know exact text. |
+| `find_by_label` | Find input by label text, returns ref. |
+| `find_by_placeholder` | Find input by placeholder, returns ref. |
+
+### Session Portability (2)
+
+| Tool | Description |
+|------|-------------|
+| `cookie_export` | Export all cookies as JSON (for transfer) |
+| `cookie_import` | Import cookies from JSON (restore session) |
+
 ### Scraping & Extraction (4)
 
 | Tool | Description |
@@ -404,13 +428,14 @@ That's all. Camoufox browser binary (~80MB) downloads automatically on first lau
 | `extract_table` | Extract HTML table as JSON array with auto-detected headers |
 | `scrape_page` | Smart scraper: auto-extract main content (strips nav/footer), links, meta, headings. Smart truncation at paragraph boundary. |
 
-### Debug (3)
+### Debug (4)
 
 | Tool | Description |
 |------|-------------|
 | `server_status` | Health check: browser status, tabs, URL |
 | `get_page_errors` | JS errors from page |
 | `export_har` | Export network traffic as HAR file |
+| `page_stats` | Element count, page size, load metrics + extraction strategy recommendation |
 
 ## Examples
 

package/dist/index.js

@@ -113,6 +113,37 @@ const server = new McpServer({
     version: "0.2.0",
 });
 // ── Tools: Browser Lifecycle ───────────────────────────────────────────────
+async function ensureCamoufoxBinary() {
+    const { execSync } = await import("child_process");
+    const { existsSync } = await import("fs");
+    const { join: pathJoin } = await import("path");
+    const os = await import("os");
+    const homeDir = os.homedir();
+    const platform = os.platform();
+    let cacheDir;
+    if (platform === "darwin") {
+        cacheDir = pathJoin(homeDir, "Library", "Caches", "camoufox");
+    }
+    else if (platform === "win32") {
+        cacheDir = pathJoin(process.env.LOCALAPPDATA || pathJoin(homeDir, "AppData", "Local"), "camoufox");
+    }
+    else {
+        cacheDir = pathJoin(process.env.XDG_CACHE_HOME || pathJoin(homeDir, ".cache"), "camoufox");
+    }
+    const versionFile = pathJoin(cacheDir, "version.json");
+    if (existsSync(versionFile))
+        return;
+    console.error("\n" + "=".repeat(60));
+    console.error("[mcp-camoufox] First-time setup: downloading Camoufox (~500MB)");
+    console.error("[mcp-camoufox] Please wait 2-5 minutes...");
+    console.error("=".repeat(60) + "\n");
+    const cmd = platform === "win32" ? "npx.cmd" : "npx";
+    execSync(`${cmd} camoufox-js fetch`, {
+        stdio: "inherit", timeout: 900000,
+        env: { ...process.env, npm_config_yes: "true" },
+    });
+    console.error("\n[mcp-camoufox] Download complete.\n");
+}
 server.tool("browser_launch", "Launch Camoufox stealth browser and navigate to URL. Browser persists between calls. Call this first.", {
     url: z.string().default("about:blank").describe("URL to navigate to"),
     headless: z.boolean().default(true).describe("Run without visible window"),
@@ -133,57 +164,7 @@ server.tool("browser_launch", "Launch Camoufox stealth browser and navigate to U
     ensureDirs();
     const w = width > 0 ? width : 1280;
     const h = height > 0 ? height : 800;
-    // Auto-download Camoufox binary if not installed
-    // camoufox-js does NOT auto-download — we handle it here
-    await (async () => {
-        const { execSync } = await import("child_process");
-        const { existsSync, readdirSync } = await import("fs");
-        const { join: pathJoin } = await import("path");
-        const os = await import("os");
-        // Detect cache dir per platform (same logic as camoufox-js pkgman.ts)
-        const homeDir = os.homedir();
-        const platform = os.platform();
-        let cacheDir;
-        if (platform === "darwin") {
-            cacheDir = pathJoin(homeDir, "Library", "Caches", "camoufox");
-        }
-        else if (platform === "win32") {
-            cacheDir = pathJoin(process.env.LOCALAPPDATA || pathJoin(homeDir, "AppData", "Local"), "camoufox");
-        }
-        else {
-            cacheDir = pathJoin(process.env.XDG_CACHE_HOME || pathJoin(homeDir, ".cache"), "camoufox");
-        }
-        // Check if binary exists (look for version.json inside cache dir)
-        const versionFile = pathJoin(cacheDir, "version.json");
-        const isInstalled = existsSync(versionFile);
-        if (!isInstalled) {
-            console.error("");
-            console.error("=".repeat(60));
-            console.error("[mcp-camoufox] First-time setup: downloading Camoufox browser");
-            console.error("[mcp-camoufox] This is ~500MB and only happens once.");
-            console.error("[mcp-camoufox] Please wait 2-5 minutes...");
-            console.error("=".repeat(60));
-            console.error("");
-            try {
-                // Use npx to run camoufox-js CLI fetch command
-                const cmd = platform === "win32" ? "npx.cmd" : "npx";
-                execSync(`${cmd} camoufox-js fetch`, {
-                    stdio: "inherit",
-                    timeout: 900000, // 15 min max
-                    env: { ...process.env, npm_config_yes: "true" },
-                });
-                console.error("");
-                console.error("[mcp-camoufox] Download complete! Browser ready.");
-                console.error("");
-            }
-            catch (fetchErr) {
-                console.error(`[mcp-camoufox] Auto-download failed: ${fetchErr.message?.slice(0, 200)}`);
-                console.error("[mcp-camoufox] Try manually: npx camoufox-js fetch");
-                throw new Error("Camoufox browser binary not found. Auto-download failed. " +
-                    "Please run manually: npx camoufox-js fetch");
-            }
-        }
-    })();
+    await ensureCamoufoxBinary();
     const ctx = await Camoufox({
         headless,
         humanize,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-camoufox",
-  "version": "0.5.0",
-  "description": "MCP server for stealth browser automation via Camoufox — 39 tools, Chrome DevTools MCP-level power with anti-bot stealth",
+  "version": "0.5.2",
+  "description": "MCP server for stealth browser automation via Camoufox — 79 tools, Chrome DevTools MCP-level power with anti-bot stealth",
   "type": "module",
   "main": "dist/index.js",
   "bin": {