real-browser-mcp-server 1.1.6 → 1.1.7

package/README.md

@@ -139,9 +139,9 @@ Configure the server in your `opencode.jsonc` or standard MCP settings configura
 
 ---
 
-## 🌐 Complete MCP Tool Reference (25 Tools)
+## 🌐 Complete MCP Tool Reference (23 Tools)
 
-The server exposes 25 highly optimized tools categorized into functional units:
+The server exposes 23 highly optimized tools categorized into functional units:
 
 ### 🌐 Browser & Session
 | Tool Name | Description | Parameters |
@@ -185,11 +185,7 @@ The server exposes 25 highly optimized tools categorized into functional units:
 | `wait` | Smart delay with AI prediction or static timeout. | `duration` (number) |
 | `progress_tracker` | Track running automation progress with AI-estimated remaining times. | `step` (string), `percentage` (number) |
 
-### 📸 Capture
-| Tool Name | Description | Parameters |
-|:---|:---|:---|
-| `screenshot` | Capture viewport, full page, or a specific element. Returns the image to the AI agent (base64) and can save to a file. | `fullPage` (boolean), `selector` (string), `format` (png/jpeg), `path` (string) |
-| `save_as_pdf` | Save the current page as a PDF via Chromium print-to-PDF (headless mode only). | `path` (string), `format` (string), `landscape` (boolean) |
+
 
 ### 👁️ AI Vision (Eyes)
 | Tool Name | Description | Parameters |
@@ -305,7 +301,7 @@ Run these scripts from the project root directory:
 | `npm run dev` | Alias to start the MCP server. |
 | `npm run mcp` | Start the MCP server. |
 | `npm run mcp:verbose` | Start the MCP server with verbose logging on `stderr`. |
-| `npm run list` | Clean list of all 25 tools with emojis and categories. |
+| `npm run list` | Clean list of all 23 tools with emojis and categories. |
 | `npm run build` | Validate workspace structure and confirm library status. |
 | `npm test` | Execute the full test suite (CJS & ESM). |
 | `npm run cjs_test` | Run CommonJS test scripts. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "real-browser-mcp-server",
-  "version": "1.1.6",
+  "version": "1.1.7",
   "description": "MCP Server for Real Browser - Patchright (undetected Playwright fork) with Stealth Mode, Ad Blocker, and Turnstile Auto-Solver for undetectable web automation.",
   "main": "lib/cjs/index.js",
   "module": "lib/esm/index.mjs",

package/src/ai/action-parser.js

@@ -108,12 +108,7 @@ class ActionParser {
         type: 'submit',
         extract: (match) => ({ target: match[1].trim() || 'form' })
       },
