Honest Etsy SEO powered by
Live Search & Dev Insights
Created by a verified developer holding Official Etsy Developer Access. The system auto-detects REWRITE vs CREATE and runs live Etsy autocomplete + top-10 competitor research under 6 Immutable System Laws, in Caveman Output Mode (saving 70% of tokens per turn). It enforces the April 2026 Etsy title guidance, guaranteed 20-character tag limits, 9-block no-emoji descriptions, and Etsy's October 2026 AI & image compliance gate — plus 5-surface indexing spread, trademark checks, 2026 seller-operations guidance, a platform-fit reality check, and cross-session memory. No API setup required.
Free & Client-Side: Runs directly inside your existing AI tool. No credentials needed.
Paste your listing. Get an optimized version back.
No mode selection, no setup forms. The system auto-detects whether you're rewriting an existing listing or creating a new one — then runs live research and returns a complete, policy-current listing.
Set it up in under 3 mins
Install the Claude/Cowork skill (copy skill/ and state-templates/, or unzip the one-step etsy-seller.skill release), or paste the portable instruction file into ChatGPT, Gemini, or Perplexity.
Paste listing or description
For rewrites: paste your title, tags, and description. For new products: type a short product summary. Auto-detection handles the rest.
Research & compliance gate
Pulls live Etsy autocomplete data, scrapes top-10 competitor listings, assesses competition difficulty, screens trademark risk, and runs the AI & image gate — flagging saturated niches and prohibited AI categories before you build.
Receive your complete listing
Mobile-first title (first 40 chars), 13 verified tags ≤20 chars, 9-block no-emoji description, AI & image disclosure line, product-type image plan, Pinterest pin content, a rewrite diff view, and a pre-publish checklist.
Built for the 2026 Etsy Algorithm & Policy
Combining developer insights, live buyer search signals, mobile-first title formulas, Etsy's April 2026 title guidance, the October 2026 AI & image rules, current 2026 seller-operations guidance, and compound external Pinterest traffic.
Official Etsy Developer Access
Built by an officially approved Etsy Developer holding developer portal access for maximum platform knowledge and algorithm accuracy.
2-Mode Auto-Detect
No mode menus. Paste a title + tags + description and it runs a REWRITE; describe a new product and it runs CREATE — detected automatically from input shape.
Caveman Output Mode
Default bullet-first, high-density output style cutting token consumption by up to 70% while keeping full SERP tracking saved to ~/etsy-listings/ (unlock detail with "expand").
6 Immutable System Laws
Non-bypassable execution laws: Operational Integrity, Zero-Hallucination evidence tracing, 20-Char Tag Supremacy, Caveman Protocol, Strict Listing Format, and the AI & Image Compliance Gate.
2026 Mobile-First Titles
Places [Primary Keyword] [Style Descriptor] | [Format] in the first 40 characters, enforces 6–12 words, and applies Etsy's April 2026 title guidance: state the item once, top-3 descriptors, no gifting-phrase repetition.
Strict 20-Char Tag Limit
Etsy silently drops tags over 20 characters. Enforces all 13 tags at ≤20 chars with phrase-overlap rules (max 2 tags per phrase cluster) and zero symbols.
9-Block No-Emoji Descriptions
Canonical 9-block description structure, strictly emoji-free for clean formatting and screen-reader accessibility. Block 8 handles AI & image disclosure, with conditional templates for AI-created items and AI-edited photos, plus hero alt text.
AI & Image Compliance Gate
Law 6 blocks AI prompt bundles, AI-generated patterns, recipes, plans and manuals, bot-generated listings, and undisclosed AI creations before output. Every listing returns a PASS, ACTION REQUIRED, or BLOCKED result with the right product-type image plan.
2026 Seller Operations Guidance
Beyond SEO: payment and payout timing, Purchase Protection, US tariffs and DDP, EU packaging and EPR obligations, policy-violation appeals, case windows, and review-rating rules — with dated source links.
Live Research & Platform Fit Check
Live Etsy autocomplete, top-10 competitor SERP scraping, and competition difficulty assessment — plus a reality check before building in a saturated niche (100K+ results).
Honest Scope, Diff View & Memory
Flags when the real problem isn't SEO and points to what is. Rewrites return a diff of what changed and why, every output ends with a pre-publish checklist, and listings are remembered across sessions.
Etsy's new AI and image rules, built into every listing
On 22 October 2026 Etsy published new rules for AI use and listing images. They apply to every seller, not only AI-heavy shops. The system runs Law 6 — a hard compliance gate — before any listing is output, so policy problems are caught before you publish.
Read the full plain-English breakdown of Etsy's AI & image rules →
| Rule | What it means for your shop |
|---|---|
| Unedited photo required | Most listings need at least one real, unedited photo of the actual item against a real background. Don't AI-edit or retouch that photo. |
| Images must be truthful | No hiding flaws or damage, and no changing colour, texture, scale, or materials. Other photos may be edited for lighting or background if the item still looks like what ships. |
| No bot-generated listings | Every item needs your own prompts, curation, and individual human review. Mass-automated listing generation is prohibited. |
| No AI-generated instructions | Patterns, recipes, building plans, manuals, and instructional guides must be your own work — not AI-generated. |
| No AI prompt bundles | You can't sell prompts separately from the finished artwork. |
| Disclose AI creations | If AI created the item, say so in the listing description. Unknown AI status never becomes a false "no AI" claim. |
Image requirements by product type
The gate checks the required image evidence for the product type — not a generic "lifestyle mockup" for every listing.
| Product type | Required image evidence | AI / edited imagery |
|---|---|---|
| Physical handmade | At least one real, unedited photo of the actual item on a real background. First image must be original photo or video of the final product. | Extra slots may be AI-edited if accurate. |
| Personalised / made-to-order | Photos of real, finished items. First image must show a finished customised item — never a blank product or "Your Text Here" placeholder. | Extra slots may be AI-edited if accurate. |
| Print-on-demand (POD) | Licensed stock mockups are allowed only when the mockup owner authorises their use. | Must preserve real print placement, scale, colour, and base product. |
| Digital download | Visual preview or excerpt of the actual files — design grid, page preview, or layer view. | Representative or AI imagery allowed in lifestyle slots if it doesn't mislead about the download. |
| Patterns, recipes, seeds | At least one real, unedited photo of a finished project, baked result, or grown plant. | AI images cannot be the only finished-result images. |
| Functional instructions | Same finished-result photo rule, and the instructions must be the seller's own work. | Instructions themselves may not be AI-generated. |
Accurate adjustments
Lighting, exposure, and colour balance to match real life; cropping, resizing, and straightening; cleaning up or replacing the background while the product stays unchanged; text or graphics that don't imply extra included items; licensed POD stock mockups.
Misleading changes
Changing the product's actual colour, texture, or condition; removing or hiding defects, cracks, or damage; using AI to change the core design of a physical item; showing a simulated finished result as if it were real; mockups that change print scale, placement, or quality.
Every listing returns a PASS, ACTION REQUIRED, or BLOCKED result from the AI & image gate. It blocks prompt bundles, AI-authored instructions, bot-generated listings, and undisclosed AI creations; adds the correct disclosure line to Block 8; and puts the required photo or file-preview step into the pre-publish checklist. It writes image and video briefs only — it does not generate images, videos, or mockups.
California SB 1050 (effective 1 January 2027): images or videos featuring AI-generated synthetic performers may require a clear disclosure for California buyers. The gate flags this in image, video, and Pinterest briefs.
Sources: Etsy AI updates · Listing Image Requirements · Creativity Standards · compliance playbook
Beyond listings: 2026 seller operations
The same policy engine tracks Etsy's 2026 seller-operations changes, so the advice you get is current beyond titles and tags.
Payment account & payouts
Current, Pending, and Total balances; Ready for Deposit; reserves folded into Pending; negative Current balances; and sale-versus-non-sale fee timing.
Purchase Protection
Up to $250 USD per eligible order including postage and tax — even above a $250 order total — with eligibility standards and a 48-hour Help with Order reply.
US tariffs & DDP
US de minimis ended 29 August 2025. DDP is required for US orders to qualify for Purchase Protection, with duties priced up front.
EU packaging & EPR
Producer registration, EPR numbers in Shop Manager, an EU Authorised Representative where required, packaging reporting, and compliance-scheme fees.
Violations & appeals
Shop Manager's Policy violations page shows removal history, the policy cited, appeal routes, and timing. Appeal instead of relisting.
Cases & reviews
Buyers can open a case for 30 days after eligibility begins; late delivery is 7+ days after the estimated delivery date. Review rating, text, and count share the lifetime timeframe.
Deep dives: US tariffs & DDP for non-US sellers · EU packaging & EPR checklist
Policy guidance verified against Etsy's published seller policies (baseline 23 October 2026, with a monthly maintainer freshness check). It is operational context, not legal, tax, or accounting advice. See policies.md and operations.md.
Free path, or full automation
Most paid Etsy SEO tools cost $9–$50 per month. This system is designed to run entirely on free AI tiers — the optional paid path only removes copy-paste friction at scale.
Claude.ai · ChatGPT · Gemini
Paste the portable instruction doc as your first message, then send your listing. Keeps all SEO rules, live research (with web browsing), the trademark scan, the AI & image compliance gate, and honest scope diagnosis.
Claude Code / Cowork
For 30+ listings or multiple shops. Install the skill folder and state is written automatically to ~/etsy-listings/ — no manual snapshot, and your listing history is preserved across updates.
Typical Etsy SEO tools vs this system
| Feature | Typical tools | This system |
|---|---|---|
| Keyword research | Static keyword lists | Live Etsy autocomplete + top-10 SERP scraping |
| Tag character limits | Not enforced | All 13 tags verified at ≤20 characters |
| Etsy algorithm | Advice from 2018–2022 | 2026 NLP-aware + April 2026 title guidance |
| AI & image policy | Generic advice, or none | Hard gate + product-type image plan (Oct 2026) |
| Seller operations | Not covered | Payouts, Purchase Protection, DDP, EU EPR, appeals |
| Diagnostics | Prescriptive tag advice | Identifies when the problem is not SEO |
| State across sessions | None, or paid SaaS | Local markdown files at ~/etsy-listings/ |
| Cost | $9–$50 / month | $0 — runs inside your AI tool |
| Setup | Account, login, onboarding | Drop a folder into ~/.claude/skills/ |
Deploy Etsy Seller System in 3 minutes
Use Option A for Claude Code / Cowork automation, or Option B to copy the single-file system instructions for free ChatGPT, Gemini, or Perplexity.
Option A — Claude Code / Cowork
Clone the repo and copy skill/ and state-templates/ into your skills directory. State is then stored at ~/etsy-listings/ automatically.
git clone https://github.com/moiz-za/etsy-seller-seo-system.git cd etsy-seller-seo-system mkdir -p ~/.claude/skills/etsy-seller cp -r skill/. ~/.claude/skills/etsy-seller/ cp -r state-templates ~/.claude/skills/etsy-seller/
Prefer one step? Download etsy-seller.skill from the latest release and unzip it into ~/.claude/skills/etsy-seller/.
Option B — Free AI Chat Assistants
Upload or paste portable/Etsy_Listing_System_Instructions.md into ChatGPT (Custom GPT), Gemini (Gem), or Perplexity (Space), and enable web browsing so live keyword research works.
Free tiers supported. Perplexity falls back to search-based discovery, so expect partial accuracy there.
Upgrading? Re-copy skill/ (and state-templates/ if your install predates the AI & image gate), or reinstall etsy-seller.skill from the latest release. No state migration is needed — your ~/etsy-listings/ data stays valid and the schema remains 2.0.
Frequently Asked Questions
Is there a free path?
Yes. Paste portable/Etsy_Listing_System_Instructions.md into any free-tier chat — Claude.ai, ChatGPT, or Gemini. All SEO rules, live research (with web browsing), trademark scanning, the AI & image compliance gate, and scope diagnosis are included. The free path gives up automatic cross-session memory, so you re-paste a short state snapshot between chats.
Do I need API keys or a paid SaaS account?
No. The system runs inside your existing AI tool — no API keys, subscriptions, or hosted service. The optional paid path (Claude Code / Cowork) only adds automatic local state for sellers managing many listings.
How do I rewrite an existing listing?
Paste the current title, all 13 tags, and the full description. The system auto-detects a REWRITE, runs the research, and returns an optimized version with a diff view showing exactly what changed and why.
How do I create a new listing?
Describe the product briefly, for example: "Funny cat mom SVG bundle, 20 designs, SVG/PNG/EPS, commercial use included." The system detects CREATE and builds the full listing from scratch.
Does it generate AI listings for me?
No. It is a human-in-the-loop assistant: you bring the product, photos, and creative decisions; it optimizes the listing and checks it against Etsy policy. Batch mode processes your rows for review — it is not an auto-publish pipeline, because Etsy prohibits bot-generated listings.
What if I sell patterns, recipes, or instructions?
The AI & image gate checks that the instructions are your own work and that your photos include a real finished result. AI-generated patterns, recipes, plans, manuals, and instructional guides are blocked, and AI images cannot be the only evidence of the finished result.
What are Etsy's 22 October 2026 AI & image rules?
Most listings need at least one real, unedited photo of the actual item; images must accurately show colour, condition, scale, and materials; bot-generated listings are prohibited; AI-generated patterns, recipes, plans, manuals, and instructional guides are prohibited; AI prompt bundles cannot be sold on their own; and AI-created items must be disclosed in the description. Product-type exceptions cover digital downloads, print-on-demand, personalised items, and patterns, recipes, or seeds.
Does it cover payouts, tariffs, and EPR — or only SEO?
It is an Etsy SEO and listing tool first. It also carries current 2026 seller-operations guidance — payout timing, Purchase Protection, US tariffs and DDP, EU packaging and EPR, policy-violation appeals, case windows, and review-rating rules — with source links. That guidance is operational context, not legal, tax, or accounting advice.
What if my problem isn't SEO?
It says so. The system identifies when a listing's real problem is images, pricing, reviews, or a saturated niche, and points to concrete next steps with real competitor data instead of rewriting tags that won't help.
Is this affiliated with Etsy?
No. This project is not affiliated with, endorsed by, or sponsored by Etsy, Inc. 'Etsy' is a trademark of Etsy, Inc.; the system uses the Etsy API and public policy guidance only.
Want these checks as point-and-click tools?
SellWren is the Etsy toolkit from the same team, built on the same rulebooks — four free web tools (Tag Verifier, Title Builder, IP Scanner, Description Builder), plus SellWren for Desktop, a downloadable app with a listing optimizer, keyword research, two-tier trademark screening, and honest profit math. Use the skill for deep research and listing creation, and SellWren for day-to-day work.