Product Description Generator

---
name: product-description-generator
description: Generate SEO-optimized product descriptions for e-commerce platforms (Amazon, Shopify, eBay, Etsy). Create compelling, conversion-focused copy with keywords, features, benefits, and calls-to-action. Use when creating product listings, optimizing existing descriptions, or generating bulk product copy.
---

# Product Description Generator

## Overview

Generate high-converting, SEO-optimized product descriptions for any e-commerce platform. Create compelling copy that drives sales while improving search visibility across multiple marketplaces.

## Core Capabilities

### 1. Platform-Specific Optimization

**Supported Platforms:**
- **Amazon** - Title, bullet points, description, search terms, backend keywords
- **Shopify** - Product title, description, SEO meta data
- **eBay** - Item title, description, item specifics, condition description
- **Etsy** - Listing title, description, tags, materials, attributes
- **Shopify/WooCommerce** - Product name, description, SEO elements
- **Custom** - Flexible format for any platform

### 2. SEO Optimization

**Automatically includes:**
- Primary keyword placement (title, first paragraph)
- Secondary keywords throughout content
- Long-tail keyword variations
- Semantic keywords and related terms
- Optimized character counts for each platform
- Meta descriptions and titles for SEO

### 3. Conversion-Focused Copy

**Elements that drive sales:**
- Benefit-oriented features (not just specs)
- Emotional triggers and storytelling
- Social proof integration
- Urgency and scarcity elements
- Clear value propositions
- Strong calls-to-action
- Objection handling

### 4. Structure Templates

**Product description structure:**
1. **Hook** - Attention-grabbing opening
2. **Problem/Agitation** - Address pain points
3. **Solution** - How your product helps
4. **Features → Benefits** - What it does and why it matters
5. **Social Proof** - Reviews, testimonials, stats
6. **Use Cases** - When/how to use the product
7. **Specifications** - Technical details
8. **FAQ** - Common questions answered
9. **CTA** - Clear action to take

### 5. Bulk Generation

**Generate descriptions for:**
- Multiple products from CSV
- Product variations (colors, sizes, models)
- A/B testing variations
- Multiple platforms simultaneously
- International markets (localization)

## Quick Start

### Generate Amazon Listing

```python
# Use scripts/generate_description.py
python3 scripts/generate_description.py \
  --product "Wireless Bluetooth Headphones" \
  --platform amazon \
  --features "40hr battery,noise cancelling,Bluetooth 5.3" \
  --benefits "crystal clear audio,comfortable fit,fast charging" \
  --tone professional \
  --output amazon_listing.md
```

### Generate Shopify Product Description

```python
python3 scripts/generate_description.py \
  --product "Ergonomic Office Chair" \
  --platform shopify \
  --features "adjustable lumbar support,360° swivel,breathable mesh" \
  --tone conversational \
  --include-faq \
  --output shopify_description.md
```

### Bulk Generate from CSV

```python
# Use scripts/bulk_generate.py
python3 scripts/bulk_generate.py \
  --csv products.csv \
  --platform amazon \
  --output-dir ./descriptions
```

### Optimize Existing Description

```python
# Use scripts/optimize_description.py
python3 scripts/optimize_description.py \
  --input existing_description.md \
  --target-keyword "wireless headphones" \
  --platform amazon \
  --output optimized.md
```

## Scripts

### `generate_description.py`
Generate product description for a single product.

**Parameters:**
- `--product` (required): Product name/title
- `--platform` (required): Target platform
- `--features`: Product features (comma-separated)
- `--benefits`: Benefits/value proposition (comma-separated)
- `--tone`: Tone preference (professional, conversational, playful, luxury)
- `--target-audience`: Who is this for?
- `--keywords`: SEO keywords (comma-separated)
- `--include-faq`: Include FAQ section
- `--include-specs`: Include specifications section
- `--output`: Output file

**Example:**
```bash
python3 scripts/generate_description.py \
  --product "Smart WiFi Thermostat" \
  --platform amazon \
  --features "energy saving,app control,7-day programming" \
  --benefits "lower energy bills,remote access,comfort" \
  --target-audience "homeowners,smart home enthusiasts" \
  --keywords "smart thermostat,programmable thermostat,WiFi thermostat" \
  --include-faq \
  --include-specs \
  --output thermostat_description.md
```

### `bulk_generate.py`
Generate descriptions for multiple products from CSV.

**CSV Format:**
```csv
product,features,benefits,tone,target_audience,keywords
"Wireless Headphones","40hr battery,noise cancelling","clear audio,comfort","professional","audiophiles","headphones,bluetooth"
"Ergonomic Chair","lumbar support,mesh back","back pain relief,comfort","conversational","office workers","office chair,ergonomic"
"Smart Thermostat","energy saving,app control","lower bills,remote control","professional","homeowners","thermostat,smart home"
```

