pf-product-copy

Generate expert-level, conversion-optimized product copy from a CSV/XLSX catalog — Alternative to Describely and Jasper AI.

Version: 1.1 Target platforms: Amazon, Shopify, Etsy, WooCommerce

Installation

1. Download the pf-product-copy.plugin file
2. Open Claude Desktop and navigate to Settings > Plugins
3. Click Install Plugin and select the downloaded .plugin file
4. The plugin will be installed and available immediately

Note: All data stays local on your machine. No external API calls or cloud storage required.

What It Does

pf-product-copy is an alternative to $336–$1,200/yr SaaS tools (Describely, Jasper AI, Hypotenuse AI) by using Claude to generate brand-voice-consistent product descriptions, SEO titles, bullet points, and meta descriptions — all locally with no per-product fees.

Pipeline:

1. Import your product catalog (CSV or XLSX)
2. Generate copy using your brand voice profile + copywriting frameworks
3. Format for your target marketplace(s)
4. Audit SEO quality and regulatory compliance
5. Export platform-ready upload files + a DOCX review document

Quick Start

/product-copy:product-copy-setup

→ Place your catalog in inbound/

/product-copy:product-copy-full catalog.csv

→ Generates and exports all files in one run

Commands

Command	Description
/product-copy:product-copy-setup	Initialize workspace and brand voice
/product-copy:product-copy-import	Import catalog from CSV/XLSX
/product-copy:product-copy-generate	Generate product copy (with checkpoint/resume)
/product-copy:product-copy-format	Format for marketplace requirements
/product-copy:product-copy-export	Export CSV files + DOCX review doc
/product-copy:product-copy-seo-audit	Audit SEO quality with 4-dimension scoring
/product-copy:product-copy-compliance	Check copy against FTC/FDA/CPSC regulations
/product-copy:product-copy-full	Run full pipeline in one command
/product-copy:product-copy-status	Show pipeline progress
/product-copy:product-setup	Alias for product-copy-setup

Workspace Layout

.product-copy/        ← Config and state (brand-voice.json, config.json)
  └── logs/           ← Run logs
knowledge/            ← Domain knowledge base (ecommerce-copywriting-kb.json)
inbound/              ← Drop your catalog CSV/XLSX here
processing/           ← Intermediate JSON files (auto-managed)
outbound/             ← Platform-ready upload files
archive/              ← Timestamped snapshots of previous runs

Output Files

File	Format	Use for
amazon-bulk-upload.csv	Amazon flat file	Seller Central bulk upload
shopify-bulk-import.csv	Shopify product CSV	Admin → Products → Import
etsy-bulk-upload.csv	Etsy batch format	Etsy Shop Manager
woocommerce-import.csv	WooCommerce CSV	WP Admin → Products → Import
product-copy-review.docx	Word document	Human QA with SEO scores and compliance flags
seo-audit-report.json	JSON	Per-product SEO scorecards
compliance-report.json	JSON	Regulatory compliance scan results

AI-Powered Features

• Copywriting Framework Selection: Automatically selects AIDA, FAB, PAS, or Storytelling framework per product category — electronics get spec-heavy FAB, fashion gets lifestyle AIDA, home products get problem-solving PAS (based on E. St. Elmo Lewis, IBM methodology, Dan Kennedy, Donald Miller StoryBrand)
• SEO Keyword Optimization: Places primary keywords in title first 80 chars, secondary in bullet prefixes, long-tail in description body per Backlinko/Ahrefs e-commerce SEO research; validates Amazon backend keywords by byte count (249-byte limit per 2024 Seller Central update)
• Readability Targeting: Targets Flesch-Kincaid Grade 6-8 for mass market products, Grade 10-12 for technical products, Grade 9-11 for luxury — per Nielsen Norman Group e-commerce UX studies
• Compliance Checking: Scans copy against FTC 16 CFR Part 255 endorsement guidelines, FDA 21 CFR Part 740 cosmetic labeling rules, FTC Green Guides 16 CFR Part 260, CPSC/CPSIA Section 101 children's safety, and Amazon restricted claim policies
• Emotional Trigger Integration: Applies Cialdini persuasion principles (authority, social proof, sensory language) appropriate to each product category
• 4-Dimension SEO Audit: Scores keyword placement, keyword density, readability, and marketplace-specific optimization with actionable improvement recommendations
• Brand Voice Consistency: Maintains consistent tone and messaging across entire product catalog with banned words enforcement
• Category-Specific Patterns: 6 pre-configured category patterns (electronics, fashion, home/kitchen, health/beauty, sports/outdoor, toys/kids) with optimized title formulas, bullet emphasis, and keyword focus
• Bulk Processing: Handles 100+ products in single batch with checkpoint/resume for interrupted runs
• Platform-Specific Formatting: Formats copy for Amazon (A10 algorithm optimized), Shopify (Google SEO), Etsy (search-indexed tags), WooCommerce (Yoast SEO) with source-cited spec compliance

