Etsy Seller SEO System

A free, evidence-driven Etsy SEO tool for AI assistants. It optimizes Etsy listings — titles, all 13 tags, attributes, and descriptions — using live Etsy autocomplete research, top-10 competitor SERP analysis, and current 2026 Etsy policy checks. Runs inside Claude, ChatGPT, Perplexity, or Gemini on free tiers, with no shop registration, setup forms, or API keys.

Quick start: paste portable/Etsy_Listing_System_Instructions.md into any AI chat as your first message, then send your listing. Installing the Claude skill takes three commands — see Installation.

---

Table of Contents

• Features
• Scope and Limits
• Installation
• How It Works
• Free vs Paid
• Comparison with Other Etsy SEO Tools
• Who It's For
• Repository Structure
• Related Projects
• FAQ
• Community
• Changelog
• Author and Maintainer
• License

---

Features

Everything below is built for Etsy SEO in 2026 — Etsy titles, Etsy tags, attributes, and descriptions.

Caveman Output Mode

Crisp, bullet-first output that reduces token usage by up to 70%. Full raw SERP breakdowns and keyword tracking stay in state and unlock on demand ("expand", "full report").

Five Immutable System Laws

Non-bypassable execution discipline (skill/references/playbooks/system-laws.md):

1. Zero state skips — sequential workflows with difficulty assessment and output phases.
2. Zero hallucination — live search data, or explicit [Data Source: Reasoning Engine Fallback] tagging.
3. Strict listing rules — exactly 13 tags, each 20 characters or fewer, with at most 2 tags per phrase cluster.
4. Caveman output protocol — concise by default, details on request.
5. Strict format mandate — mandatory title formula, title word count, no-emoji rule, and Etsy 2026 AI disclosure.

Live Research Engine

• Real Etsy autocomplete — what buyers are typing right now.
• Top 10 competitor SERP scraping — what is winning for a given keyword.
• Competition difficulty assessment — whether a keyword is realistic or saturated.

Optimized Etsy Titles, Tags, and Descriptions

• Mandatory title formula [Primary Keyword] [Style Descriptor] | [Format] within the first 40 characters, with a mobile preview line.
• A 6–12 word title limit (maximum 14), plus a prohibited subjective-words stoplist (cute, beautiful, and similar).
• All 13 tags verified at 20 characters or fewer, with phrase-overlap rules enforced.
• No emojis in description text or section headers — clean formatting and screen-reader accessibility.
• NLP-aware natural-language writing, with no keyword chains, which Etsy's 2026 algorithm penalizes.

Trademark and Policy Guard

• Flags trademarked words before a listing is taken down.
• Checks Etsy's current 2026 policies each session via live web search (Phase 2), with a maintainer dual-repo sync engine (skill/scripts/sync_etsy_policy.py) that keeps the rulebooks aligned.
• Platform fit check on saturated niches (over 100K results) before a listing is built.

Honest Scope Diagnosis