**Parameters:**
- `--csv`: Path to CSV file
- `--platform`: Target platform (applies to all products)
- `--output-dir`: Output directory
- `--format`: Output format (markdown, html, csv)

### `optimize_description.py`
Optimize an existing product description for SEO and conversions.

**Parameters:**
- `--input`: Input file path
- `--target-keyword`: Primary keyword to optimize for
- `--platform`: Target platform
- `add-cta`: Add strong call-to-action
- `add-social-proof`: Add social proof placeholders
- `output`: Output file

### `generate_variations.py`
Generate A/B testing variations of a description.

**Parameters:**
- `--input`: Base description file
- `--variations`: Number of variations to generate (default: 3)
- `--test-elements`: Elements to test (cta, hook, benefits)
- `--output-dir`: Output directory

### `seo_analyzer.py`
Analyze SEO score of product description.

**Parameters:**
- `--input`: Description to analyze
- `--target-keyword`: Primary keyword
- `--platform`: Platform-specific analysis
- `--output`: Analysis report

## Platform-Specific Guidelines

### Amazon
- **Title:** 150-200 characters, primary keyword first
- **Bullet Points:** 5-7 points, benefit-focused
- **Description:** 2000-3000 characters, full product story
- **Backend Keywords:** 250 bytes, comma-separated
- **Style:** Professional, informative, detailed

### Shopify
- **Title:** 70 characters for optimal display
- **Description:** 300-500 words, HTML supported
- **Meta Description:** 155 characters for SEO
- **Handle:** 75 characters max, SEO-friendly URL
- **Style:** Brand-consistent, visual, lifestyle-oriented

### eBay
- **Title:** 80 characters optimal, include key details
- **Description:** 500-1000 words, HTML allowed
- **Item Specifics:** Fill all relevant fields
- **Condition:** Clearly state condition
- **Style:** Auction-style urgency, detailed specs

### Etsy
- **Title:** 140 characters, front-load keywords
- **Description:** 500+ words, handmade story
- **Tags:** 13 tags, 20 characters each
- **Materials:** Accurate listing
- **Style:** Personal, story-driven, handmade emphasis

## Best Practices

### Write Benefits, Not Just Features
- **Bad:** "40-hour battery life"
- **Good:** "40-hour battery means you can listen for days without charging"

### Use Emotional Triggers
- "Transform your daily routine"
- "Experience the difference quality makes"
- "Join thousands of satisfied customers"

### Include Social Proof
- "Trusted by 10,000+ customers"
- "4.8/5 star average rating"
- "30-day money-back guarantee"

### Handle Objections
- "Worried about fit? We offer free returns"
- "Not sure? Try it risk-free for 30 days"
- "Questions? Our US-based support is here 24/7"

### Strong CTAs
- "Order now and get free shipping"
- "Limited stock - add to cart today"
- "Join the thousands who upgraded their experience"

## Tone Guidelines

### Professional
- **Best for:** B2B, tech products, high-ticket items
- **Characteristics:** Authoritative, data-driven, precise
- **Example:** "Engineered for performance. Backed by science."

### Conversational
- **Best for:** Consumer products, lifestyle items
- **Characteristics:** Friendly, relatable, personal
- **Example:** "You're going to love how this fits into your daily routine."

### Playful
- **Best for:** Trendy items, younger audiences
- **Characteristics:** Fun, energetic, emoji-friendly
- **Example:** "Ready to level up? Let's do this! 🚀"

### Luxury
- **Best for:** Premium products, jewelry, designer items
- **Characteristics:** Elegant, exclusive, sophisticated
- **Example:** "Experience unparalleled craftsmanship. A masterpiece of design."

## Automation

### Daily Bulk Generation

```bash
# Generate descriptions for all products in catalog
0 8 * * * /path/to/product-description-generator/scripts/bulk_generate.py \
  --csv /path/to/products.csv \
  --platform amazon \
  --output-dir /path/to/output
```

### A/B Testing Automation

```bash
# Generate variations for top-selling products
0 9 * * 1 /path/to/product-description-generator/scripts/generate_variations.py \
  --input /path/to/bestsellers/ \
  --variations 3 \
  --output-dir /path/to/ab-tests
```

## Integration Opportunities

### With SEO Article Generator
```bash
# 1. Generate SEO-optimized article
seo-article-gen --keyword "wireless headphones review"

# 2. Extract key benefits and features
# 3. Generate product description
product-description-generator --product "[name]" --features "[extracted]"
```

### With Review Summarizer
```bash
# 1. Analyze reviews for insights
review-summarizer/scrape_reviews.py --url "[product_url]"

# 2. Extract top pros/cons
# 3. Generate description addressing cons
product-description-generator --product "[name]" --benefits "[address cons]"
```

## Output Formats

### Markdown
Best for documentation, CMS without HTML support, easy reading.

### HTML
Best for Amazon, Shopify, eBay - formatted with tags.

### CSV
Best for bulk upload, catalog management systems.

---

**Drive sales. Rank higher. Convert visitors.**