@yashwant.dharmdas/elementor-mcp 3.2.0 → 3.2.2

package/dist/index.js

@@ -993,29 +993,31 @@ function createMcpServer(sites) {
         }
     });
     // ── Group 9: Screenshot ──────────────────────────────────────────────────────
-    server.tool("screenshot-page", "Take a full-page screenshot of a published WordPress page using the system-installed Google Chrome browser. Returns the screenshot as an image so you can visually review design, layout, and content. Requires the page to be publicly accessible (status: publish).", {
+    server.tool("screenshot-page", "Take a screenshot of a published WordPress page using system Chrome. Saves the file to disk and returns both a preview image and the saved file path. Pass the file_path to Basecamp MCP's upload_attachment tool to attach it — never relay the raw image data yourself.", {
         page_id: z.string().describe("WordPress Page ID"),
-        full_page: z.boolean().optional().describe("Capture the full scrollable page height (default: true)"),
+        full_page: z.boolean().optional().describe("Capture full scrollable page (default: true)"),
         width: z.number().optional().describe("Viewport width in pixels (default: 1440)"),
+        format: z.enum(["jpeg", "png"]).optional().describe("Image format — jpeg is much smaller and recommended (default: jpeg)"),
+        quality: z.number().min(1).max(100).optional().describe("JPEG quality 1–100 (default: 82). Lower = smaller file size."),
+        max_height: z.number().optional().describe("Cap the captured height in pixels (e.g. 4000). Useful for very long pages to stay under size limits."),
+        wait: z.number().optional().describe("Extra milliseconds to wait after page load + auto-scroll before capturing (default: 2000). Increase for heavy animations/videos."),
+        auto_scroll: z.boolean().optional().describe("Scroll through the page to trigger lazy-loaded images and content (default: true). Disable only for pages with infinite scroll."),
         site: siteParam,
-    }, async ({ page_id, full_page, width, site }) => {
+    }, async ({ page_id, full_page, width, format, quality, max_height, wait, auto_scroll, site }) => {
         try {
             const { wpUrl, authHeader } = resolveSite(sites, site);
-            // ── 1. Resolve the page's public URL from WP REST API ──────────────
+            // ── 1. Resolve the page's public URL ─────────────────────────────
             const pageRes = await axios.get(`${wpUrl}/wp-json/wp/v2/pages/${page_id}`, {
                 headers: { Authorization: authHeader },
             });
             const pageUrl = pageRes.data.link;
             if (!pageUrl)
                 throw new Error("Could not resolve public URL for this page.");
-            // ── 2. Detect system Chrome ──────────────────────────────────────
+            // ── 2. Detect system Chrome ───────────────────────────────────────
             const chromePaths = [
-                // Windows
                 "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
                 "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe",
-                // macOS
                 "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
-                // Linux
                 "/usr/bin/google-chrome",
                 "/usr/bin/google-chrome-stable",
                 "/usr/bin/chromium-browser",
@@ -1029,51 +1031,108 @@ function createMcpServer(sites) {
                 }
             }
             if (!executablePath) {
-                throw new Error("Google Chrome not found on this machine.\n" +
-                    "Install Chrome from https://www.google.com/chrome/ and ensure it is in a standard location.\n" +
-                    "Checked paths:\n" + chromePaths.map(p => `  • ${p}`).join("\n"));
+                throw new Error("Google Chrome not found. Install it from https://www.google.com/chrome/\n" +
+                    "Checked:\n" + chromePaths.map(p => `  • ${p}`).join("\n"));
             }
-            // ── 3. Launch puppeteer-core with system Chrome ─────────────────
+            // ── 3. Ensure screenshots directory exists ───────────────────────
+            const screenshotsDir = path.join(CONFIG_DIR, "screenshots");
+            if (!fs.existsSync(screenshotsDir))
+                fs.mkdirSync(screenshotsDir, { recursive: true });
+            // ── 4. Launch puppeteer-core ──────────────────────────────────────
             let puppeteer;
             try {
                 puppeteer = await import("puppeteer-core");
             }
             catch {
-                throw new Error("puppeteer-core is not installed. Run: npm install puppeteer-core\n" +
-                    "(or reinstall @yashwant.dharmdas/elementor-mcp — it is bundled as a dependency)");
+                throw new Error("puppeteer-core is not installed. Reinstall @yashwant.dharmdas/elementor-mcp to get it.");
             }
             const browser = await puppeteer.launch({
                 executablePath,
                 headless: true,
-                args: [
-                    "--no-sandbox",
-                    "--disable-setuid-sandbox",
-                    "--disable-dev-shm-usage",
-                    "--disable-gpu",
-                ],
+                args: ["--no-sandbox", "--disable-setuid-sandbox", "--disable-dev-shm-usage", "--disable-gpu"],
             });
             try {
                 const page = await browser.newPage();
-                await page.setViewport({ width: width ?? 1440, height: 900, deviceScaleFactor: 1 });
-                await page.goto(pageUrl, { waitUntil: "networkidle2", timeout: 30_000 });
-                // Small pause to let JS-heavy pages finish rendering
-                await new Promise(resolve => setTimeout(resolve, 1000));
-                const screenshotBuffer = await page.screenshot({
-                    fullPage: full_page ?? true,
-                    type: "png",
+                const vpWidth = width ?? 1440;
+                const vpHeight = max_height ?? 900;
+                await page.setViewport({ width: vpWidth, height: vpHeight, deviceScaleFactor: 1 });
+                // Navigate and wait for network to go idle
+                await page.goto(pageUrl, { waitUntil: "networkidle2", timeout: 45_000 });
+                // ── Auto-scroll: trigger lazy-loaded images/content ─────────────
+                if (auto_scroll !== false) {
+                    await page.evaluate(async () => {
+                        await new Promise((resolve) => {
+                            let totalHeight = 0;
+                            const distance = 200;
+                            const timer = setInterval(() => {
+                                const scrollHeight = document.body.scrollHeight;
+                                window.scrollBy(0, distance);
+                                totalHeight += distance;
+                                if (totalHeight >= scrollHeight) {
+                                    clearInterval(timer);
+                                    resolve();
+                                }
+                            }, 80);
+                        });
+                    });
+                    // Scroll back to top for the capture
+                    await page.evaluate(() => window.scrollTo(0, 0));
+                }
+                // ── Wait for all <img> tags to finish loading ──────────────────
+                await page.evaluate(async () => {
+                    const images = Array.from(document.querySelectorAll("img"));
+                    await Promise.all(images.map((img) => {
+                        if (img.complete && img.naturalWidth > 0)
+                            return Promise.resolve();
+                        return new Promise((resolve) => {
+                            img.addEventListener("load", () => resolve(), { once: true });
+                            img.addEventListener("error", () => resolve(), { once: true });
+                            // Safety timeout per image
+                            setTimeout(() => resolve(), 5000);
+                        });
+                    }));
                 });
-                const base64 = Buffer.isBuffer(screenshotBuffer)
-                    ? screenshotBuffer.toString("base64")
-                    : Buffer.from(screenshotBuffer).toString("base64");
-                return {
-                    content: [
-                        {
-                            type: "image",
-                            data: base64,
-                            mimeType: "image/png",
-                        },
-                    ],
-                };
+                // Extra settle time for fonts, animations, videos
+                await new Promise(resolve => setTimeout(resolve, wait ?? 2000));
+                const fmt = format ?? "jpeg";
+                const screenshotOptions = { type: fmt, fullPage: !max_height && (full_page ?? true) };
+                if (fmt === "jpeg")
+                    screenshotOptions.quality = quality ?? 82;
+                if (max_height)
+                    screenshotOptions.clip = { x: 0, y: 0, width: vpWidth, height: vpHeight };
+                const screenshotBuffer = await page.screenshot(screenshotOptions);
+                const buf = Buffer.isBuffer(screenshotBuffer) ? screenshotBuffer : Buffer.from(screenshotBuffer);
+                // ── 5. Save to disk ─────────────────────────────────────────────
+                const ext = fmt === "jpeg" ? "jpg" : "png";
+                const filename = `page_${page_id}_${Date.now()}.${ext}`;
+                const filePath = path.join(screenshotsDir, filename);
+                fs.writeFileSync(filePath, buf);
+                const sizeKB = Math.round(buf.length / 1024);
+                const mimeType = `image/${fmt}`;
+                // ── 6. Return image preview if small enough, always return path ─
+                const PREVIEW_LIMIT = 750 * 1024; // 750 KB raw → ~1 MB base64
+                const content = [
+                    {
+                        type: "text",
+                        text: [
+                            `✅ Screenshot saved successfully.`,
+                            `📁 file_path: ${filePath}`,
+                            `📐 Size: ${sizeKB} KB  |  Format: ${ext.toUpperCase()}  |  URL: ${pageUrl}`,
+                            ``,
+                            `👉 To upload to Basecamp, call upload_attachment with:`,
+                            `   file_path = "${filePath}"`,
+                            `   project_id = <your Basecamp project ID>`,
+                        ].join("\n"),
+                    },
+                ];
+                if (buf.length <= PREVIEW_LIMIT) {
+                    content.unshift({
+                        type: "image",
+                        data: buf.toString("base64"),
+                        mimeType,
+                    });
+                }
+                return { content };
             }
             finally {
                 await browser.close();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yashwant.dharmdas/elementor-mcp",
-  "version": "3.2.0",
+  "version": "3.2.2",
   "description": "MCP server for controlling Elementor via Claude — supports multiple WordPress sites",
   "main": "dist/index.js",
   "type": "module",