$git clone https://github.com/seranking/seo-skillsClaude SEO Skills — production Claude Agent Skills for the SE Ranking MCP server. Content briefs, AI Search share of voice, audits, backlink gaps, keyword clusters, schema, sitemap, GEO, and more.
| 1 | # Claude SEO Skills |
| 2 | |
| 3 | Production-ready [Claude Agent Skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) for SEO, powered by the [SE Ranking remote MCP](https://seranking.com/api/integrations/mcp). Each skill turns raw API data into a finished SEO deliverable — content briefs, AI Search share of voice, page intelligence, structured data, drift monitoring, SXO diagnostics, competitive analysis, and more. |
| 4 | |
| 5 | These Claude Skills are designed to work with the SE Ranking MCP server, but they document every API call explicitly so they can also be adapted to other SEO data providers. |
| 6 | |
| 7 | ## Install |
| 8 | |
| 9 | Three ways. Pick the first one that fits. |
| 10 | |
| 11 | ### 1. Claude Desktop (recommended) |
| 12 | |
| 13 | The easiest setup — no terminal needed. Cowork in Claude Desktop installs the plugin from a marketplace through a UI flow. |
| 14 | |
| 15 | 1. Open **Customize** in the sidebar. |
| 16 | 2. Click **Personal plugin** → **+ Create plugin**. |
| 17 | 3. Click **Add marketplace** and enter `seranking/seo-skills`. |
| 18 | 4. Install the plugin once the marketplace loads. |
| 19 | |
| 20 | Skills are available in your next Cowork session. Trigger them by name — `seo-content-brief`, `seo-page`, etc. — or just describe what you want and Claude picks the right one. |
| 21 | |
| 22 | ### 2. Claude Code (slash commands) |
| 23 | |
| 24 | If you use Claude Code in the terminal: |
| 25 | |
| 26 | ```bash |
| 27 | /plugin marketplace add seranking/seo-skills |
| 28 | /plugin install seo-skills@seranking |
| 29 | ``` |
| 30 | |
| 31 | Trigger skills with `/seo-content-brief`, `/seo-page`, etc. — no `seo-skills:` prefix needed. Or just describe what you want and Claude picks the right skill. Update the marketplace later with `/plugin marketplace update seranking`. |
| 32 | |
| 33 | ### 3. Manual install (only if you want `seo-google` or the optional extensions) |
| 34 | |
| 35 | Options 1 and 2 cover **25 of 26 skills**. The 26th — `seo-google` — ships Python scripts that need a local clone. The optional Firecrawl + Google extensions also need this. **If neither matters to you, skip this option.** |
| 36 | |
| 37 | ```bash |
| 38 | git clone --depth 1 https://github.com/seranking/seo-skills.git |
| 39 | bash seo-skills/install.sh |
| 40 | ``` |
| 41 | |
| 42 | The installer is interactive — it asks which extensions to install. Accept the defaults and you're done. Re-running pulls the latest version and re-runs the chosen extensions. Requires `git`, `python3` 3.10+, and (for Firecrawl) `node` 20+. |
| 43 | |
| 44 | <details> |
| 45 | <summary>One-liner (curl)</summary> |
| 46 | |
| 47 | ```bash |
| 48 | curl -fsSL https://raw.githubusercontent.com/seranking/seo-skills/main/install.sh | bash -s -- --all |
| 49 | ``` |
| 50 | |
| 51 | `--all` enables both extensions. Use `--firecrawl` / `--google` individually, or `--no-extensions` to clone only. Default clone target is `~/.local/share/seo-skills`; override with `--target /path/to/dir`. |
| 52 | |
| 53 | </details> |
| 54 | |
| 55 | The manual install only wires your *environment* (extensions, Python deps, `~/.config/seo-skills/`). You still need Option 1 or 2 above so Claude can find the skill files. |
| 56 | |
| 57 | ### 4. Cursor |
| 58 | |
| 59 | SE Ranking is also packaged as a [Cursor plugin](.cursor-plugin/plugin.json). Once it is listed on [cursor.com/marketplace](https://cursor.com/marketplace), install it from the marketplace, or add it by name in Cursor: |
| 60 | |
| 61 | ``` |
| 62 | /add-plugin se-ranking |
| 63 | ``` |
| 64 | |
| 65 | The hosted SE Ranking MCP server is declared in [`mcp.json`](mcp.json) and is auto-detected when the plugin is installed — open Cursor's MCP settings and sign in via OAuth (no API token to manage). The same skills ship to the Cursor agent. |
| 66 | |
| 67 | ### Connect SE Ranking (any install path) |
| 68 | |
| 69 | The SE Ranking remote MCP auto-registers when you install the plugin — there's no separate `claude mcp add` step. On your first session, run `/mcp` and sign in via OAuth. No API token to manage. If you don't have an SE Ranking account yet, [sign up](https://seranking.com/api.html) — API access is required. |
| 70 | |
| 71 | <details> |
| 72 | <summary>Manual fallback (older Claude Code, or troubleshooting)</summary> |
| 73 | |
| 74 | If `/mcp` doesn't list `se-ranking` after install — typically because you're on a Claude Code build that pre-dates plugin-bundled MCP servers — register it directly: |
| 75 | |
| 76 | ```bash |
| 77 | claude mcp add --transport http se-ranking https://api.seranking.com/mcp |
| 78 | ``` |
| 79 | |
| 80 | Then run `/mcp` and complete OAuth. (User-scope registrations [outrank plugin-bundled ones](https://code.claude.com/docs/en/mcp#scope-hierarchy-and-precedence), so this safely overrides whatever the plugin shipped with.) |
| 81 | |
| 82 | </details> |
| 83 | |
| 84 | ## What you get |
| 85 | |
| 86 | 25 finished example outputs — covering 25 of the 26 skills — live in [`examples/`](examples/). Each is a real run against a publicly observable target. Three flagship examples to skim before installing: |
| 87 | |
| 88 | - **[`seo-plan` for wix.com (90-day plan)](examples/seo-plan-wix-com-20260514/PLAN.md)** — phased SEO roadmap that composes outputs from `seo-ai-search-share-of-voice`, `seo-competitor-gap-analysis`, and `seo-drift` into a 90-day plan with owners, success metrics, and a critical path. Demonstrates skill composition. |
| 89 | - **[`seo-technical-audit` for linear.app](examples/seo-technical-audit-linear-app-20260514/TECH-AUDIT.md)** — top-10 priority fix list ranked by `severity × affected_pages / effort`, plus `issues.csv` for |