WooScribe AI
Product Description Writer

1 Introduction

WooScribe AI is a WordPress plugin that uses Anthropic Claude to automatically write professional, SEO-optimised product descriptions for your WooCommerce store. Whether you have 10 products or 10,000, WooScribe AI saves you hours of writing work and produces consistent, high-quality copy in seconds.

What WooScribe AI Does

Requirements

2 Getting Your Anthropic API Key

WooScribe AI uses your own Anthropic API key — you pay only for what you generate, with no subscription markup. Here's how to get a key:

1. 1
   Visit console.anthropic.com and click Sign Up (or Log In if you already have an account)
2. 2
   Complete email verification. You'll land on the Anthropic Console dashboard.
3. 3
   Navigate to Billing in the left sidebar and click Add Credits. Enter your card details and add at least $5 — this is enough for thousands of descriptions.
4. 4
   Navigate to API Keys in the left sidebar and click Create Key. Give it a name like "WooScribe AI".
5. 5
   Copy the key immediately — it starts with sk-ant- and is shown only once. Paste it somewhere safe before closing the page.

How Much Does It Cost?

3 Installation

Installing via WordPress Admin

1. 1
   Log in to your WordPress admin (yoursite.com/wp-admin)
2. 2
   Go to Plugins → Add New → Upload Plugin
3. 3
   Click Choose File and select wooscribe-ai.zip downloaded from CodeCanyon
4. 4
   Click Install Now, then Activate Plugin
5. 5
   Navigate to WooCommerce → WooScribe AI to open Settings

What Happens on Activation

• Creates a wp_wooscribe_usage database table for tracking token usage and costs
• Seeds default settings (model: Claude Haiku, tone: Professional, language: English)
• Registers Action Scheduler hooks for background bulk processing
• Adds the Generate Description metabox to all WooCommerce product edit screens
• Adds the WooScribe AI: Generate Descriptions option to the Products bulk actions menu

4 Plugin Settings

After activating, go to WooCommerce → WooScribe AI to configure the plugin.

API Key

Paste your Anthropic API key (sk-ant-...) into the API Key field. The field is masked by default — click Show to reveal it.

After entering your key, click Test Connection to verify it works. A green "Connection successful" message confirms the key is valid and has available credit.

Saving Settings

After making any changes, scroll to the bottom and click Save Settings. A success message confirms the settings were saved.

5 Single Product Generation

For individual products, WooScribe AI adds a generation panel directly on the product edit screen — no need to leave the page.

The Generate Panel

1. 1
   Open any product in WooCommerce (Products → Edit or click a product name)
2. 2
   Find the WooScribe AI panel — it appears in the right sidebar or below the product data tabs
3. 3
   Optionally tick Also generate short description if you want both descriptions written
4. 4
   Click Generate Description — the button shows a loading spinner for 3–8 seconds while Claude writes
5. 5
   The generated text appears in a preview panel. Review it — you can scroll to read the full description
6. 6
   Click Apply to insert the description into the product editor, or Regenerate to try again
7. 7
   Click Update (the WordPress publish button) to save the product

Apply vs Regenerate

6 Bulk Generation

The bulk generation feature lets you generate descriptions for hundreds of products at once. It runs in the background using Action Scheduler — you can navigate away and come back when it's done.

Selecting Products & Starting

1. 1
   Go to WooCommerce → Products
2. 2
   Use the checkboxes to select the products you want. Tip: use the Select All checkbox at the top to select all on the current page, or filter first by category/tag to get a specific group.
3. 3
   Open the Bulk Actions dropdown at the top of the list
4. 4
   Select WooScribe AI: Generate Descriptions
5. 5
   Click Apply — you'll be redirected to a progress page

The Progress Bar

After starting bulk generation, you're redirected to a progress page that updates every 2 seconds:

7 Choosing an AI Model

WooScribe AI supports two Anthropic Claude models. Switch between them in WooCommerce → WooScribe AI → Settings.

