Generate SEO-optimized Etsy listings — title, description, and 13 tags — from your AI assistant.
io.github.semihbugrasezer/seerxo — MCP Server
This MCP server generates SEO-optimized Etsy listings from an AI assistant. It produces listing title, description, and 13 tags, based on the input you provide through the tool interface.
🛠️ Key Features
Generates Etsy listing title
Generates Etsy listing description
Generates 13 Etsy tags
MCP-compatible per catalog metadata
🚀 Use Cases
Producing Etsy listing content (title, description, tags) in one step
Generating tag sets of exactly 13 items for Etsy optimization
⚡ Developer Benefits
Deterministic output requirements: title, description, and 13 tags
Designed for integration as an MCP-compatible server
⚠️ Limitations
Details such as specific tools, parameters, or output format are not included in the provided source data
Front-loaded SEO title (+ A/B variants) · hook-first description · all 13 tags ·
Etsy attributes — generated in seconds, ready to paste.
Then keep improving: score, fix, and keyword-mine existing listings from the same CLI, MCP server, and Claude Code skill.
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.
One account, one credit pool — every channel shares it.
🚀 Quick start
bash
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"
Already have a listing? Score it, fix it, and mine keywords from the same CLI:
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 command for machine-readable output.
🤖 Claude Desktop (MCP) setup
Install the CLI and sign in (seerxo login) as above.
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
The repository is also a Claude Code plugin. To test it directly from a clone:
bash
claude plugin validate .
claude --plugin-dir .
Or install the same skill through the Seerxo CLI:
bash
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.
💡 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.
