功能描述

Etsy SEO tag extractor and keyword optimizer agent. Find Etsy listing tags, extract all 13 tags from any listing, research high-performing keywords, optimize...

使用说明 (SKILL.md)

Etsy SEO Tag Optimizer

Name: Etsy Seo Tag Optimizer
Author: mguozhen

Extract, analyze, and optimize Etsy listing tags for maximum search visibility. Find what keywords successful competitors use, build a winning tag strategy, and rank higher in Etsy search results.

Commands

tag extract \x3Clisting>             # extract all tags from a pasted Etsy listing
tag analyze \x3Ctags>                # analyze tag strength and keyword quality
tag suggest \x3Cproduct>             # suggest 13 optimized tags for a product
tag competitor \x3Clisting>          # extract and analyze competitor tags
tag gaps \x3Cyour-tags> \x3Ccomp-tags>  # find missing tag opportunities
tag rank \x3Ckeyword>                # estimate keyword competition on Etsy
tag seasonal \x3Cproduct>            # add seasonal tag opportunities
tag refresh \x3Clisting>             # refresh outdated tags with fresh keywords
tag copy \x3Ctags>                   # format tags for one-click copy
tag report \x3Cproduct>              # full Etsy SEO analysis report

What Data to Provide

Etsy listing text — paste the full listing title, description, tags
Product description — what you're selling in plain terms
Target buyer — who buys this (occasion, demographic, use case)
Competitor listings — paste competing listing data
Current tags — your existing 13 tags for optimization

Etsy SEO Framework

How Etsy Search Works

Etsy's algorithm ranks listings based on:

Query match — how well listing title + tags match the search
Listing quality score — views, favorites, purchases, CTR
Recency — recently added/renewed listings get temporary boost
Customer experience score — seller reviews, dispute rate
Shipping price — free shipping gets significant boost
Buyer personalization — Etsy personalizes results per buyer

Critical insight: Tags must exactly match what buyers search. Etsy uses EXACT match, not semantic matching like Google.

Tag Structure Rules

Etsy tag requirements:

Maximum 13 tags per listing
Each tag: up to 20 characters
Multi-word tags allowed (use all available space)
Avoid single words — phrases convert better
No punctuation except hyphens
No trademark violations

Tag types by function:

Primary tags (5):     Core product type phrases
Attribute tags (4):   Color, material, size, style
Use case tags (2):    Occasion, recipient, purpose
Long-tail tags (2):   Specific buyer-intent phrases

Tag Generation Framework

Step 1: Identify core product terms

Product: Handmade ceramic coffee mug
Core terms: coffee mug, ceramic mug, handmade mug, pottery mug, stoneware mug

Step 2: Add attribute modifiers

Color: blue mug, navy mug, speckled mug
Size: large coffee mug, 16oz mug, big mug
Style: rustic mug, minimalist mug, boho mug
Material: clay mug, pottery mug, stoneware mug

Step 3: Identify use cases and occasions

Occasions: birthday gift mug, Christmas gift, mother day gift
Recipients: gift for him, gift for her, coffee lover gift, teacher gift
Use cases: office mug, unique mug, personalized mug

Step 4: Add long-tail buyer intent phrases

Specific: handmade blue ceramic mug, rustic coffee cup pottery
Problem-solving: microwave safe mug, dishwasher safe pottery
Sentiment: cozy mug, unique coffee mug, artisan mug

Step 5: Seasonal adjustments

Q4 (Oct-Dec): Christmas gift, holiday gift, stocking stuffer
Q1 (Jan-Mar): Valentine gift, self care gift, new home gift
Q2 (Apr-Jun): Mother's Day gift, graduation gift, spring
Q3 (Jul-Sep): Birthday gift, back to school, summer

Tag Optimization by Product Category

Jewelry:

Good tags: sterling silver necklace, layered necklace gift, dainty chain necklace
Poor tags: necklace, jewelry, silver (too broad, low intent)

Home Decor:

Good tags: boho wall art print, nursery decor girl, minimalist bedroom art
Poor tags: art, print, home (too generic)

Clothing:

Good tags: floral summer dress women, cottagecore midi dress, romantic dress gift
Poor tags: dress, women clothing, summer (too generic)

Digital Downloads:

Good tags: printable wall art instant download, budget planner digital, wedding invitation template
Poor tags: printable, download, digital (too broad)

Competitor Tag Analysis

From a competitor's listing, extract all tags and classify:

Tag                    Type          Competition Level
coffee mug gift        Use case      High
handmade ceramic mug   Primary       Medium
rustic pottery mug     Attribute+    Low
birthday mug           Occasion      High
unique coffee cup      Modifier      Low
minimalist mug         Style         Medium
...

Find the low-competition tags competitors use that you don't → add to your listing.

Tag Gap Analysis

Your tags: [A, B, C, D, E, F, G, H, I, J, K, L, M]
Comp tags: [B, C, D, E, F, N, O, P, Q, R, S, T, U]

