etsy-seo

★ 319

by nexscope-ai · part of nexscope-ai/ecommerce-skills

Etsy SEO analyzer and optimizer. Improve search visibility with title optimization, tag analysis, description scoring, and keyword research. Includes SEO scoring (0-100), long-tail keyword suggestions, and prioritized action plans. No API key required.

🧩 One of 7 skills in the nexscope-ai/ecommerce-skills package — works on its own, and pairs well with its siblings.

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

Etsy SEO 🔍

Analyze and optimize Etsy listings for better search visibility.

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"

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.

Copy & paste — that's it

npx skills add https://github.com/nexscope-ai/ecommerce-skills --skill etsy-seo

Run this in your project — your agent picks the skill up automatically.

Installation

npx skills add nexscope-ai/eCommerce-Skills --skill etsy-seo -g

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