-      // Screenshot patterns
-      {
-        pattern: /^(take|capture)\s+(?:a\s+)?screenshot/i,
-        type: 'screenshot',
-        extract: () => ({})
-      },
+
       // Go back/forward patterns
       {
         pattern: /^go\s+(back|forward)/i,

package/src/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * Real Browser - Unified Entry Point
+ * Real Browser MCP Server
  * 
  * Usage:
  *   node src/index.js             - Start MCP Server (default)
@@ -28,7 +28,7 @@ const colors = {
  */
 function showHelp() {
   console.log(`
-${colors.bright}${colors.cyan}🦁 Real Browser - Unified Server${colors.reset}
+${colors.bright}${colors.cyan}🦁 Real Browser MCP Server${colors.reset}
 
 ${colors.bright}USAGE:${colors.reset}
   node src/index.js [options]
@@ -99,7 +99,7 @@ async function main() {
   
   console.error('');
   console.error(`${colors.bright}${colors.cyan}╔════════════════════════════════════════════════════════════╗${colors.reset}`);
-  console.error(`${colors.bright}${colors.cyan}║${colors.reset}  ${colors.bright}${colors.magenta}🦁 Real Browser - Unified Server${colors.reset}                          ${colors.cyan}║${colors.reset}`);
+  console.error(`${colors.bright}${colors.cyan}║${colors.reset}  ${colors.bright}${colors.magenta}🦁 Real Browser MCP Server${colors.reset}                                ${colors.cyan}║${colors.reset}`);
   console.error(`${colors.bright}${colors.cyan}║${colors.reset}  ${colors.dim}MCP (AI Agents) Server running on STDIO${colors.reset}                  ${colors.cyan}║${colors.reset}`);
   console.error(`${colors.bright}${colors.cyan}╚════════════════════════════════════════════════════════════╝${colors.reset}`);
   console.error('');

package/src/mcp/handlers.js

@@ -4946,98 +4946,7 @@ const handlers = {
     };
   },
 
-  // 23. Screenshot - capture viewport / full page / element (returns image to AI)
-  async screenshot(params = {}) {
-    const { page } = requireBrowser();
-    const {
-      fullPage = false,
-      selector,
-      format = 'png',
-      quality,
-      path: savePath,
-      returnBase64 = true,
-      omitBackground = false
-    } = params;
-
-    notifyProgress('screenshot', 'started',
-      `Capturing ${selector ? 'element' : (fullPage ? 'full page' : 'viewport')} screenshot`);
-
-    const opts = { type: format, fullPage: selector ? false : fullPage };
-    if (format === 'jpeg' && typeof quality === 'number') opts.quality = quality;
-    if (format === 'png' && omitBackground) opts.omitBackground = true;
-
-    let buffer;
-    if (selector) {
-      const element = await page.$(selector);
-      if (!element) {
-        notifyProgress('screenshot', 'error', `Element not found: ${selector}`);
-        return { success: false, error: `Element not found: ${selector}` };
-      }
-      buffer = await element.screenshot(opts);
-    } else {
-      buffer = await page.screenshot(opts);
-    }
-
-    let savedTo = null;
-    if (savePath) {
-      const dir = path.dirname(savePath);
-      if (dir && !fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-      fs.writeFileSync(savePath, buffer);
-      savedTo = savePath;
-    }
-
-    notifyProgress('screenshot', 'completed',
-      `Screenshot captured (${buffer.length} bytes)${savedTo ? ' → ' + savedTo : ''}`);
 
-    const meta = { success: true, format, bytes: buffer.length, savedTo, url: page.url() };
-
-    if (returnBase64) {
-      const base64 = Buffer.from(buffer).toString('base64');
-      // mcpContent is returned directly to the AI agent (image + text summary)
-      meta.mcpContent = [
-        { type: 'image', data: base64, mimeType: format === 'jpeg' ? 'image/jpeg' : 'image/png' },
-        { type: 'text', text: JSON.stringify({ success: true, format, bytes: buffer.length, savedTo, url: page.url() }, null, 2) }
-      ];
-    }
-
-    return meta;
-  },
-
-  // 24. Save as PDF - Chromium print-to-PDF (headless mode only)
-  async save_as_pdf(params = {}) {
-    const { page } = requireBrowser();
-    const {
-      path: savePath = './downloads/page.pdf',
-      format = 'A4',
-      landscape = false,
-      printBackground = true
-    } = params;
-
-    notifyProgress('save_as_pdf', 'started', `Saving page as PDF: ${savePath}`);
-
-    const dir = path.dirname(savePath);
-    if (dir && !fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-
-    try {
-      await page.pdf({ path: savePath, format, landscape, printBackground });
-    } catch (e) {
-      notifyProgress('save_as_pdf', 'error', e.message);
-      return {
-        success: false,
-        error: `PDF generation failed (page.pdf() works only in headless mode): ${e.message}`
-      };
-    }
-
-    const stats = fs.existsSync(savePath) ? fs.statSync(savePath) : null;
-    notifyProgress('save_as_pdf', 'completed', `PDF saved: ${savePath}`);
-
-    return {
-      success: true,
-      savedTo: savePath,
-      bytes: stats ? stats.size : null,
-      url: page.url()
-    };
-  },
 
   // 25. See Page (AI Vision — "eyes": screenshot + visual map of interactive elements)
   async see_page(params = {}) {

package/src/shared/tools.js

@@ -559,48 +559,6 @@ const TOOLS = [
     }
   },
 
-  // 23. Screenshot
-  {
-    name: 'screenshot',
-    emoji: '📸',
-    description: 'Capture a screenshot of the viewport, the full scrollable page, or a specific element. Returns the image directly to the AI agent (base64) and can optionally save it to a file. EFFICIENCY RULE: PREFER a single FULL-PAGE screenshot (set fullPage: true) so the entire page is captured in one shot, then complete ALL related work for that page from this single capture (read, click, type, extract). Take a SECOND screenshot ONLY IF the work genuinely cannot be finished from the first one, OR after the page actually changes (navigation, modal/popup, or new dynamic content loads). Do NOT take repeated screenshots of the SAME unchanged page.',
-    descriptionHindi: 'स्क्रीनशॉट लेना — viewport, पूरा पेज, या किसी element का। Image सीधे AI को मिलती है + file में save हो सकती है। नियम: पहले पूरे पेज का full-page (लॉन्ग) स्क्रीनशॉट लें (fullPage: true) ताकि पूरा पेज एक ही बार में दिख जाए, फिर उसी एक image से उस पेज का सारा काम (पढ़ना, क्लिक, टाइप, data निकालना) एक साथ complete करें। दूसरा स्क्रीनशॉट सिर्फ़ तभी लें जब पहले वाले से काम पूरा न हो पाए, या पेज सच में बदल जाए (navigation, modal/popup, या नया dynamic content)। बिना बदलाव के उसी पेज का बार-बार स्क्रीनशॉट न लें।',
-    category: 'capture',
-    requiresBrowser: true,
-    requiresPage: true,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        fullPage: { type: 'boolean', default: false, description: 'Capture the full scrollable page' },
-        selector: { type: 'string', description: 'CSS selector to screenshot a specific element only' },
-        format: { type: 'string', enum: ['png', 'jpeg'], default: 'png' },
-        quality: { type: 'number', description: 'JPEG quality 0-100 (jpeg only)' },
-        path: { type: 'string', description: 'Optional file path to save the screenshot' },
-        returnBase64: { type: 'boolean', default: true, description: 'Return image to AI as base64 (MCP image content)' },
-        omitBackground: { type: 'boolean', default: false, description: 'Transparent background (png only)' }
-      }
-    }
-  },
-
-  // 24. Save as PDF
-  {
-    name: 'save_as_pdf',
-    emoji: '📑',
-    description: 'Save the current page as a PDF file using Chromium print-to-PDF. Note: works only in headless mode.',
-    descriptionHindi: 'पेज को PDF में सेव करना (Chromium print-to-PDF)। ध्यान: सिर्फ़ headless mode में काम करता है।',
-    category: 'capture',
-    requiresBrowser: true,
-    requiresPage: true,
-    inputSchema: {
-      type: 'object',
-      properties: {
-        path: { type: 'string', default: './downloads/page.pdf', description: 'File path to save the PDF' },
-        format: { type: 'string', default: 'A4', description: 'Paper format: A4, Letter, Legal, etc.' },
-        landscape: { type: 'boolean', default: false },
-        printBackground: { type: 'boolean', default: true, description: 'Include background graphics' }
-      }
-    }
-  },
 
   // 25. See Page (AI Vision — "eyes")
   {
@@ -633,7 +591,7 @@ const CATEGORIES = {
   extraction: { name: 'Extraction', emoji: '📄', description: 'Content extraction and scraping' },
   network: { name: 'Network', emoji: '📡', description: 'Network operations' },
   analysis: { name: 'Analysis', emoji: '🧠', description: 'Page analysis' },
-  capture: { name: 'Capture', emoji: '📸', description: 'Screenshots and PDF capture' },
+
   vision: { name: 'Vision', emoji: '👁️', description: 'AI visual perception (sees pages like human eyes)' },
   utility: { name: 'Utility', emoji: '🛠️', description: 'Utility tools' }
 };