woocommerce-wordpress

WooCommerce & WordPress Plugin for Claude Code

Complete WordPress and WooCommerce site management without touching the dashboard. Manage posts, pages, products, orders, media, and more directly through Claude Code.

Features

WordPress Management

• Content: Create, edit, and delete posts, pages, and custom post types
• Media: Upload and manage media library items
• Users: Manage WordPress users and roles
• Taxonomies: Organize with categories, tags, and custom taxonomies
• Comments: Moderate and respond to comments
• Site Settings: Manage menus, widgets, and templates
• Custom Fields: Full MetaBox integration for managing custom fields via REST API

WooCommerce Management

• Products: Full CRUD operations, inventory management, variations
• Orders: View, process, and update order statuses
• Customers: Manage customer data and profiles
• Coupons: Create and manage discount codes
• Shipping: Configure shipping zones and methods

Safety & Security

• Automatic Backups: Auto-backup before deletions and bulk operations
• Security Auditing: Proactive scanning for SQL injection, XSS, and vulnerabilities
• Audit Trail: Complete log of all backups and operations
• Safe Restore: Preview changes before restoring backups

Multi-Site Support

• Per-project configuration via .claude/woocommerce-wordpress.local.md
• Support for WordPress-only sites (WooCommerce optional)
• Easy switching between different sites/projects

MetaBox Integration (Optional)

• Custom Fields: Get and update custom fields for posts, pages, CPTs
• Taxonomy Fields: Manage custom fields for categories, tags, and custom taxonomies
• User Fields: Add custom data to user profiles
• Comment Fields: Extend comments with custom metadata
• Settings Pages: Access and update MetaBox settings pages
• Auto-Formatting: Complex field types (images, maps) automatically enhanced

Prerequisites

• Node.js 18+ installed
• WordPress 5.6+ (for Application Passwords)
• WooCommerce 3.5+ (if using WooCommerce features)
• HTTPS enabled on your WordPress site (required for API access)
• MetaBox plugin + MB REST API extension (optional, for custom fields support)

Installation

1. Install Plugin

Clone or symlink this plugin to Claude Code:

# Option 1: Use directly from this location
cc --plugin-dir ~/Documents/Dev/Claude-Plugins/woocommerce-wordpress

# Option 2: Symlink to user plugins directory
ln -s ~/Documents/Dev/Claude-Plugins/woocommerce-wordpress ~/.claude/plugins/woocommerce-wordpress

2. Install MCP Server Dependencies

cd ~/Documents/Dev/Claude-Plugins/woocommerce-wordpress/mcp-server
npm install

3. Configure Your Project

In your project directory, run:

/wc-wp:init

This will guide you through:

1. Entering your WordPress site URL
2. Generating Application Passwords
3. Generating WooCommerce API keys (if applicable)
4. Creating .claude/woocommerce-wordpress.local.md configuration

4. Generate Project README

After configuration, generate project-specific setup instructions:

/wc-wp:readme

Quick Start

WordPress Application Password Setup

1. Log into your WordPress admin dashboard
2. Go to Users → Profile
3. Scroll to Application Passwords section
4. Enter name: "Claude Code"
5. Click Add New Application Password
6. Copy the generated password (format: xxxx xxxx xxxx xxxx xxxx xxxx)

WooCommerce API Keys Setup

1. Log into WordPress admin
2. Go to WooCommerce → Settings → Advanced → REST API
3. Click Add Key
4. Set:
   • Description: "Claude Code"
   • User: Your admin user
   • Permissions: Read/Write
5. Copy Consumer Key and Consumer Secret

Commands

• /wc-wp:init - Initialize project configuration
• /wc-wp:readme - Generate project setup instructions
• /wc-wp:backup - Create manual backup (full or filtered)
• /wc-wp:restore - Restore from backup with preview

Skills

The plugin includes four skills that activate automatically:

1. setup-configuration - Triggers when setting up WordPress/WooCommerce API
2. content-workflows - Triggers for content management guidance
3. custom-agent-creation - Triggers when creating project-specific agents
4. metabox-integration - Triggers when working with MetaBox custom fields

Agents

• content-workflow-manager - Handles bulk operations, migrations, complex workflows
• security-auditor - Proactively scans for vulnerabilities before risky operations
• backup-manager - Advisory agent for backup strategy and orchestration

Backup System

Automatic Backups

Automatic backups are created before:

• Any deletion operation (posts, products, pages, etc.)
• Bulk update operations (updating multiple items)

Backups are stored in ./backups/ with both JSON and WordPress WXR formats.

Manual Backups

# Backup entire site
/wc-wp:backup