Gap (in theirs, not yours): N, O, P, Q, R, S, T, U
Your unique tags:            A, G, H, I, J, K, L, M

Recommendation:
- Drop lowest-performing unique tags
- Add gap tags with good potential

Etsy Title Optimization

Title works with tags for search matching. Rules:

First 40 characters most important (show in search results)
Include top 2-3 tag phrases naturally in title
Keep it readable — not keyword-stuffed
Format: [Primary Keyword] [Key Feature/Attribute] [Use Case/Gift]

Bad title: "Mug Handmade Ceramic Blue Coffee Gift Pottery Cup"
Good title: "Handmade Ceramic Coffee Mug | Blue Pottery Cup | Birthday Gift for Coffee Lover"

Keyword Competition Estimation

Estimate competition level:

Low competition (good target):    \x3C5,000 Etsy results, meaningful buyer intent
Medium competition:               5,000-50,000 results
High competition (hard to win):   >50,000 results
Very high (avoid as main tag):    >200,000 results

Strategy: Mix 3-4 low competition tags with 5-6 medium, 2-3 high

Tag Refresh Strategy

Refresh tags when:

Listing has been active >90 days with declining traffic
Season changes (swap seasonal tags)
New trends emerge in your category
After analyzing competitor tags of new top sellers

Refresh cadence:

Seasonal tags: Every 3 months
Trend tags: Monthly (monitor Etsy Trend Reports)
Core product tags: Only if not performing after 90 days

Workspace

Creates ~/etsy-seo/ containing:

tags/ — optimized tag sets per product
competitors/ — competitor tag extractions
seasonal/ — seasonal tag calendars
research/ — keyword competition data
reports/ — full SEO audit reports

Output Format

Every tag optimization outputs:

Optimized 13 Tags — ready-to-copy tag set with type classification
One-Click Copy Format — tags formatted for easy pasting into Etsy
Tag Analysis — competition estimate and rationale for each tag
Title Recommendation — optimized title incorporating top tags
Competitor Gap Analysis — tags from top competitors you're missing
Seasonal Tags — upcoming seasonal additions with optimal timing
Monthly Refresh Calendar — when to swap which tags

安全使用建议

This is an instruction-only skill that asks you to paste listing text and competitor data to generate tag suggestions — it does not request credentials or install code. Before using: (1) avoid pasting any sensitive or personal data (e.g., API keys, full email addresses, order/customer info); (2) be aware the metadata allows Bash even though no shell steps are included — if the agent later uses this skill autonomously, review what commands it proposes before permitting execution; (3) verify the referenced GitHub project yourself if you want implementation code or a maintainer contact; and (4) if you need the agent to fetch live Etsy data, prefer giving it explicit, limited access methods (e.g., provide exported listing text) rather than enabling network/scraping or sharing platform credentials.

功能分析

Type: OpenClaw Skill Name: etsy-seo-tag-optimizer Version: 1.0.0 The skill bundle is a legitimate SEO optimization tool for Etsy sellers. It provides structured instructions and a framework for keyword research and tag generation without any evidence of malicious code, data exfiltration, or prompt injection attacks. The use of the Bash tool is consistent with the stated purpose of managing local research files in the '~/etsy-seo/' directory (SKILL.md).

能力评估

✓ Purpose & Capability

Name/description (Etsy tag extractor and optimizer) match the SKILL.md instructions: extracting tags from pasted listing text, analyzing keywords, and suggesting tags. It doesn't request unrelated credentials or tools.

ℹ Instruction Scope

Runtime instructions ask users to paste listing text, product/competitor data, and current tags — all reasonable for the stated goal. The SKILL.md does not instruct the agent to read system files, access environment variables, or call external endpoints. One minor oddity: metadata lists 'allowed-tools: Bash' though no shell commands are specified; this expands what the agent could do if combined with other instructions, so be cautious about allowing autonomous invocation.

✓ Install Mechanism

No install spec and no code files — instruction-only skills carry minimal installation risk because nothing is written to disk or downloaded during install.

✓ Credentials

The skill declares no required environment variables, credentials, or config paths, which is proportionate to a text-based SEO assistant.

✓ Persistence & Privilege

always is false and there are no indications the skill requests persistent elevated privileges or modifies other skills or agent-wide settings.

版本历史

v1.0.0

Etsy SEO Tag Optimizer 1.0.0 initial release: - Extracts up to 13 tags from any Etsy listing. - Analyzes tag strength, competition level, and keyword quality. - Suggests optimized tag sets tailored to your product and category. - Provides competitor tag extraction and gap analysis. - Delivers full Etsy SEO reports, seasonal tagging strategy, and title optimization advice. - Organizes outputs in a structured local workspace for easy reference and action.

元数据

Slug etsy-seo-tag-optimizer

版本 1.0.0

许可证 MIT-0

累计安装 1

当前安装数 1

历史版本数 1

常见问题