⚡ 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 Listing Readiness check | Open and type |
One account, one credit pool — every channel shares it.
🚀 Quick start
npm install -g seerxo
seerxo login
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 "..."
seerxo optimize --title "Minimalist Mug" --tags "mug,gift" --description "..."
seerxo keywords --seed "ceramic mug"
(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.
🤖 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
The repository is also a Claude Code plugin. To test it directly from a clone:
claude plugin validate .
claude --plugin-dir .
Or install the same skill through the Seerxo CLI:
npm install -g seerxo && seerxo login
seerxo skill add
seerxo skill add --project
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 you@example.com --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 |
|---|
Listing audit (analyze) | Unlimited | Unlimited |
| AI actions (generate, optimize, keywords) | 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 ·
info@seerxo.com · 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).
📝 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.