Web System · Official Etsy Developer Access · 2026 AI, Image & Operations Policy
Latest release version MIT license GitHub stars Etsy policy baseline 2026

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.

🔍 View on GitHub ↗ 6 System Laws ↓

Free & Client-Side: Runs directly inside your existing AI tool. No credentials needed.

Approved
Official Etsy Developer Access
2-Mode
Auto-Detected Workflow
70%
Token Output Savings
≤20
Tag Character Limit
🏷️ SEO Engine LIVE
✓2-mode auto-detect (rewrite / create)
✓April 2026 title guidance
✓13 verified tags ≤20 chars
✓9-block no-emoji descriptions
✓AI & image compliance gate
✓Trademark & policy screening
6 Laws · Caveman Mode · Live Data

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.

STEP 01
⚙️

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.

STEP 02
📋

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.

STEP 03
🔎

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.

STEP 04
🚀

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.

ACCESS
🔑

Official Etsy Developer Access

Built by an officially approved Etsy Developer holding developer portal access for maximum platform knowledge and algorithm accuracy.

WORKFLOW
🔀

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.

OUTPUT MODE
🦣

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").

GOVERNANCE
📜

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.

TITLES
📱

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.

TAGS
📏

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.

FORMAT
🚫

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.

COMPLIANCE
🛡️

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.

OPERATIONS
📦

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.

RESEARCH
🔎

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).

HONESTY
🧭

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.
✅ ALLOWED EDITS

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.

⛔ PROHIBITED EDITS

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.

HOW THE SYSTEM ENFORCES IT

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.

SEP 2026

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.

MAY 2026

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.

JUL 2026

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.

AUG 2026

EU packaging & EPR

Producer registration, EPR numbers in Shop Manager, an EU Authorised Representative where required, packaging reporting, and compliance-scheme fees.

JUL 2026

Violations & appeals

Shop Manager's Policy violations page shows removal history, the policy cited, appeal routes, and timing. Appeal instead of relisting.

APR 2026

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.

FREE PATH
🆓

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.

$0 Forever Web Browsing Research ~30s State Re-paste
PAID PATH
🤖

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.

Automatic State Cross-Session Memory Multi-Shop Threads

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.

RECOMMENDED
🤖

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/.

PORTABLE
📄

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.