Install the AkaiSEO plugin for Claude Code

The AkaiSEO plugin bundles AkaiSEO MCP and all nine SEO Agent Skills into one install. This is the preferred way to set up AkaiSEO in Claude Code.

Install

Run these two commands in Claude Code:

/plugin marketplace add MohammedIbraAhmed/akaiseo
/plugin install akaiseo@akaiseo

If the install summary says Run /reload-plugins to activate., run that command.

Claude Code connects AkaiSEO MCP at https://app.akaiseo.com/mcp and enables nine skills:

SEO Project Setup
SEO Coach
SEO Audit
Keyword Research
Keyword Clustering
Competitive Landscape
Competitor Analysis
Local SEO
Link Prospecting

Claude Code should prompt you to log in to AkaiSEO right after install. If it doesn't, run /mcp and approve the AkaiSEO connection from there.

Run a skill

Plugin skills are namespaced by the plugin name:

/akaiseo:seo-project-setup
/akaiseo:seo-coach
/akaiseo:seo-audit
/akaiseo:keyword-research
/akaiseo:keyword-clustering
/akaiseo:competitive-landscape
/akaiseo:competitor-analysis
/akaiseo:local-seo
/akaiseo:link-prospecting

Claude Desktop

Claude Desktop doesn't support this plugin format — plugins are a Claude Code feature. For Claude Desktop, add AkaiSEO as an MCP connector instead.

Update or remove

/plugin marketplace update akaiseo
/plugin uninstall akaiseo@akaiseo

Updates land in the cache immediately, but the running session keeps the old version until you run /reload-plugins or restart Claude Code.

Troubleshooting

To check what's actually installed, run /plugin list rather than bare /plugin — /plugin alone opens an interactive panel that doesn't show plain text.

If /reload-plugins reports 0 skills, that's normal, not a failure — its summary only counts a plugin's commands/ directory, not skills/. Confirm the skills loaded by running one directly, for example /akaiseo:seo-audit.

If /plugin uninstall akaiseo@akaiseo reports "not installed in this project," you likely installed to a different scope than the one being checked (User, Project, or Local). Run /plugin list to see the actual scope, or sidestep the picker entirely with the shell form: claude plugin uninstall akaiseo@akaiseo --scope user.

If plugin skills don't appear, clear the plugin cache with rm -rf ~/.claude/plugins/cache — this clears every installed plugin's cache, not just AkaiSEO's, so reinstall anything else you have after — then restart Claude Code and reinstall the plugin.

If the AkaiSEO connection doesn't show as authenticated, run /mcp, select AkaiSEO, and complete the login.

Other clients