Feature Comparison

Feature	pf-product-copy v1.1	Describely ($336/yr)	Jasper AI ($588/yr)
Copywriting framework selection (AIDA/FAB/PAS)	Yes	No	Partial
Category-specific generation patterns	Yes (6 categories)	Limited	No
FTC/FDA compliance scanning	Yes	No	No
SEO 4-dimension audit scoring	Yes	Basic	Basic
Readability targeting by category	Yes (Flesch-Kincaid)	No	No
Amazon A10 keyword optimization	Yes	Partial	No
Etsy tag optimization (13×20 chars)	Yes	No	No
Cialdini emotional trigger integration	Yes	No	No
Backend keyword byte validation	Yes (249 bytes)	No	No
Domain knowledge base with source citations	Yes	No	No
Checkpoint/resume for large catalogs	Yes	No	No
DOCX review with compliance flags	Yes	No	No
Per-product cost	$0	$0.05-0.15	$0.10-0.25

Estimated Cost per Use

Disclaimer: Token estimates are approximate and based on typical usage patterns measured from skill prompt sizes. Actual costs vary with input data size, conversation length, and complexity. Estimates use Claude Sonnet 4.6 pricing ($3/1M input, $15/1M output). Cowork and Claude Desktop subscription users (Pro/Max/Team) are not charged per-token — these estimates apply only to direct Anthropic API usage. Running stages individually in fresh sessions uses fewer input tokens than running the full pipeline sequentially, because pipeline mode accumulates conversation history across stages.

Per skill (run individually in a fresh session):

Stage	Skill Prompt	User Input	Total Input	Output	Est. Cost
product-copy-generate	~5.4K	~800	~9.0K	~6.0K	~$0.12
product-copy-format	~4.1K	~800	~7.7K	~4.1K	~$0.08
product-copy-export	~4.0K	~800	~7.6K	~6.0K	~$0.11
product-copy-import	~2.6K	~2.0K	~7.4K	~2.0K	~$0.05
product-copy-seo-audit	~2.9K	~800	~6.3K	~4.0K	~$0.08
Standalone total			~38.0K	~22.1K	~$0.45

Full pipeline (all stages in one session — context accumulates):

Stage	Base Input	+ History	Total Input	Output	Est. Cost
product-copy-generate	~9.1K	0	~9.1K	~6.0K	~$0.12
product-copy-format	~7.8K	~6.8K	~14.6K	~4.1K	~$0.11
product-copy-export	~7.6K	~11.7K	~19.3K	~6.0K	~$0.15
product-copy-import	~7.5K	~18.5K	~26.0K	~2.0K	~$0.11
product-copy-seo-audit	~6.6K	~22.5K	~29.1K	~4.0K	~$0.15
Pipeline total			~98.1K	~22.1K	~$0.63

Running the full pipeline once typically costs $0.44–$0.81 in API tokens (Claude Sonnet 4.6).

Known Limitations

1. No direct marketplace API integration — This plugin generates upload-ready files but cannot push copy directly to Amazon/Shopify/Etsy. You must bulk-upload the CSV manually through each platform's import tool.

2. Context window limits for very large catalogs — Catalogs with 200+ products and verbose specs may require multiple sessions. Use the checkpoint/resume feature (--resume flag) to continue interrupted runs without losing progress.

3. No persistent catalog version history — Each run reads from products.json and overwrites copy-drafts.json. Use the archive/ folder to preserve previous run outputs.

4. Price and inventory columns not populated — Export CSV files leave price/quantity fields blank. These must be filled in through your platform dashboard or manually in the exported CSV before uploading.

5. Marketplace format specs may change — Amazon, Etsy, and other platforms periodically update their bulk import column requirements. If an upload fails, verify the current column spec in the platform's help docs and update the *_HEADERS constants in scripts/export-copy.py.

6. Compliance checks are advisory — The compliance scanner flags potential regulatory issues but is NOT legal advice. Sellers should consult legal counsel for final compliance decisions.

Dependencies

• python3 (built-in)
• openpyxl — for XLSX catalog import (pip install openpyxl)
• python-docx — for DOCX review document (pip install python-docx)

The setup command installs these automatically.

Version History

See CHANGELOG.md.

Important Disclaimers

• AI-Generated Content: This plugin uses AI (LLM) technology which can produce inaccurate or incomplete outputs. All content should be treated as a starting point and reviewed for accuracy before use.
• Not Professional Advice: Outputs do not constitute legal, financial, tax, medical, or other professional advice. Consult qualified professionals before making decisions based on generated content.
• No Compliance Guarantee: References to industry standards, regulations, or guidelines are for informational purposes only. This plugin does not guarantee compliance with any law or regulation. Users are responsible for verifying all outputs meet their specific regulatory requirements.
• No Endorsement or Affiliation: Mention of third-party products, standards, or organizations does not imply endorsement, partnership, or certification by those entities.