claude-plugin-wordpress-manager 1.7.1 → 1.8.0

package/servers/wp-rest-bridge/build/tools/wc-reports.d.ts

@@ -0,0 +1,117 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+declare const wcGetSalesReportSchema: z.ZodObject<{
+    period: z.ZodDefault<z.ZodOptional<z.ZodEnum<["week", "month", "last_month", "year"]>>>;
+    date_min: z.ZodOptional<z.ZodString>;
+    date_max: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    period: "week" | "month" | "last_month" | "year";
+    date_min?: string | undefined;
+    date_max?: string | undefined;
+}, {
+    period?: "week" | "month" | "last_month" | "year" | undefined;
+    date_min?: string | undefined;
+    date_max?: string | undefined;
+}>;
+declare const wcGetTopSellersSchema: z.ZodObject<{
+    period: z.ZodDefault<z.ZodOptional<z.ZodEnum<["week", "month", "last_month", "year"]>>>;
+    date_min: z.ZodOptional<z.ZodString>;
+    date_max: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    period: "week" | "month" | "last_month" | "year";
+    date_min?: string | undefined;
+    date_max?: string | undefined;
+}, {
+    period?: "week" | "month" | "last_month" | "year" | undefined;
+    date_min?: string | undefined;
+    date_max?: string | undefined;
+}>;
+export declare const wcReportTools: Tool[];
+export declare const wcReportHandlers: {
+    wc_get_sales_report: (params: z.infer<typeof wcGetSalesReportSchema>) => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
+    wc_get_top_sellers: (params: z.infer<typeof wcGetTopSellersSchema>) => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
+    wc_get_orders_totals: () => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
+    wc_get_products_totals: () => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
+    wc_get_customers_totals: () => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
+};
+export {};

package/servers/wp-rest-bridge/build/tools/wc-reports.js

