# Etsy SEO Skill > Boost your Etsy SEO with a free analyzer that scores listings 0-100, optimizes titles and tags, and delivers actionable plans. No API key—start free in seconds. - Canonical: https://nanoskill.ai/skills/etsy-seo-skill-c221 - Markdown: https://nanoskill.ai/skills/etsy-seo-skill-c221.md - Author: nexscope-ai - Published: 2026-07-13T04:09:11.098Z - Updated: 2026-07-16T07:05:06.631Z - Language: en - Source type: github - Popularity signal: 311 ## Sources - https://github.com/nexscope-ai/eCommerce-Skills/blob/main/etsy-seo ## Install ```shell npx skills add https://github.com/nexscope-ai/eCommerce-Skills/blob/main/etsy-seo ``` ## About Etsy SEO is critical for standing out in a crowded marketplace, yet many sellers struggle to optimize titles, tags, and descriptions effectively. This free, open-source analyzer gives you an instant, data-driven audit—a 0-100 SEO score, long-tail keyword suggestions, and a prioritized action plan—so you can quickly improve search visibility without needing SEO expertise. Unlike generic checklists, the tool applies weighted scoring across five dimensions (title, tags, description, attributes, images) based on real Etsy best practices. It highlights specific issues like missing core keywords in your title, underused tags, or a weak first 160 characters of your description, then delivers concrete rewrite suggestions and a ranked roadmap of quick wins. Designed for busy Etsy sellers, the analyzer works interactively, via JSON input, or with a built-in demo mode to preview the output. It’s part of the Nexscope AI suite of e-commerce tools and requires no API keys—just download and run to start optimizing listings in seconds. ## Key features - **Comprehensive 0-100 SEO Score**: Get an instant Etsy SEO rating covering title, tags, description, attributes, and images, with weighted scoring for each dimension. - **Title Optimization Engine**: Analyze keyword placement, length, and structure; receive reformatted titles that follow Etsy's best practices and boost visibility. - **13-Tag Analysis & Suggestions**: Audit your tag usage, identify fill gaps with long-tail keyword suggestions, and ensure you use all 13 tags for maximum reach. - **First 160-Char Description Audit**: Evaluate Etsy's critical first-impression text for keyword density and conversion potential, then get actionable rewrite tips. - **Prioritized Action Plan**: Receive a ranked to-do list with impact scores so you quickly fix high-ROI issues like title rewrites (+15 score) and tag adds (+10). ## Use cases - **Audit existing listings**: Run a full Etsy SEO check to receive a 0-100 score and a step-by-step action plan to fix weak points and climb search results. - **Research keywords for new products**: Use category-based suggestions to uncover long-tail Etsy keywords with higher conversion potential before publishing a listing. - **Monitor long-term SEO health**: Re-scan listings over time to track improvement scores and validate that your title, tag, and description changes are boosting visibility. - **Analyze competitor listings**: Extract keyword strategies from top-performing Etsy competitors and apply them to your own tags and titles for a competitive edge. ## Result preview Explore a real Etsy SEO optimization report powered by this Skill. ![Cover page of an Etsy SEO optimization report for a handcrafted lime mocktail mixer, presented in a split editorial layout. The left two-thirds use a deep teal background with a thin vertical yellow line near the left edge. At the top, a coral pill-shaped label reads 'ETSY SEARCH GROWTH PLAYBOOK.' The large serif headline reads 'SQUEEZE MORE' in white and 'FROM SEARCH.' in bright lime green. Below, the subtitle states, 'A complete Etsy SEO optimization report for a handcrafted lime mocktail mixer.' Near the lower left, bold text reads 'VISIBILITY / RELEVANCE / CLICKS / CONVERSION.' A section titled 'VISUAL-ONLY BASELINE' notes, 'Strong creative; listing metadata not supplied.' Near the lower-right of the teal panel, a circular light-blue score badge displays '36 / 100 PROVISIONAL.' The right third features a bright product photograph with the text 'NEW FLAVOR ALERT' above a pale yellow lime mocktail in a tall clear glass. The drink contains ice, lime slices, green herbs, and a dried citrus garnish, with a large fresh lime wheel and small yellow edible flowers at the rim. The background is light blue with repeated circular fruit-print patterns and a soft yellow glow along the left edge of the photograph. Premium editorial composition with bold serif typography, fresh citrus colors, and a polished beverage campaign aesthetic.](https://file.nanoskill.ai/etsy-seo-outcome1.png) ![Slide from an Etsy SEO optimization report, page 02/06, titled 'Listing Audit & Key Findings' under the section label '01 / DIAGNOSTIC.' Subtitle: 'The current score reflects one visible image and no supplied listing metadata. Missing fields are treated as optimization gaps, not product defects.' The upper section contains six scorecards with horizontal progress bars: 'TITLE QUALITY' scored 5/20 with a short coral bar; '13 TAGS' scored 0/20 with an almost empty coral bar; 'DESCRIPTION' scored 2/15 with a short yellow bar; 'ATTRIBUTES' scored 2/15 with a short yellow bar; 'IMAGE READINESS' scored 13/15 with a long green bar; and 'INTENT ALIGNMENT' scored 14/15 with a nearly full blue bar. Below, the section 'What is holding the listing back' presents four numbered findings. 01 'NO SEARCHABLE FOUNDATION' states, 'No current title, tags or category data were provided.' 02 'PRODUCT TYPE AMBIGUITY' states, 'The image could represent a mix, syrup, infusion kit or finished beverage.' 03 'PROOF GAP' states, 'Ingredients, net weight, shelf life, allergen and preparation details are unknown.' 04 'IMAGE SET INCOMPLETE' states, 'The hero is click-worthy, but scale, packaging, use and ingredient frames are missing.' Footer note: 'Score is provisional until the live Etsy listing, product format and verified food information are supplied.' Clean editorial layout with an off-white background, dark teal serif heading, light blue top border, rounded white scorecards, color-coded progress bars and numbered finding markers, and page number '02 / 06' in the bottom-right corner.](https://file.nanoskill.ai/etsy-seo-outcome2.png) ![Slide from an Etsy SEO optimization report, page 04/06, titled 'Optimized Tags & Search Intent' under the section label '03 / 13-TAG SYSTEM.' Subtitle: 'Each tag is a multi-word phrase of 20 characters or fewer. The set diversifies product, use case, audience and gifting intent.' The main area displays 13 rounded keyword cards arranged in three columns. Tags include: 'lime mocktail mixer' — 19/20 characters, labeled PRODUCT; 'citrus drink mix' — 16/20 characters, PRODUCT; 'cocktail mixer' — 14/20 characters, FORMAT; 'summer mocktail' — 15/20 characters, OCCASION; 'botanical beverage' — 18/20 characters, STYLE; 'limeade mix' — 11/20 characters, FLAVOR; 'party drink mixer' — 17/20 characters, USE CASE; 'hostess gift' — 12/20 characters, GIFT; 'bar cart gift' — 13/20 characters, GIFT; 'non alcoholic mix' — 17/20 characters, AUDIENCE; 'citrus cocktail kit' — 19/20 characters, USE CASE; 'brunch drink mix' — 16/20 characters, OCCASION; and 'gourmet drink gift' — 18/20 characters, GIFT. A dark teal callout box titled 'TAG GOVERNANCE' advises: 'Review Etsy Shop Stats after 30-45 days; replace low-impression phrases one cluster at a time.' Footer note: 'Etsy guidance: use all 13 tags, favor natural multi-word phrases and avoid unnecessary repetition.' Clean editorial layout with an off-white background, dark teal serif heading, light blue top border, pastel blue, green and yellow tag cards, color-coded intent labels, and page number '04 / 06' in the bottom-right corner.](https://file.nanoskill.ai/etsy-seo-outcome3.png) ![Slide from an Etsy SEO optimization report, page 06/06, titled 'Final Listing & Priority Action Plan' under the section label '05 / ACTIVATION.' The main left panel features a dark teal box labeled 'FINAL ETSY TITLE' with the optimized title: 'Handcrafted Lime Mocktail Mixer, Citrus Botanical Drink Mix, Summer Cocktail Base, Hostess Gift.' Below, a section titled 'FIRST 160 CHARACTERS' contains the opening description: 'Brighten mocktail hour with a handcrafted lime citrus drink mixer made for refreshing alcohol-free serves, summer hosting and thoughtful bar-cart gifting.' The 'Priority action plan' section lists four color-coded steps: 'NOW' — confirm product format, ingredients, net quantity and shelf life; 'NEXT' — publish the optimized title, all 13 tags and complete attributes; 'THEN' — build the 9-image stack and rewrite the full description; and 'MEASURE' — review impressions, CTR, favorites and conversion after 30-45 days. On the right, a pale blue scorecard titled 'EXPECTED SCORE AFTER FIXES' displays '82-88 / 100 ESTIMATE' in large green type. Beneath it, a white 'FINAL QUALITY CHECK' card lists five checklist items with green dots: clear product noun first, 13 distinct phrase tags, no unsupported claims, complete food attributes and thumbnail-readable hero. A pale blue 'SOURCE NOTES' box cites Etsy Help guidance on titles up to 140 characters, Etsy Seller Handbook guidance to use all 13 tags and tags up to 20 characters, and notes that Etsy market examples for lime garnish, cocktail mixer and mocktail intent were reviewed in July 2026. Footer warning: 'If this is not a shelf-stable physical drink mix, revise the category, title, tags and compliance plan before publishing.' Clean editorial layout with an off-white background, light blue top border, dark teal serif headline, rounded cards, coral, yellow, blue and green action labels, and page number '06 / 06' in the bottom-right corner.](https://file.nanoskill.ai/etsy-seo-outcome4.png) ## Result walkthrough ### Install Add the Etsy SEO Skill to your AI agent. ![Screenshot of an AI chat interface showing the installation of the Etsy SEO skill from Nexscope's eCommerce-Skills GitHub repository. At the top, a dark blue user message contains the command 'npx skills add https://github.com/nexscope-ai/eCommerce-Skills/blob/main/etsy-seo.' Below, a large light-gray assistant response explains the installation process: reading the current persona file, checking the relevant skill documentation, attempting to install the skill from a direct GitHub URL, recognizing that the provided link is a GitHub blob page rather than a raw markdown file, retrying with the raw URL, encountering a timeout, and then using the npx installation method. The final confirmation states that the 'etsy-seo' skill was installed successfully from Nexscope's eCommerce-Skills repository. It also shows the installation path '~/.hermes/skills/etsy-seo/' symlinked from '~/.agents/skills/etsy-seo/', confirms that the skill is enabled, and provides two ways to load it: '/skill etsy-seo' or 'hermes -s etsy-seo.' The interface has a white background, rounded message panels, a small Hermes-style icon beside the assistant response, a token counter reading '2,148,310 tokens' near the top, and a message input box at the bottom.](https://file.nanoskill.ai/etsy-seo-install.png) ### Describe Task Provide your product title, tags, description, attributes, images, target audience, and product details to generate a complete SEO audit. ![Screenshot of an AI chat interface showing a detailed prompt for creating a complete Etsy listing optimization report. The large dark blue user message instructs the AI to act as an award-winning Etsy SEO Strategist and improve search visibility, keyword relevance, click-through rate, and conversion potential. The requirements include analyzing the product title, 13 tags, description, category attributes, images, target audience, product style, materials, use cases, and gifting occasions; evaluating title quality, keyword coverage, tag relevance, description structure, attribute completeness, and image readiness; assigning an SEO score; identifying weaknesses; and generating an optimized Etsy title, 13 high-relevance long-tail tags, an improved description opening, and recommended attributes. The prompt also requests a critique and refinement process, followed by a polished six-page PDF covering the Etsy SEO score, listing audit, keyword strategy, optimized tags, description and image recommendations, and a final priority action plan. Below, a light-gray assistant response says it will load the Etsy SEO skill but explains that the actual listing details were not provided. It asks the user to share the current product title, all 13 tags, the full description, and category or attribute information before a real audit report can be created. Clean white interface with rounded message panels, dark blue prompt block, black sans-serif text, and a professional AI workflow presentation.](https://file.nanoskill.ai/etsy-seo-task.png) ### Generate Outcomes Get actionable recommendations to optimize keywords, title structure, tags, description, attributes, and listing performance. ![Cover page of an Etsy SEO optimization report for a handcrafted lime mocktail mixer. The layout uses a deep teal background with a thin vertical yellow line near the left edge. At the top, a coral pill-shaped label reads 'ETSY SEARCH GROWTH PLAYBOOK.' The large editorial headline reads 'SQUEEZE MORE' in white and 'FROM SEARCH.' in bright lime green. Below, the subtitle states, 'A complete Etsy SEO optimization report for a handcrafted lime mocktail mixer.' Near the lower left, bold text reads 'VISIBILITY / RELEVANCE / CLICKS / CONVERSION.' A section titled 'VISUAL-ONLY BASELINE' notes, 'Strong creative; listing metadata not supplied.' Near the bottom-right of the teal panel, a circular light-blue score badge displays '36 / 100 PROVISIONAL.' Along the right edge, a cropped product image shows a pale yellow lime mocktail in a clear glass, garnished with lime slices, green herbs, and a small yellow flower against a light blue patterned background. Premium editorial composition with bold serif typography, high-contrast color accents, and a fresh beverage-inspired visual style.](https://file.nanoskill.ai/esty-seo-outcome.png) ## Skill definition --- name: etsy-seo version: 1.0.0 author: Nexscope AI description: "Etsy SEO analyzer and optimizer. Improve search visibility with title optimization, tag analysis, description scoring, and keyword research. Includes SEO scoring (0-100), long-tail keyword suggestions, and prioritized action plans. No API key required." metadata: {"nexscope":{"emoji":"🔍","category":"ecommerce"}} --- # Etsy SEO 🔍 Analyze and optimize Etsy listings for better search visibility. ## Installation ```bash 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 ```bash python3 scripts/analyzer.py ``` ### With Listing Data ```bash python3 scripts/analyzer.py '{ "title": "Handmade Silver Ring", "tags": ["silver ring", "handmade jewelry"], "description": "Beautiful handmade ring...", "category": "Jewelry" }' ``` ### Demo Mode ```bash 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](https://www.nexscope.ai/?co-from=skill) — AI tools for e-commerce sellers.** ## FAQ ### What is Etsy SEO? Etsy SEO refers to optimizing product listings on Etsy to rank higher in the marketplace's search results. It involves crafting keyword-rich titles, using 13 accurate tags, writing compelling descriptions, and filling in all attribute fields. This skill automates that process by scoring each element and providing actionable suggestions. ### How does this Etsy SEO tool work? The tool analyzes your listing data—title, tags, description, category—and scores each dimension on a 0-100 scale using Etsy’s best practices. It then generates a report with a total SEO score, specific issues found, and a prioritized action plan to improve your ranking. ### Is it free to use? Yes, this Etsy SEO analyzer is open source and free to use. It requires no API keys or payments—just run it locally or via the command line. ### Do I need an Etsy API key? No. The tool works with listing data you provide manually or via JSON input. There is no integration with the Etsy API, so no key is required. ### What does the SEO score mean? The score is a composite rating out of 100, weighted by title (30%), tags (25%), description (20%), attributes (15%), and images (10%). A higher score means your listing is better optimized for Etsy’s search algorithm. ### How do I run the analyzer? You can run it interactively with \`python3 scripts/analyzer.py\`, pass listing data as a JSON argument, or use the demo mode with \`--demo\` to test with sample data.