About etsy-seo
etsy-seo is a skill for analyzing Etsy listings and improving their search visibility. It scores listing elements, suggests keyword changes, and provides a prioritized action plan for Etsy sellers.
Key features
- 01Score listings from 0 to 100
- 02Analyze title length and keyword placement
- 03Review up to 13 tags and suggest long-tail terms
- 04Check description, attributes, and images
- 05Suggest category-based keywords
- 06Provide a prioritized action plan
Use cases
- 01Find SEO gaps in an Etsy listing
- 02Improve tags and title for Etsy search
- 03Prioritize listing changes from an analysis report
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/etsy-seoin Claude Code to confirm it loaded.
Bundled filesscripts/analyzer.py
Details
From the project READMEEtsy SEO 🔍
Analyze and optimize Etsy listings for better search visibility.
Installation
npx skills add nexscope-ai/eCommerce-Skills --skill etsy-seo -g
Features
- SEO Score — 0-100 comprehensive rating
- Title Optimization — Keyword placement, length analysis
- Tag Analysis — 13 tag optimization, long-tail suggestions
- Description Analysis — First 160 chars, keyword density
- Attribute Check — Completeness validation
- Keyword Research — Category-based suggestions
- Action Plan — Prioritized improvement roadmap
SEO Scoring Weights
| Dimension | Weight | Max Score |
|---|---|---|
| Title | 30% | 100 |
| Tags | 25% | 100 |
| Description | 20% | 100 |
| Attributes | 15% | 100 |
| Images | 10% | 100 |
Etsy Tag Rules
| Rule | Specification |
|---|---|
| Quantity | Max 13 tags |
| Length | Max 20 characters each |
| Format | Multi-word phrases allowed |
| Strategy | Long-tail + synonyms + attributes |
Title Best Practices
[Core Keyword] + [Attributes] + [Material/Style] + [Use Case/Occasion]
✅ Good:
"Personalized Name Bracelet, Custom Gold Bracelet for Women, Birthday Gift"
❌ Bad:
"Beautiful Handmade Bracelet"
Usage
Interactive Mode
python3 scripts/analyzer.py
With Listing Data
python3 scripts/analyzer.py '{
"title": "Handmade Silver Ring",
"tags": ["silver ring", "handmade jewelry"],
"description": "Beautiful handmade ring...",
"category": "Jewelry"
}'
Demo Mode
python3 scripts/analyzer.py --demo
Output Example
🔍 Etsy SEO Analysis Report
Listing: Personalized Name Bracelet
Category: Jewelry > Bracelets
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 SEO SCORE: 72/100 ⚠️
Title: 85/100 ████████░░
Tags: 65/100 ██████░░░░
Description: 70/100 ███████░░░
Attributes: 80/100 ████████░░
Images: 60/100 ██████░░░░
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📝 TITLE ANALYSIS
Current: "Handmade Silver Bracelet"
Length: 24/140 characters ⚠️ Too short
Issues:
• Missing core keyword at start
• No personalization keywords
• Missing occasion/gift keywords
Suggested:
"Personalized Silver Bracelet, Custom Name Bracelet, Birthday Gift for Her"
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🏷️ TAG ANALYSIS
Used: 8/13 tags ⚠️ Add 5 more
Current Tags:
✅ silver bracelet
✅ handmade jewelry
⚠️ bracelet (too generic)
Suggested Tags:
+ personalized bracelet
+ custom name jewelry
+ birthday gift for women
+ anniversary gift
+ minimalist bracelet
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 ACTION PLAN
Priority | Action | Impact
──────────────────────────────────────────────
HIGH | Rewrite title with keywords | +15 score
HIGH | Add 5 more tags | +10 score
MEDIUM | Optimize first 160 chars | +8 score
LOW | Add more product photos | +5 score
Keyword Research
The tool suggests keywords based on:
- Category trends
- Competitor analysis
- Search volume indicators
- Long-tail variations
Optimization Workflow
Analyze current listing
↓
Score each dimension
↓
Identify gaps
↓
Generate suggestions
↓
Prioritize actions
↓
Track improvements
Part of Nexscope AI — AI tools for e-commerce sellers.
Comments
Markdown supported