Seerxo - Etsy Seo Assistant

SSE

by semihbugrasezer

359 downloads Not rated yet

About

![npm](https://www.npmjs.com/package/seerxo) ![MCP](https://modelcontextprotocol.io) ![License: MIT](https://opensource.org/licenses/MIT) ![GitHub stars](https://github.com/semihbugrasezer/seerxo)

Details

Transport
SSE

Explore

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Seerxo - Etsy Seo Assistant
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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.

<details id="claude-desktop-mcp">
<summary><b>🤖 Claude Desktop (MCP) setup</b></summary>
<br/>

1. Install the CLI and sign in (seerxo login) as above.
2. 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

3. Restart Claude Desktop and ask:
"Generate an Etsy listing for my handmade ceramic coffee mug"

</details>

<details>
<summary><b>🧑‍💻 Claude Code skill setup</b></summary>
<br/>

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.

</details>

<details>
<summary><b>🔑 Already have an API key?</b></summary>
<br/>

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

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

</details>

generate_etsy_seo

Use this when the user wants a complete SEO-optimized Etsy listing from a product idea. Returns a title, A/B title variants, description, exactly 13 tags, and attributes. Uses one generation from the monthly quota.

seerxo_analyze_listing

Use this when the user wants to score or diagnose an existing Etsy listing. Returns an explainable SEO score, sub-scores, weak points, missing keywords, and tag utilization. Free — does not use quota.

seerxo_optimize_listing

Use this when the user wants to rewrite an existing Etsy title, description, or tags based on audit findings. A re-audit gate prevents score regression. Uses one generation from the monthly quota.

seerxo_suggest_keywords

Use this when the user wants Etsy keyword ideas for a product or listing. Returns ranked autosuggest phrases with relative demand and placement guidance; never fabricates search volumes. Uses one generation from the monthly quota.

seerxo_quota

Use this when the user asks about Seerxo credits or usage. Shows the authenticated account's remaining monthly generation quota. Free.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "seerxo - etsy seo assistant": {
            "seerxo": {
                "command": "seerxo-mcp"
            }
        }
    }
}

McpServers

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

<div align="center">

Seerxo — Etsy SEO in seconds

<br/><br/>

npm
MCP
License: MIT
GitHub stars

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 →&ensp;·&ensp;Quick start&ensp;·&ensp;Sample output

</div>

---

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

<details id="claude-desktop-mcp">
<summary><b>🤖 Claude Desktop (MCP) setup</b></summary>
<br/>

1. Install the CLI and sign in (seerxo login) as above.
2. 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

3. Restart Claude Desktop and ask:
"Generate an Etsy listing for my handmade ceramic coffee mug"

</details>

<details>
<summary><b>🧑‍💻 Claude Code skill setup</b></summary>
<br/>

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.

</details>

<details>
<summary><b>🔑 Already have an API key?</b></summary>
<br/>

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

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

</details>

📦 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).

📝 License

MIT — see LICENSE.

---

<div align="center">

Built for Etsy sellers by Seerxo

⭐ Star the repo if it saves you listing time — it helps other sellers find it.

</div>

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.