@yashwant.dharmdas/elementor-mcp 3.4.0 → 3.6.0

package/dist/index.js

@@ -849,42 +849,70 @@ function createMcpServer(sites) {
             return { content: [{ type: "text", text: `Error: ${e.response?.data?.message || e.message}` }], isError: true };
         }
     });
-    server.tool("create-custom-code", "Create a new custom code snippet (requires Elementor Pro).", {
-        title: z.string(),
-        code: z.string(),
-        location: z.string().optional().describe("head or body"),
-        status: z.string().optional(),
+    server.tool("create-custom-code", "Create a new custom code snippet (requires Elementor Pro). Supports the full Publish Settings — set condition='entire_site' so the snippet actually applies sitewide (otherwise it has no effect even when published).", {
+        title: z.string().describe("Snippet title (e.g. 'Favicon Code')"),
+        code: z.string().describe("Raw code to inject (HTML, JS, or CSS)"),
+        location: z.string().optional().describe("Where to inject: 'head', 'body_start', 'body_end' (default: head)"),
+        status: z.string().optional().describe("Post status: 'publish' (default) or 'draft'. Use 'publish' to make the snippet active immediately."),
+        priority: z.number().optional().describe("Load priority — lower number = earlier. Default: 10"),
+        condition: z.enum(["entire_site", "specific_page", "post_type"]).optional().describe("Where the snippet applies. 'entire_site' = sitewide (most common, required for favicons/global tags). Default: entire_site"),
+        page_id: z.string().optional().describe("Required when condition='specific_page'. Apply only to this page."),
+        post_type: z.string().optional().describe("Required when condition='post_type'. WordPress post type slug (e.g. 'page', 'post', 'astra-portfolio')."),
         site: siteParam,
-    }, async ({ title, code, location, status, site }) => {
+    }, async ({ title, code, location, status, priority, condition, page_id, post_type, site }) => {
         try {
             const { wpUrl, authHeader } = resolveSite(sites, site);
-            const r = await axios.post(`${wpUrl}/wp-json/erc/v1/site/custom-code`, { title, code, location: location || "head", status: status || "draft" }, { headers: { Authorization: authHeader } });
+            const body = {
+                title,
+                code,
+                location: location || "head",
+                status: status || "publish",
+                priority: priority ?? 10,
+                condition: condition || "entire_site",
+            };
+            if (condition === "specific_page" && page_id)
+                body.page_id = page_id;
+            if (condition === "post_type" && post_type)
+                body.post_type = post_type;
+            const r = await axios.post(`${wpUrl}/wp-json/erc/v1/site/custom-code`, body, { headers: { Authorization: authHeader, "Content-Type": "application/json" } });
             return { content: [{ type: "text", text: JSON.stringify(r.data, null, 2) }] };
         }
         catch (e) {
             return { content: [{ type: "text", text: `Error: ${e.response?.data?.message || e.message}` }], isError: true };
         }
     });
-    server.tool("update-custom-code", "Update a custom code snippet (requires Elementor Pro).", {
-        snippet_id: z.string(),
+    server.tool("update-custom-code", "Update a custom code snippet (requires Elementor Pro). Can also update Publish Settings — condition, priority, and status.", {
+        snippet_id: z.string().describe("ID of the custom code snippet"),
         title: z.string().optional(),
         code: z.string().optional(),
-        location: z.string().optional(),
-        status: z.string().optional(),
+        location: z.string().optional().describe("'head', 'body_start', or 'body_end'"),
+        status: z.string().optional().describe("'publish' or 'draft'"),
+        priority: z.number().optional().describe("Load priority (lower = earlier)"),
+        condition: z.enum(["entire_site", "specific_page", "post_type"]).optional().describe("Where the snippet applies"),
+        page_id: z.string().optional().describe("Required when condition='specific_page'"),
+        post_type: z.string().optional().describe("Required when condition='post_type'"),
         site: siteParam,
-    }, async ({ snippet_id, title, code, location, status, site }) => {
+    }, async ({ snippet_id, title, code, location, status, priority, condition, page_id, post_type, site }) => {
         try {
             const { wpUrl, authHeader } = resolveSite(sites, site);
             const body = {};
-            if (title)
+            if (title !== undefined)
                 body.title = title;
-            if (code)
+            if (code !== undefined)
                 body.code = code;
-            if (location)
+            if (location !== undefined)
                 body.location = location;
-            if (status)
+            if (status !== undefined)
                 body.status = status;
-            const r = await axios.put(`${wpUrl}/wp-json/erc/v1/site/custom-code/${snippet_id}`, body, { headers: { Authorization: authHeader } });
+            if (priority !== undefined)
+                body.priority = priority;
+            if (condition !== undefined)
+                body.condition = condition;
+            if (page_id !== undefined)
+                body.page_id = page_id;
+            if (post_type !== undefined)
+                body.post_type = post_type;
+            const r = await axios.put(`${wpUrl}/wp-json/erc/v1/site/custom-code/${snippet_id}`, body, { headers: { Authorization: authHeader, "Content-Type": "application/json" } });
             return { content: [{ type: "text", text: JSON.stringify(r.data, null, 2) }] };
         }
         catch (e) {
@@ -1906,6 +1934,80 @@ function createMcpServer(sites) {
             return { content: [{ type: "text", text: `Error setting Z-index: ${error.response?.data?.message || error.message}` }], isError: true };
         }
     });
+    // ── Group 27: Content Audit (text extraction & bulk fix application) ────────
+    server.tool("extract-pages-text", "Extract clean text content from one or many Elementor pages — returns ONLY the words, not the JSON or HTML noise. Designed for grammar/spelling/sentence audits across many pages at once. Uses a key-name heuristic so it works for ANY widget (built-in, Elementor Pro, WooCommerce, third-party, custom) without widget-specific code. Each block includes element_id + field_path so fixes can be written back precisely with apply-text-fixes.", {
+        page_ids: z.array(z.number()).optional().describe("Specific page IDs to extract from"),
+        scope: z.enum(["all_pages"]).optional().describe("Use 'all_pages' to extract from every published Elementor page"),
+        post_type: z.string().optional().describe("Limit to a specific post type (e.g. 'page', 'post', 'astra-portfolio')"),
+        site: siteParam,
+    }, async ({ page_ids, scope, post_type, site }) => {
+        try {
+            if (!page_ids && !scope && !post_type) {
+                return { content: [{ type: "text", text: "Provide page_ids, scope='all_pages', or post_type." }], isError: true };
+            }
+            const { wpUrl, authHeader } = resolveSite(sites, site);
+            const body = {};
+            if (page_ids)
+                body.page_ids = page_ids;
+            if (scope)
+                body.scope = scope;
+            if (post_type)
+                body.post_type = post_type;
+            const r = await axios.post(`${wpUrl}/wp-json/erc/v1/site/extract-text`, body, { headers: { Authorization: authHeader, "Content-Type": "application/json" } });
+            return { content: [{ type: "text", text: JSON.stringify(r.data, null, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error extracting page text: ${error.response?.data?.message || error.message}` }], isError: true };
+        }
+    });
+    server.tool("apply-text-fixes", "Write text corrections (grammar/spelling/sentence fixes) back to many Elementor pages in one call. Pair with extract-pages-text. Each fix uses 'old_text' for safe substring replacement (recommended — preserves surrounding HTML/markup and only touches the broken phrase). Omit old_text to fully overwrite the field with new_text.", {
+        fixes: z.string().describe('JSON array of fix objects. Schema: [{"page_id": number, "element_id": string, "field_path": string, "old_text"?: string, "new_text": string}]. ' +
+            "Recommended: always provide old_text — only that exact substring is replaced, leaving surrounding HTML untouched. " +
+            "field_path supports nested paths returned by extract-pages-text (e.g. 'editor', 'title', 'tabs.0.tab_title')."),
+        site: siteParam,
+    }, async ({ fixes, site }) => {
+        let parsed;
+        try {
+            parsed = JSON.parse(fixes);
+        }
+        catch {
+            return { content: [{ type: "text", text: "Invalid JSON in fixes parameter." }], isError: true };
+        }
+        if (!Array.isArray(parsed) || parsed.length === 0) {
+            return { content: [{ type: "text", text: "fixes must be a non-empty JSON array." }], isError: true };
+        }
+        try {
+            const { wpUrl, authHeader } = resolveSite(sites, site);
+            const r = await axios.post(`${wpUrl}/wp-json/erc/v1/site/apply-text-fixes`, { fixes: parsed }, { headers: { Authorization: authHeader, "Content-Type": "application/json" } });
+            return { content: [{ type: "text", text: JSON.stringify(r.data, null, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error applying text fixes: ${error.response?.data?.message || error.message}` }], isError: true };
+        }
+    });
+    // ── Group 26: Favicon ─────────────────────────────────────────────────────────
+    server.tool("upload-favicon", "Set the WordPress Site Icon (favicon) — equivalent to Customize → Site Identity → Select Site Icon. Accepts either a URL of an image already in the media library, a media attachment ID, or a remote URL to fetch and upload first.", {
+        favicon_url: z.string().optional().describe("URL of the favicon image. If the URL is from the same WP media library, the existing attachment is reused; otherwise the image is downloaded and uploaded as a new media item."),
+        favicon_id: z.number().optional().describe("WordPress media attachment ID of an already-uploaded favicon image (preferred when known)"),
+        site: siteParam,
+    }, async ({ favicon_url, favicon_id, site }) => {
+        try {
+            if (!favicon_url && !favicon_id) {
+                return { content: [{ type: "text", text: "Provide either favicon_url or favicon_id." }], isError: true };
+            }
+            const { wpUrl, authHeader } = resolveSite(sites, site);
+            const body = {};
+            if (favicon_id)
+                body.favicon_id = favicon_id;
+            if (favicon_url)
+                body.favicon_url = favicon_url;
+            const r = await axios.post(`${wpUrl}/wp-json/erc/v1/site/favicon`, body, { headers: { Authorization: authHeader, "Content-Type": "application/json" } });
+            return { content: [{ type: "text", text: JSON.stringify(r.data, null, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error setting favicon: ${error.response?.data?.message || error.message}` }], isError: true };
+        }
+    });
     // ── Group 25: Video Overlay ───────────────────────────────────────────────────
     server.tool("update-video-overlay", "Set the image overlay on an Elementor video widget so the video appears to load immediately on page load. The overlay image (typically the video thumbnail or hero image) is shown until the user clicks play. This is the correct fix for 'video not loading immediately' QA issues — not changing the video URL.", {
         page_id: z.string().describe("WordPress Page ID containing the video widget"),

package/package.json

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