agentleFS
nexscope-ainexscope-ai/eCommerce-Skills/etsy-seo/SKILL.md

etsy-seo

Skill846 starsChanged 7 months agoMITView on GitHub

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.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

Etsy 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

DimensionWeightMax Score
Title30%100
Tags25%100
Description20%100
Attributes15%100
Images10%100

Etsy Tag Rules

RuleSpecification
QuantityMax 13 tags
LengthMax 20 characters each
FormatMulti-word phrases allowed
StrategyLong-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.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.