Seerxo - Etsy Seo Assistant

Name: Seerxo - Etsy Seo Assistant
Author: semihbugrasezer

Remote

seerxo.comAI & Agents28Updated 6d ago

Docs Repository Visit website

About Seerxo - Etsy Seo Assistant

Seerxo helps Etsy sellers create and refine product listings through a CLI, MCP server, Claude Code skill, or web app. It also analyzes existing listings and mines keywords.

Key features

01Generate titles, descriptions, and 13 tags
02Supply title variants and product attributes
03Analyze listing readiness
04Optimize existing listings
05Mine Etsy autosuggest keywords

Use cases

01Create an Etsy listing for a new product
02Review an existing listing for improvements
03Research search keywords for a product

MCP support

Seerxo provides an MCP server that lets Claude Desktop invoke listing generation in conversation. The server reads credentials saved by the CLI.

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

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://api.seerxo.com/mcp

Copy install command

Claude CodeTerminalclaude mcp add --transport http semihbugrasezer-seerxo https://api.seerxo.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"semihbugrasezer-seerxo":{"type":"http","url":"https://api.seerxo.com/mcp"}}}Open in Cursor

VS Code.vscode/mcp.json{"servers":{"semihbugrasezer-seerxo":{"type":"http","url":"https://api.seerxo.com/mcp"}}}Open in VS Code

Claude Desktopclaude_desktop_config.json{"mcpServers":{"semihbugrasezer-seerxo":{"type":"http","url":"https://api.seerxo.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"semihbugrasezer-seerxo":{"serverUrl":"https://api.seerxo.com/mcp"}}}

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Packages

npmseerxo1.13.0stdio

Tools

Parameter	Type	Required	Description
category	string	No	Etsy category, e.g. "Home & Living"
product_name	string	Yes	Product description, e.g. "handmade ceramic coffee mug, speckled glaze, 12oz"

Details

From the project 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 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     # 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 "..."   # sourced readiness findings
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.

🤖 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            # 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
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 · [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).

📝 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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.