woo-productscribe-mcp-server

# ProductScribe MCP Server AI-powered WooCommerce product content generator, SEO optimizer, and bulk content manager — built as a Model Context Protocol (MCP) server for Claude. **No separate AI API needed.** Claude (the model running this MCP) handles all content generation natively. --- ## What It Does | Problem | ProductScribe Tool | |---|---| | 200 imported products with terrible supplier descriptions | `audit` → `analyze_brand_voice` → `bulk_apply_template` | | Single product needs SEO rewrite | `optimize_for_seo` → `apply_generated_content` | | Missing meta descriptions across your catalog | `generate_meta_descriptions` | | Expanding to new markets | `translate_product_content` | | New product needs on-brand description | `analyze_brand_voice` → `generate_product_description` | --- ## Tools | Tool | Description | |---|---| | `productscribe_audit_product_content` | Scan products for content gaps: missing descriptions, alt text, meta descriptions. Returns scored report (0–100). | | `productscribe_analyze_brand_voice` | Sample top-selling/rated products to extract your store's tone, vocabulary, sentence structure, and formatting patterns. | | `productscribe_generate_product_description` | Build a generation prompt for a specific product using brand voice + SEO target. Preview before saving. | | `productscribe_apply_generated_content` | Save AI-generated descriptions and meta data to WooCommerce (supports dry-run). | | `productscribe_optimize_for_seo` | Score current product SEO health and build a keyword-optimized rewrite prompt. | | `productscribe_generate_meta_descriptions` | Bulk meta description generation for a category or product list (respects 160-char SERP limit). | | `productscribe_bulk_apply_template` | Generate consistent descriptions across an entire category using a template + brand voice. Paginates safely. | | `productscribe_translate_product_content` | Translate product descriptions to up to 5 languages simultaneously with HTML preservation. | --- ## Quick Start ### 1. Get WooCommerce API Keys 1. Go to **WooCommerce → Settings → Advanced → REST API** 2. Click **Add key** 3. Set permissions to **Read/Write** 4. Copy the Consumer Key and Consumer Secret ### 2. Install & Build ```bash git clone https://github.com/vishalkakadiya/woo-productscribe-mcp-server cd woo-productscribe-mcp-server npm install npm run build ``` ### 3. Configure Environment Variables ```bash export WC_STORE_URL=https://yourstore.com export WC_CONSUMER_KEY=ck_xxxxxxxxxxxxxxxxxxxx export WC_CONSUMER_SECRET=cs_xxxxxxxxxxxxxxxxxxxx ``` ### 4. Add to Claude Desktop Edit `~/Library/Application Support/Claude/claude_desktop_config.json`: ```json { "mcpServers": { "productscribe": { "command": "node", "args": ["/absolute/path/to/woo-productscribe-mcp-server/dist/index.js"], "env": { "WC_STORE_URL": "https://yourstore.com", "WC_CONSUMER_KEY": "ck_xxxxxxxxxxxxxxxxxxxx", "WC_CONSUMER_SECRET": "cs_xxxxxxxxxxxxxxxxxxxx" } } } } ``` Restart Claude Desktop. --- ## Demo Workflow: Rewrite 200 Imported Products > *"I just imported 200 products from a supplier with terrible descriptions. Match my brand voice from my top 20 sellers and rewrite them all, optimized for SEO."* **Step 1 — Audit what's broken:** ``` Call: productscribe_audit_product_content severity_filter: "critical" limit: 50 ``` **Step 2 — Extract your brand voice:** ``` Call: productscribe_analyze_brand_voice sample_size: 20 source: "top_selling" ``` **Step 3 — Bulk rewrite by category (batches of 20):** ``` Call: productscribe_bulk_apply_template category_id: 5 template: "Discover our {product_name} — {key_feature}. {benefit}." brand_voice_guidelines: <profile from step 2> target_keyword_pattern: "buy {product_name} online" limit: 20 offset: 0 ``` Claude generates all 20 descriptions. Then repeat with `offset: 20`, `offset: 40`, etc. **Step 4 — Apply each generated description:** ``` Call: productscribe_apply_generated_content product_id: 101 description: "<p>...</p>" short_description: "..." ``` **Step 5 — SEO check on key products:** ``` Call: productscribe_optimize_for_seo product_id: 101 target_keyword: "organic cotton t-shirt" ``` --- ## HTTP Transport (Optional) For remote/multi-client deployments: ```bash TRANSPORT=http PORT=3000 node dist/index.js ``` The server listens at `POST /mcp`. Health check: `GET /health`. --- ## SEO Scoring The built-in SEO analyzer checks: | Check | Scoring Impact | |---|---| | Word count < 150 | -25 (critical) | | Word count 150–300 | -10 (warning) | | Target keyword missing | -30 (critical) | | Keyword density < 2% | -10 (warning) | | Keyword stuffing > 4% | -15 (warning) | | Low readability (Flesch < 40) | -10 (warning) | | Missing meta description | -20 (critical) | | Meta description too long (> 160 chars) | -5 (warning) | | No HTML structure | Info only | --- ## Multi-Language Support Supported language codes: `es`, `fr`, `de`, `it`, `pt`, `nl`, `pl`, `ru`, `ja`, `zh`, `ar`, `ko`, `tr`, `sv`, `da`, `fi`, `nb`, `cs`, `hu`, `ro` Use with **WPML**, **Polylang**, or **TranslatePress** to store translated content as product language variants. --- ## Environment Variables | Variable | Required | Description | |---|---|---| | `WC_STORE_URL` | Yes | Your WooCommerce store URL (e.g., `https://yourstore.com`) | | `WC_CONSUMER_KEY` | Yes | WooCommerce REST API consumer key | | `WC_CONSUMER_SECRET` | Yes | WooCommerce REST API consumer secret | | `TRANSPORT` | No | `stdio` (default) or `http` | | `PORT` | No | HTTP port (default: `3000`) | --- ## Development ```bash # Watch mode (no build needed) npm run dev # Production build npm run build # Test with MCP Inspector npx @modelcontextprotocol/inspector node dist/index.js ```