8 Writing Tones

WooScribe AI includes four writing tones. The selected tone shapes how Claude writes — from the vocabulary it chooses to the emotional register of the copy. Set your default tone in Settings, then override it per-product if needed.

Example Output: The Same Product in Each Tone

Here's how WooScribe AI might describe a leather wallet in each tone:

9 Languages

WooScribe AI can generate product descriptions in six languages. Select your output language in Settings — all subsequent generations (single and bulk) will use that language.

10 SEO Keywords

Enter a Target SEO Keyword in Settings and Claude will weave it naturally into every product description — without awkward keyword stuffing. The keyword appears in a way that reads naturally while signalling relevance to search engines.

Tips for Effective Keywords

• Use category-level keywords for bulk runs — e.g. "handmade jewellery" rather than a specific product name
• Use long-tail keywords for better targeting — "waterproof hiking boots for men" converts better than "boots"
• Match search intent — think about what your buyer types into Google, not what you call the product internally
• Clear the keyword before bulk runs for unrelated categories to avoid forcing irrelevant terms

11 Budget Alerts

The Monthly Budget Alert setting lets you set a spending threshold. When your estimated monthly API spend reaches 80% of the threshold, an admin notice appears at the top of every WordPress admin page — once per hour.

Budget Progress Bar

The budget bar is visible on the WooScribe AI Settings page under the usage stats section. It shows your current month's estimated spend vs. your threshold.

12 Usage Dashboard

WooScribe AI tracks every generation and displays usage statistics in two places: the Settings page and a WordPress dashboard widget.

Usage Stats Widget

Three Reporting Periods

13 Troubleshooting

"Test Connection" Fails

• Invalid key format: Ensure the key starts with sk-ant- and has no leading/trailing spaces
• No credits: Top up your Anthropic account at console.anthropic.com/billing
• Firewall: Your server may be blocking outbound HTTPS requests to api.anthropic.com — contact your host
• Wrong key: Keys are shown only once — if you've lost it, create a new one at console.anthropic.com/api-keys

Generated Description Is Empty or Short

• Add more product attributes (size, material, colour, weight, etc.) to give Claude more to work with
• Ensure the product has a proper name — a product named "Product 1" will produce a poor description
• Add the product to at least one category — Claude uses category context to understand the product type
• Try switching to Claude Sonnet for products with limited attribute data

Bulk Generation Stops Partway Through

• Check WP Admin → Tools → Scheduled Actions for any failed wooscribe_process_bulk_job actions and view the error details
• Ensure your PHP max_execution_time is at least 60 seconds — contact your host to increase it
• Check if your Anthropic API has hit its rate limit — Haiku allows 50 requests/minute, Sonnet allows 5/minute
• The progress page only shows for the current session. If you closed it, check individual products — completed ones will already have descriptions.

The WooScribe AI Metabox Doesn't Appear

• Ensure WooCommerce is active — WooScribe AI requires WooCommerce to be installed and active
• Check Screen Options (top-right of the product edit page) — ensure "WooScribe AI" is ticked
• Try deactivating and reactivating the plugin

Usage Stats Show $0 After Generating

• Stats are written after each successful generation. If generation failed, no usage is logged.
• Check if the wp_wooscribe_usage table exists in your database — if not, deactivate and reactivate the plugin to recreate it.

14 Quick Reference

Settings Cheat Sheet

Single Product Workflow

1. 1
   Products → Edit product → Find WooScribe AI panel
2. 2
   Click Generate Description → wait 3–8 seconds
3. 3
   Review preview → click Apply
4. 4
   Click Update to save the product

Bulk Workflow

1. 1
   WooCommerce → Products → Select products
2. 2
   Bulk Actions → WooScribe AI: Generate Descriptions → Apply
3. 3
   Monitor the progress bar — green = done, blue = in progress
4. 4
   Navigate away if needed — generation continues in background

Model Quick Pick