@@ -0,0 +1,94 @@
+import { makeWooCommerceRequest } from '../wordpress.js';
+import { z } from 'zod';
+const wcGetSalesReportSchema = z.object({
+    period: z.enum(['week', 'month', 'last_month', 'year']).optional().default('week').describe("Report period"),
+    date_min: z.string().optional().describe("Start date (YYYY-MM-DD)"),
+    date_max: z.string().optional().describe("End date (YYYY-MM-DD)"),
+}).strict();
+const wcGetTopSellersSchema = z.object({
+    period: z.enum(['week', 'month', 'last_month', 'year']).optional().default('week').describe("Report period"),
+    date_min: z.string().optional().describe("Start date (YYYY-MM-DD)"),
+    date_max: z.string().optional().describe("End date (YYYY-MM-DD)"),
+}).strict();
+const wcGetOrdersTotalsSchema = z.object({}).strict();
+const wcGetProductsTotalsSchema = z.object({}).strict();
+const wcGetCustomersTotalsSchema = z.object({}).strict();
+export const wcReportTools = [
+    {
+        name: "wc_get_sales_report",
+        description: "Gets WooCommerce sales report (total sales, orders, items, revenue) for a period",
+        inputSchema: { type: "object", properties: wcGetSalesReportSchema.shape },
+    },
+    {
+        name: "wc_get_top_sellers",
+        description: "Gets top-selling WooCommerce products for a period",
+        inputSchema: { type: "object", properties: wcGetTopSellersSchema.shape },
+    },
+    {
+        name: "wc_get_orders_totals",
+        description: "Gets WooCommerce order totals grouped by status",
+        inputSchema: { type: "object", properties: wcGetOrdersTotalsSchema.shape },
+    },
+    {
+        name: "wc_get_products_totals",
+        description: "Gets WooCommerce product totals grouped by type",
+        inputSchema: { type: "object", properties: wcGetProductsTotalsSchema.shape },
+    },
+    {
+        name: "wc_get_customers_totals",
+        description: "Gets WooCommerce customer totals (paying vs non-paying)",
+        inputSchema: { type: "object", properties: wcGetCustomersTotalsSchema.shape },
+    },
+];
+export const wcReportHandlers = {
+    wc_get_sales_report: async (params) => {
+        try {
+            const response = await makeWooCommerceRequest("GET", "reports/sales", params);
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.message || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error getting sales report: ${errorMessage}` }] } };
+        }
+    },
+    wc_get_top_sellers: async (params) => {
+        try {
+            const response = await makeWooCommerceRequest("GET", "reports/top_sellers", params);
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.message || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error getting top sellers: ${errorMessage}` }] } };
+        }
+    },
+    wc_get_orders_totals: async () => {
+        try {
+            const response = await makeWooCommerceRequest("GET", "reports/orders/totals");
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.message || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error getting orders totals: ${errorMessage}` }] } };
+        }
+    },
+    wc_get_products_totals: async () => {
+        try {
+            const response = await makeWooCommerceRequest("GET", "reports/products/totals");
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.message || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error getting products totals: ${errorMessage}` }] } };
+        }
+    },
+    wc_get_customers_totals: async () => {
+        try {
+            const response = await makeWooCommerceRequest("GET", "reports/customers/totals");
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.message || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error getting customers totals: ${errorMessage}` }] } };
+        }
+    },
+};

package/servers/wp-rest-bridge/build/tools/wc-settings.d.ts

@@ -0,0 +1,72 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const wcSettingTools: Tool[];
+export declare const wcSettingHandlers: {
+    wc_list_payment_gateways: () => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
+    wc_list_shipping_zones: () => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
+    wc_get_tax_classes: () => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
+    wc_get_system_status: () => Promise<{
+        toolResult: {
+            content: {
+                type: string;
+                text: string;
+            }[];
+            isError?: undefined;
+        };
+    } | {
+        toolResult: {
+            isError: boolean;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }>;
+};

package/servers/wp-rest-bridge/build/tools/wc-settings.js

@@ -0,0 +1,70 @@
+import { makeWooCommerceRequest } from '../wordpress.js';
+import { z } from 'zod';
+const wcListPaymentGatewaysSchema = z.object({}).strict();
+const wcListShippingZonesSchema = z.object({}).strict();
+const wcGetTaxClassesSchema = z.object({}).strict();
+const wcGetSystemStatusSchema = z.object({}).strict();
+export const wcSettingTools = [
+    {
+        name: "wc_list_payment_gateways",
+        description: "Lists all configured WooCommerce payment gateways with status and settings",
+        inputSchema: { type: "object", properties: wcListPaymentGatewaysSchema.shape },
+    },
+    {
+        name: "wc_list_shipping_zones",
+        description: "Lists WooCommerce shipping zones with methods and regions",
+        inputSchema: { type: "object", properties: wcListShippingZonesSchema.shape },
+    },
+    {
+        name: "wc_get_tax_classes",
+        description: "Gets WooCommerce tax classes configuration",
+        inputSchema: { type: "object", properties: wcGetTaxClassesSchema.shape },
+    },
+    {
+        name: "wc_get_system_status",
+        description: "Gets WooCommerce system status (version, environment, database, theme, plugins)",
+        inputSchema: { type: "object", properties: wcGetSystemStatusSchema.shape },
+    },
+];
+export const wcSettingHandlers = {
+    wc_list_payment_gateways: async () => {
+        try {
+            const response = await makeWooCommerceRequest("GET", "payment_gateways");
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.message || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error listing payment gateways: ${errorMessage}` }] } };
+        }
+    },
+    wc_list_shipping_zones: async () => {
+        try {
+            const response = await makeWooCommerceRequest("GET", "shipping/zones");
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.message || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error listing shipping zones: ${errorMessage}` }] } };
+        }
+    },
+    wc_get_tax_classes: async () => {
+        try {
+            const response = await makeWooCommerceRequest("GET", "taxes/classes");
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.message || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error getting tax classes: ${errorMessage}` }] } };
+        }
+    },
+    wc_get_system_status: async () => {
+        try {
+            const response = await makeWooCommerceRequest("GET", "system_status");
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.message || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error getting system status: ${errorMessage}` }] } };
+        }
+    },
+};

package/servers/wp-rest-bridge/build/types.d.ts

@@ -148,4 +148,89 @@ export interface WPTerm {
     meta: Record<string, any>[];
     _links: Record<string, any>;
 }
+export interface WCProduct {
+    id: number;
+    name: string;
+    slug: string;
+    type: string;
+    status: string;
+    description: string;
+    short_description: string;
+    sku: string;
+    price: string;
+    regular_price: string;
+    sale_price: string;
+    stock_quantity: number | null;
+    stock_status: string;
+    categories: {
+        id: number;
+        name: string;
+        slug: string;
+    }[];
+    tags: {
+        id: number;
+        name: string;
+        slug: string;
+    }[];
+    images: {
+        id: number;
+        src: string;
+        name: string;
+        alt: string;
+    }[];
+    attributes: {
+        id: number;
+        name: string;
+        options: string[];
+    }[];
+    variations: number[];
+    date_created: string;
+    date_modified: string;
+}
+export interface WCOrder {
+    id: number;
+    status: string;
+    currency: string;
+    total: string;
+    customer_id: number;
+    billing: Record<string, string>;
+    shipping: Record<string, string>;
+    line_items: {
+        id: number;
+        name: string;
+        product_id: number;
+        quantity: number;
+        total: string;
+    }[];
+    date_created: string;
+    date_modified: string;
+    payment_method: string;
+    payment_method_title: string;
+}
+export interface WCCustomer {
+    id: number;
+    email: string;
+    first_name: string;
+    last_name: string;
+    username: string;
+    billing: Record<string, string>;
+    shipping: Record<string, string>;
+    orders_count: number;
+    total_spent: string;
+    date_created: string;
+}
+export interface WCCoupon {
+    id: number;
+    code: string;
+    discount_type: string;
+    amount: string;
+    date_created: string;
+    date_expires: string | null;
+    usage_count: number;
+    usage_limit: number | null;
+    individual_use: boolean;
+    product_ids: number[];
+    minimum_amount: string;
+    maximum_amount: string;
+}
 export {};

package/servers/wp-rest-bridge/build/wordpress.d.ts

@@ -42,6 +42,15 @@ export interface PaginatedResponse<T = any> {
  * Includes automatic retry with exponential backoff and concurrency limiting.
  */
 export declare function makeWordPressRequest(method: string, endpoint: string, data?: any, options?: WordPressRequestOptions): Promise<any>;
+/**
+ * Check if a site has WooCommerce credentials configured.
+ */
+export declare function hasWooCommerce(siteId?: string): boolean;
+/**
+ * Make a request to the WooCommerce REST API.
+ * Uses Consumer Key/Secret auth and wc/v3 namespace by default.
+ */
+export declare function makeWooCommerceRequest(method: string, endpoint: string, data?: any, options?: WordPressRequestOptions): Promise<any>;
 /**
  * Search the WordPress.org Plugin Repository
  */

package/servers/wp-rest-bridge/build/wordpress.js

@@ -31,6 +31,7 @@ class ConcurrencyLimiter {
 // ── Module State ─────────────────────────────────────────────────────
 const siteClients = new Map();
 const siteLimiters = new Map();
+const wcSiteClients = new Map();
 let activeSiteId = '';
 const MAX_CONCURRENT_PER_SITE = 5;
 const DEFAULT_TIMEOUT_MS = parseInt(process.env.WP_REQUEST_TIMEOUT_MS || '30000', 10);
@@ -74,6 +75,13 @@ export async function initWordPress() {
         await initSiteClient(site.id, site.url, site.username, site.password);
         logToStderr(`Initialized site: ${site.id} (${site.url})`);
     }
+    // Initialize WooCommerce clients for sites with WC credentials
+    for (const site of sites) {
+        if (site.wc_consumer_key && site.wc_consumer_secret) {
+            await initWcClient(site.id, site.url, site.wc_consumer_key, site.wc_consumer_secret);
+            logToStderr(`Initialized WooCommerce for site: ${site.id}`);
+        }
+    }
     activeSiteId = defaultSite || sites[0].id;
     logToStderr(`Active site: ${activeSiteId}`);
 }
@@ -113,6 +121,34 @@ async function initSiteClient(id, url, username, password) {
     siteClients.set(id, client);
     siteLimiters.set(id, new ConcurrencyLimiter(MAX_CONCURRENT_PER_SITE));
 }
+/**
+ * Initialize a WooCommerce client for a site (Consumer Key/Secret auth).
+ */
+async function initWcClient(id, url, consumerKey, consumerSecret) {
+    let baseURL = url.endsWith('/') ? url : `${url}/`;
+    const wpJsonIdx = baseURL.indexOf('/wp-json');
+    if (wpJsonIdx !== -1) {
+        baseURL = baseURL.substring(0, wpJsonIdx + 1);
+    }
+    baseURL = baseURL + 'wp-json/';
+    const auth = Buffer.from(`${consumerKey}:${consumerSecret}`).toString('base64');
+    const client = axios.create({
+        baseURL,
+        headers: {
+            'Content-Type': 'application/json',
+            'Authorization': `Basic ${auth}`,
+        },
+        timeout: DEFAULT_TIMEOUT_MS,
+    });
+    // Verify WooCommerce connection
+    try {
+        await client.get('wc/v3');
+    }
+    catch (error) {
+        logToStderr(`Warning: Could not verify WooCommerce connection for ${id}: ${error.message}`);
+    }
+    wcSiteClients.set(id, client);
+}
 // ── Site Management ──────────────────────────────────────────────────
 /**
  * Get the active site's client, or a specific site's client
@@ -272,6 +308,45 @@ async function executeWithRetry(client, method, path, data, siteId, options) {
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
+// ── WooCommerce Request Interface ────────────────────────────────
+/**
+ * Check if a site has WooCommerce credentials configured.
+ */
+export function hasWooCommerce(siteId) {
+    const id = siteId || activeSiteId;
+    return wcSiteClients.has(id);
+}
+/**
+ * Get the WooCommerce client for a site.
+ */
+function getWcClient(siteId) {
+    const id = siteId || activeSiteId;
+    const client = wcSiteClients.get(id);
+    if (!client) {
+        throw new Error(`WooCommerce not configured for site "${id}". ` +
+            `Add wc_consumer_key and wc_consumer_secret to WP_SITES_CONFIG.`);
+    }
+    return client;
+}
+/**
+ * Make a request to the WooCommerce REST API.
+ * Uses Consumer Key/Secret auth and wc/v3 namespace by default.
+ */
+export async function makeWooCommerceRequest(method, endpoint, data, options) {
+    const siteId = options?.siteId || activeSiteId;
+    const client = getWcClient(siteId);
+    const limiter = getLimiter(siteId);
+    const namespace = options?.namespace || 'wc/v3';
+    const cleanEndpoint = endpoint.startsWith('/') ? endpoint.substring(1) : endpoint;
+    const path = `${namespace}/${cleanEndpoint}`;
+    await limiter.acquire();
+    try {
+        return await executeWithRetry(client, method, path, data, siteId, options);
+    }
+    finally {
+        limiter.release();
+    }
+}
 // ── Plugin Repository (External API) ────────────────────────────────
 /**
  * Search the WordPress.org Plugin Repository

package/skills/wordpress-router/references/decision-tree.md

@@ -14,7 +14,7 @@ Keywords that indicate **local environment**:
 local site, Studio, LocalWP, Local by Flywheel, wp-env, local WordPress, start site, stop site, create local site, local development, symlink plugin, local database, switch PHP version, localhost, local preview, detect environment, WASM, SQLite local
 
 Keywords that indicate **operations**:
-deploy, push to production, audit, security check, backup, restore, migrate, move site, create post, manage content, site status, check plugins, performance check, SEO audit
+deploy, push to production, audit, security check, backup, restore, migrate, move site, create post, manage content, site status, check plugins, performance check, SEO audit, WooCommerce, prodotto, ordine, coupon, negozio, catalogo, inventario, vendite, carrello
 
 Keywords that indicate **development**:
 create block, block.json, theme.json, register_rest_route, plugin development, hooks, PHPStan, build, test, scaffold, i18n, translation, accessibility, a11y, headless, decoupled, WPGraphQL
@@ -86,6 +86,8 @@ Priority: `gutenberg` > `wp-core` > `wp-site` > `wp-block-theme` > `wp-block-plu
   → `wp-site-manager` agent
 - **DNS / domain / SSL / hosting configuration**
   → `wp-site-manager` agent (Hostinger MCP tools)
+- **WooCommerce / woo / shop / products / orders / coupons / cart / store management / sales report / inventory**
+  → `wp-woocommerce` skill + `wp-ecommerce-manager` agent
 
 ## Step 2c: route by local environment intent (keywords)
 

package/skills/wp-audit/SKILL.md

@@ -112,6 +112,7 @@ Combine findings into a unified report with:
 - **`references/security-checklist.md`** - WordPress security audit checklist
 - **`references/performance-checklist.md`** - Performance analysis checklist
 - **`references/seo-checklist.md`** - SEO audit checklist
+- For WooCommerce store audit, see `wp-woocommerce` skill
 
 ## Related skills
 

package/skills/wp-backup/SKILL.md

@@ -85,3 +85,4 @@ Before any risky operation (deploy, update, migration):
 ### Reference Files
 - **`references/backup-strategies.md`** - Detailed backup methods and automation
 - **`references/restore-procedures.md`** - Step-by-step restore procedures
+- For WooCommerce database backup, see `wp-woocommerce` skill

package/skills/wp-deploy/SKILL.md

@@ -62,3 +62,4 @@ For full details on local environment operations, see the `wp-local-env` skill.
 ### Reference Files
 - **`references/hostinger-deploy.md`** - Hostinger MCP deployment details
 - **`references/ssh-deploy.md`** - SSH/SFTP deployment procedures
+- For deploying WooCommerce stores, see `wp-woocommerce` skill