product-description-generator

Verified·Scanned 2/18/2026

This skill generates SEO-optimized product descriptions for marketplaces and includes CLI scripts for single and bulk generation. It contains explicit shell execution examples like python3 scripts/generate_description.py and cron entries such as /path/to/product-description-generator/scripts/bulk_generate.py; no explicit external endpoints or secret access are present.

from clawhub.ai·v9928265·20.6 KB·0 installs
Scanned from 1.0.0 at 9928265 · Transparency log ↗
$ vett add clawhub.ai/michael-laffin/product-description-generator

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

# 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

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

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

Optimize Existing Description

# 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:

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:

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

# 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

# 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

# 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

# 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.