WooCommerce

This connector talks to the WooCommerce REST API v3 (/wp-json/wc/v3). Works against any WordPress + WooCommerce site. HTTPS required.

Setup

1. WOOCOMMERCE_URL — site root (e.g. https://shop.example.com). Do NOT include /wp-json; the adapter appends /wp-json/wc/v3.
2. WOOCOMMERCE_CONSUMER_KEY + WOOCOMMERCE_CONSUMER_SECRET — generate in WP admin → WooCommerce → Settings → Advanced → REST API → Add key. Use Read/Write for full functionality.

The key and secret travel as the consumer_key / consumer_secret query parameters, the method WooCommerce documents for servers that drop the Authorization header (common behind Apache with CGI/FastCGI and some firewalls). That is only allowed over HTTPS, so the site must use https://.

Pagination

List endpoints default to per_page=10, max 100. Pass explicit per_page + iterate page for full catalog scans. Total counts are in X-WP-Total / X-WP-TotalPages headers (not returned in the JSON body).

Bulk writes

For ≥ 3 product updates use woocommerce_batch_update_products (one call, up to 100 entries). Don't fan out single update_product calls.

SEO meta (Yoast / Rank Math) on products

Meta lives in the meta_data array on the product. Set it via woocommerce_update_product:

"meta_data": [
  { "key": "_yoast_wpseo_metadesc", "value": "..." },
  { "key": "_yoast_wpseo_focuskw", "value": "..." }
]

Rank Math: rank_math_description, rank_math_focus_keyword, rank_math_title. Full reference: wordpress_list_seo_meta_keys (sibling WordPress connector).

Multi-step workflows

For inventory optimisation, product SEO, upsell/cross-sell, low-conversion analysis, abandoned-order triage, or KPI snapshots → call the dedicated woocommerce_skill_* tool. It returns the step-by-step playbook on demand. Don't preload that knowledge here.

Enum reference cards

Valid values for order status / product type / stock status / report period / payment methods → call woocommerce_list_*_options.

Permissions cheat-sheet

• All list / get / reports: Read-only key.
• Product create/update/delete, order update, refund, batch: Read/Write key.
• Customer create / coupon create: Read/Write key.