Agent skill

woocommerce

View SKILL.md on GitHub Repository
Stars 2
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/ChinchillaEnterprises/ChillSkills/tree/main/woocommerce

SKILL.md

WooCommerce Integration Skill

Overview

This skill enables Claude to work with WooCommerce REST API for e-commerce integrations, store management, and automation.

When to Use

  • User asks about WooCommerce API integration
  • Building e-commerce automation with WooCommerce
  • Syncing products, orders, or customers with external systems
  • Creating WooCommerce webhooks or data pipelines

API Authentication

Required Credentials

WOO_STORE_URL=https://your-store.com
WOO_CONSUMER_KEY=ck_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
WOO_CONSUMER_SECRET=cs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Generating API Keys

  1. Go to WooCommerce > Settings > Advanced > REST API
  2. Click Add Key
  3. Set Description, User, and Permissions (Read/Write)
  4. Click Generate API Key
  5. Save the Consumer Key and Consumer Secret immediately (secret shown only once)

Authentication Methods

  1. Basic Auth (HTTPS required): Pass consumer key as username, secret as password
  2. Query String: Append ?consumer_key=ck_xxx&consumer_secret=cs_xxx (less secure)
  3. OAuth 1.0a: For non-HTTPS environments (rare)

API Base URL

https://{store-url}/wp-json/wc/v3/

Common Endpoints

Products

bash
# List products
GET /wp-json/wc/v3/products

# Get single product
GET /wp-json/wc/v3/products/{id}

# Create product
POST /wp-json/wc/v3/products

# Update product
PUT /wp-json/wc/v3/products/{id}

# Delete product
DELETE /wp-json/wc/v3/products/{id}

# Bulk operations
POST /wp-json/wc/v3/products/batch

Orders

bash
# List orders
GET /wp-json/wc/v3/orders

# Get single order
GET /wp-json/wc/v3/orders/{id}

# Create order
POST /wp-json/wc/v3/orders

# Update order
PUT /wp-json/wc/v3/orders/{id}

# Delete order
DELETE /wp-json/wc/v3/orders/{id}

# Bulk operations
POST /wp-json/wc/v3/orders/batch

Customers

bash
# List customers
GET /wp-json/wc/v3/customers

# Get single customer
GET /wp-json/wc/v3/customers/{id}

# Create customer
POST /wp-json/wc/v3/customers

# Update customer
PUT /wp-json/wc/v3/customers/{id}

Other Endpoints

bash
# Coupons
/wp-json/wc/v3/coupons

# Product categories
/wp-json/wc/v3/products/categories

# Product attributes
/wp-json/wc/v3/products/attributes

# Shipping zones
/wp-json/wc/v3/shipping/zones

# Payment gateways
/wp-json/wc/v3/payment_gateways

# Reports
/wp-json/wc/v3/reports

Python Client

Installation

bash
pip install WooCommerce

Usage

python
from woocommerce import API

wcapi = API(
    url="https://your-store.com",
    consumer_key="ck_xxxx",
    consumer_secret="cs_xxxx",
    version="wc/v3"
)

# Get all products
products = wcapi.get("products").json()

# Create a product
data = {
    "name": "Premium T-Shirt",
    "type": "simple",
    "regular_price": "29.99",
    "description": "High quality cotton t-shirt",
    "short_description": "Premium cotton tee",
    "categories": [{"id": 9}],
    "images": [{"src": "https://example.com/image.jpg"}]
}
result = wcapi.post("products", data).json()

# Update order status
wcapi.put("orders/123", {"status": "completed"})

# Batch update products
batch_data = {
    "update": [
        {"id": 1, "regular_price": "19.99"},
        {"id": 2, "regular_price": "24.99"}
    ]
}
wcapi.post("products/batch", batch_data)

Webhooks

Available Topics

  • order.created, order.updated, order.deleted
  • product.created, product.updated, product.deleted
  • customer.created, customer.updated, customer.deleted
  • coupon.created, coupon.updated, coupon.deleted

Creating Webhooks via API

python
webhook_data = {
    "name": "Order Created Webhook",
    "topic": "order.created",
    "delivery_url": "https://your-app.com/webhooks/woo",
    "secret": "your-webhook-secret",
    "status": "active"
}
wcapi.post("webhooks", webhook_data)

Webhook Signature Verification

python
import hmac
import hashlib
import base64

def verify_woo_webhook(payload: bytes, signature: str, secret: str) -> bool:
    expected = base64.b64encode(
        hmac.new(secret.encode(), payload, hashlib.sha256).digest()
    ).decode()
    return hmac.compare_digest(expected, signature)

Common Query Parameters

bash
# Pagination
?page=1&per_page=100

# Search
?search=keyword

# Filter by status
?status=processing

# Filter by date
?after=2024-01-01T00:00:00&before=2024-12-31T23:59:59

# Order results
?orderby=date&order=desc

# Include specific fields only
?_fields=id,name,price

Error Handling

Code Meaning
400 Bad Request - Invalid parameters
401 Unauthorized - Invalid API keys
403 Forbidden - Insufficient permissions
404 Not Found - Resource doesn't exist
500 Server Error - WooCommerce/WordPress issue

Requirements

  • WooCommerce 9.0+
  • WordPress 6.7+
  • HTTPS (SSL certificate required)
  • Pretty permalinks enabled (not "Plain")

Rate Limits

WooCommerce doesn't impose strict rate limits, but hosting providers may. Recommended:

  • Max 100 requests/minute for shared hosting
  • Use batch endpoints for bulk operations
  • Implement exponential backoff for retries

Testing

bash
# Test connection
curl -X GET "https://store.com/wp-json/wc/v3/system_status" \
  -u "ck_xxxx:cs_xxxx"

# Test with query string auth (if header auth fails)
curl -X GET "https://store.com/wp-json/wc/v3/products?consumer_key=ck_xxxx&consumer_secret=cs_xxxx"

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

ChinchillaEnterprises/ChillSkills

Red Team

Use this skill when the user says "red team", "stress test", "attack this", "critique this", "run the models against this", "test this plan", "refine this with AI", or wants to use external AI models to critique, validate, or improve a document, pitch, plan, or idea. Also use when the user wants to save Claude Code usage by offloading analysis to other models.

2 0
Explore
ChinchillaEnterprises/ChillSkills

Upwork Scanner

This skill should be used when the user asks to "scan upwork", "find upwork jobs", "check upwork", "run the scanner", "look for jobs", or mentions finding freelance projects for Chinchilla AI.

2 0
Explore
ChinchillaEnterprises/ChillSkills

Polymarket Arb Scanner

This skill should be used when the user asks to "scan polymarket", "find arb opportunities", "check polymarket arbs", "run arb scanner", "polymarket arbitrage", or mentions detecting price inefficiencies on Polymarket.

2 0
Explore
ChinchillaEnterprises/ChillSkills

captain-update

2 0
Explore
ChinchillaEnterprises/ChillSkills

Polymarket Copy Trader

This skill should be used when the user asks to "copy trade", "telegram bot polymarket", "follow traders", "copy polymarket", or mentions building a copy trading bot for Polymarket.

2 0
Explore
ChinchillaEnterprises/ChillSkills

Architecture Diagram

This skill should be used when the user asks to "generate a diagram", "create an architecture diagram", "make a diagram", "draw a system diagram", or needs a branded Chinchilla AI technical diagram for proposals or documentation.

2 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results