Etsy Seo

Etsy SEO analyzer and optimizer. Improve search visibility with title optimization, tag analysis, description scoring, and keyword research. Includes SEO sco...

Security Scan

The skill's files and runtime instructions are internally consistent with an offline Etsy listing analyzer — it doesn't request credentials or declare installs — but you should verify the full Python script for any unexpected network or subprocess calls before running it on real data.

Purpose & Capability

Name/description (Etsy SEO analyzer) align with the included Python analyzer and SKILL.md usage examples. The skill claims features like SEO scoring, title/tag/description analysis and keyword suggestions which match the analyzer code's visible keyword lists and heuristics. Note: SKILL.md also mentions 'competitor analysis' and 'search volume indicators' which normally imply network/third‑party data; the manifest declares no credentials and the visible code imports only standard libs, so those features are likely simulated from internal heuristics rather than live scraping or third‑party APIs.

Instruction Scope

Runtime instructions only tell the agent/user to run the local Python script (interactive, with JSON input, or demo mode). The SKILL.md suggests an npx install command for a separate package, but the skill package itself contains the analyzer.py and does not declare any install steps or require external keys. No instructions ask the agent to read unrelated files or environment variables. Because the SKILL.md claims competitor/search-volume features, verify whether the script attempts network access (not visible in provided snippet).

Install Mechanism

There is no install spec in the skill manifest; the SKILL.md shows an optional npx command for obtaining the skill from an external repository, but that is documentation, not an enforced installer. The included code file is run locally — lower risk than downloads at runtime. No downloaded archives, no brew/npm install specs embedded in the manifest.

Credentials

The skill declares no required environment variables, no primary credential, and no config paths. That is proportionate for a local analyzer that appears to operate on supplied listing data. SKILL.md explicitly states 'No API key required.'

Persistence & Privilege

The skill does not request always: true and is user-invocable only; it does not declare persistent privileges or modifications to other skills or agent-wide settings.

Assessment

This package appears to be a local Etsy listing analyzer that doesn't ask for credentials. Before running it on real or sensitive data: 1) inspect the rest of scripts/analyzer.py for any network (requests/urllib/httpx/socket), subprocess/os.system calls, or hardcoded remote endpoints; 2) run the script first in a sandbox or isolated environment; 3) if you plan to use the npx install command from SKILL.md, confirm the origin of the nexscope-ai/eCommerce-Skills package and review its contents; 4) if you need live competitor or search-volume data, expect that this tool likely simulates those signals unless you find explicit API calls — in that case you'll need to provide appropriate API keys and review privacy implications.

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.