{
  "markdown": "<div align=\"center\">\n\n<img src=\"assets/banner.svg\" alt=\"Seerxo — Etsy SEO in seconds\" width=\"100%\" />\n\n<br/><br/>\n\n[![npm](https://img.shields.io/npm/v/seerxo?color=a78bfa&label=npm)](https://www.npmjs.com/package/seerxo)\n[![npm downloads](https://img.shields.io/npm/dw/seerxo?logo=npm)](https://www.npmjs.com/package/seerxo)\n[![MCP](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io)\n[![smithery badge](https://smithery.ai/badge/seerxo)](https://smithery.ai/servers/seerxo)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![GitHub stars](https://img.shields.io/github/stars/semihbugrasezer/seerxo?style=social)](https://github.com/semihbugrasezer/seerxo)\n\n### Type what you sell. Get the whole listing.\n\nFront-loaded SEO title (+ A/B variants) · hook-first description · all **13 tags** ·\nEtsy attributes — generated in seconds, ready to paste.\nThen keep improving: **score**, **fix**, and **keyword-mine** existing listings from the same CLI, MCP server, and Claude Code skill.\n\n**[Try it free →](https://www.seerxo.com)**&ensp;·&ensp;[Quick start](#-quick-start)&ensp;·&ensp;[Sample output](#-see-it-work)\n\n</div>\n\n---\n\n## ⚡ See it work\n\n**You type:**\n\n```bash\nseerxo generate --product \"handmade ceramic coffee mug, speckled glaze, 12oz\"\n```\n\n**You get:**\n\n```\nTITLE   Handmade Ceramic Coffee Mug | Artisan Pottery | Unique Kitchen Gift | Microwave Safe\n\nTAGS    handmade mug · ceramic coffee cup · pottery mug · artisan mug · unique gift\n        coffee lover gift · handcrafted · kitchen decor · tea cup · housewarming gift\n        birthday present · ceramic pottery · handmade gift\n\nDESCRIPTION\nElevate your morning coffee ritual with this beautifully handcrafted ceramic mug.\nEach piece is lovingly made by skilled artisans, ensuring no two mugs are exactly\nalike. Featuring a comfortable ergonomic handle and smooth glazed finish. …\n\n+ 2 A/B title variants · Etsy attributes · target keywords · shipping tip · cross-sell idea\n```\n\nEvery field respects Etsy's rules out of the box: title ≤140 chars, exactly 13 tags,\neach tag ≤20 chars, lowercase, no duplicates.\n\n## 🧰 Use it where you already work\n\n| Channel | Best for | Get started |\n|---|---|---|\n| 🖥️ **CLI** | Terminal lovers, scripts, batch work | `npm i -g seerxo` |\n| 🤖 **Claude Desktop (MCP)** | \"Generate a listing\" mid-conversation | [Setup ↓](#claude-desktop-mcp) |\n| 🧑‍💻 **Claude Code skill** | Listings without leaving your editor | `seerxo skill add` |\n| 🌐 **[Web app](https://www.seerxo.com)** | Zero install + free [SEO Score audit](https://www.seerxo.com/audit) | Open and type |\n\nOne account, one credit pool — every channel shares it.\n\n## 🚀 Quick start\n\n```bash\nnpm install -g seerxo\nseerxo login     # Google sign-in in your browser; API key is saved for you\nseerxo generate --product \"boho macrame wall hanging\" --category \"Home & Living\"\n```\n\nAlready have a listing? Score it, fix it, and mine keywords from the same CLI:\n\n```bash\nseerxo analyze  --title \"Minimalist Mug\" --tags \"mug,gift\" --description \"...\"   # SEO score + weak points\nseerxo optimize --title \"Minimalist Mug\" --tags \"mug,gift\" --description \"...\"   # guided rewrite, before/after score\nseerxo keywords --seed \"ceramic mug\"                                             # ranked Etsy autosuggest keywords\n```\n\n(`seerxo audit` works as an alias for `analyze`.)\n\nPrefer interactive? Just run `seerxo` and type your product\n(add a category with `|`, e.g. `Boho bedroom wall art set | Wall Art`).\nAdd `--json` to any command for machine-readable output.\n\n<details id=\"claude-desktop-mcp\">\n<summary><b>🤖 Claude Desktop (MCP) setup</b></summary>\n<br/>\n\n1. Install the CLI and sign in (`seerxo login`) as above.\n2. Add the MCP server to your Claude Desktop config:\n\n   **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n   **Windows:** `%APPDATA%/Claude/claude_desktop_config.json`\n\n   ```json\n   {\n     \"mcpServers\": {\n       \"seerxo\": { \"command\": \"seerxo-mcp\" }\n     }\n   }\n   ```\n\n   Credentials are read from `~/.seerxo-mcp/config.json` (written by `seerxo login`);\n   you can override with `SEERXO_EMAIL` / `SEERXO_API_KEY` env vars. The file is\n   plaintext — keep it on single-user machines:\n   `chmod 700 ~/.seerxo-mcp && chmod 600 ~/.seerxo-mcp/config.json`\n\n3. Restart Claude Desktop and ask:\n   *\"Generate an Etsy listing for my handmade ceramic coffee mug\"*\n\n</details>\n\n<details>\n<summary><b>🧑‍💻 Claude Code skill setup</b></summary>\n<br/>\n\nThe repository is also a Claude Code plugin. To test it directly from a clone:\n\n```bash\nclaude plugin validate .\nclaude --plugin-dir .\n```\n\nOr install the same skill through the Seerxo CLI:\n\n```bash\nnpm install -g seerxo && seerxo login\nseerxo skill add            # user-level, all projects\nseerxo skill add --project  # …or current repo only\n```\n\nRestart Claude Code and ask for an Etsy listing — the skill drives the CLI for you.\nRemove anytime with `seerxo skill remove`. No global install? `npx seerxo skill add`.\n\n</details>\n\n<details>\n<summary><b>🔑 Already have an API key?</b></summary>\n<br/>\n\n```bash\nseerxo configure --email you@example.com --api-key keyId.secret\n```\n\nCheck state anytime with `seerxo status`; sign out with `seerxo logout`.\n\n</details>\n\n## 📦 What you get\n\n| Field | Details |\n|---|---|\n| **Title** | ≤140 chars, primary keywords front-loaded for Etsy search |\n| **A/B titles** | Alternative titles for split-testing |\n| **Description** | Hook-first opening, features, usage scenarios, call-to-action |\n| **13 tags** | Each ≤20 chars, lowercase, deduplicated, broad + specific mix |\n| **Attributes** | Occasion, style, color, material, recipient — Etsy's filter dropdowns |\n| **Extras** | Target keywords, shipping tip, cross-sell suggestion |\n\n> 💡 **Tip:** you can paste an Etsy listing URL that contains a title slug\n> (`etsy.com/listing/123/boho-macrame-wall-hanging`) — the product name is derived\n> from it. Bare links without a slug can't be read; paste the listing title instead.\n\n## 💳 Pricing\n\n| | Free | Premium |\n|---|---|---|\n| Listing audit (`analyze`) | **Unlimited** | Unlimited |\n| AI actions (generate, optimize, keywords) | **5** / month | up to **300** / month — [Upgrade →](https://www.seerxo.com/pricing) |\n\nBoth plans include every channel — CLI, Claude Desktop, Claude Code skill, and the web app.\n\n## 🤝 Support\n\n[GitHub Issues](https://github.com/semihbugrasezer/seerxo/issues) ·\n[info@seerxo.com](mailto:info@seerxo.com) · [seerxo.com](https://www.seerxo.com)\n\n> The npm package is **`seerxo`** — the old `seerxo-mcp` package is deprecated\n> (the `seerxo-mcp` *binary* still ships inside `seerxo` for Claude Desktop).\n\n## 📝 License\n\nMIT — see [LICENSE](LICENSE).\n\n---\n\n<div align=\"center\">\n\n**Built for Etsy sellers by [Seerxo](https://www.seerxo.com)**\n\n⭐ Star the repo if it saves you listing time — it helps other sellers find it.\n\n</div>\n",
  "bytes": 6925,
  "sha": "2e679ade53bf46588e1edaa2c20455a3db4fac4c9311049bef9a43bffb480229",
  "repo_slug": "semihbugrasezer/seerxo",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_semihbugrasezer_seerxo_0b2a8583/readme"
}