seerxo
v1.6.0
Published
MCP server for AI-powered Etsy SEO generation. Use with Claude Desktop to generate optimized product titles, descriptions, and tags in seconds.
Maintainers
Readme
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. Then keep improving: score, fix, and keyword-mine existing listings from the same CLI, MCP server, and Claude Code skill.
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 ideaEvery 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"Already have a listing? Score it, fix it, and mine keywords from the same CLI:
seerxo analyze --title "Minimalist Mug" --tags "mug,gift" --description "..." # SEO score + weak points
seerxo optimize --title "Minimalist Mug" --tags "mug,gift" --description "..." # guided rewrite, before/after score
seerxo keywords --seed "ceramic mug" # ranked Etsy autosuggest keywords(seerxo audit works as an alias for analyze.)
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.
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.jsonWindows:%APPDATA%/Claude/claude_desktop_config.json{ "mcpServers": { "seerxo": { "command": "seerxo-mcp" } } }Credentials are read from
~/.seerxo-mcp/config.json(written byseerxo login); you can override withSEERXO_EMAIL/SEERXO_API_KEYenv vars. The file is plaintext — keep it on single-user machines:chmod 700 ~/.seerxo-mcp && chmod 600 ~/.seerxo-mcp/config.jsonRestart Claude Desktop and ask: "Generate an Etsy listing for my handmade ceramic coffee mug"
npm install -g seerxo && seerxo login
seerxo skill add # user-level, all projects
seerxo skill add --project # …or current repo onlyRestart 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.
seerxo configure --email [email protected] --api-key keyId.secretCheck 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 oldseerxo-mcppackage is deprecated (theseerxo-mcpbinary still ships insideseerxofor Claude Desktop).
📝 License
MIT — see LICENSE.
Built for Etsy sellers by Seerxo
⭐ Star the repo if it saves you listing time — it helps other sellers find it.
