Seerxo - Etsy Seo Assistant

Name: Seerxo - Etsy Seo Assistant
Author: semihbugrasezer

@semihbugrasezer

Repository Homepage Documentation

About Seerxo - Etsy Seo Assistant

# Etsy SEO Generator

#etsyseo #etsy #seoagent #etsy-cli #etsy-seo #cli #etsy-skills #etsyskills

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "seerxo": {
      "command": "seerxo-mcp"
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

Type what you sell. Get the whole listing.

Front-loaded SEO title (+ A/B variants) · hook-first description · all 13 tags · Etsy attributes — generated in seconds, ready to paste.

Try it free → · Quick start · Sample output

⚡ See it work

You type:

seerxo generate --product "handmade ceramic coffee mug, speckled glaze, 12oz"

You get:

TITLE   Handmade Ceramic Coffee Mug | Artisan Pottery | Unique Kitchen Gift | Microwave Safe

TAGS    handmade mug · ceramic coffee cup · pottery mug · artisan mug · unique gift
        coffee lover gift · handcrafted · kitchen decor · tea cup · housewarming gift
        birthday present · ceramic pottery · handmade gift

DESCRIPTION
Elevate your morning coffee ritual with this beautifully handcrafted ceramic mug.
Each piece is lovingly made by skilled artisans, ensuring no two mugs are exactly
alike. Featuring a comfortable ergonomic handle and smooth glazed finish. …

+ 2 A/B title variants · Etsy attributes · target keywords · shipping tip · cross-sell idea

Every field respects Etsy's rules out of the box: title ≤140 chars, exactly 13 tags, each tag ≤20 chars, lowercase, no duplicates.

🧰 Use it where you already work

Channel	Best for	Get started
🖥️ CLI	Terminal lovers, scripts, batch work	`npm i -g seerxo`
🤖 Claude Desktop (MCP)	"Generate a listing" mid-conversation	Setup ↓
🧑‍💻 Claude Code skill	Listings without leaving your editor	`seerxo skill add`
🌐 Web app	Zero install + free SEO Score audit	Open and type
🧩 Chrome extension	Optimize on the Etsy page itself	Early preview

One account, one credit pool — every channel shares it.

🚀 Quick start

npm install -g seerxo
seerxo login     # Google sign-in in your browser; API key is saved for you
seerxo generate --product "boho macrame wall hanging" --category "Home & Living"

Prefer interactive? Just run seerxo and type your product (add a category with |, e.g. Boho bedroom wall art set | Wall Art). Add --json to any generate for machine-readable output.

🤖 Claude Desktop (MCP) setup

Install the CLI and sign in (seerxo login) as above.
Add the MCP server to your Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json
```
{
  "mcpServers": {
    "seerxo": { "command": "seerxo-mcp" }
  }
}
```
Credentials are read from ~/.seerxo-mcp/config.json (written by seerxo login); you can override with SEERXO_EMAIL / SEERXO_API_KEY env vars. The file is plaintext — keep it on single-user machines: chmod 700 ~/.seerxo-mcp && chmod 600 ~/.seerxo-mcp/config.json
Restart Claude Desktop and ask: "Generate an Etsy listing for my handmade ceramic coffee mug"

🧑‍💻 Claude Code skill setup

npm install -g seerxo && seerxo login
seerxo skill add            # user-level, all projects
seerxo skill add --project  # …or current repo only

Restart Claude Code and ask for an Etsy listing — the skill drives the CLI for you. Remove anytime with seerxo skill remove. No global install? npx seerxo skill add.

🔑 Already have an API key?

seerxo configure --email [email protected] --api-key keyId.secret

Check state anytime with seerxo status; sign out with seerxo logout.

📦 What you get

Field	Details
Title	≤140 chars, primary keywords front-loaded for Etsy search
A/B titles	Alternative titles for split-testing
Description	Hook-first opening, features, usage scenarios, call-to-action
13 tags	Each ≤20 chars, lowercase, deduplicated, broad + specific mix
Attributes	Occasion, style, color, material, recipient — Etsy's filter dropdowns
Extras	Target keywords, shipping tip, cross-sell suggestion

💡 Tip: you can paste an Etsy listing URL that contains a title slug (etsy.com/listing/123/boho-macrame-wall-hanging) — the product name is derived from it. Bare links without a slug can't be read; paste the listing title instead.

💳 Pricing

	Free	Premium
Generations	5 / month	up to 300 / month — Upgrade →

Both plans include every channel — CLI, Claude Desktop, Claude Code skill, and the web app.

🤝 Support

GitHub Issues · [email protected] · seerxo.com

The npm package is seerxo — the old seerxo-mcp package is deprecated (the seerxo-mcp binary still ships inside seerxo for Claude Desktop).