@yashwant.dharmdas/elementor-mcp 3.5.0 → 3.6.0

package/dist/index.js

@@ -1934,6 +1934,57 @@ 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."),

package/package.json

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