Docs
Install SEOmonster in your AI assistant.
The fastest path: one command, one OAuth flow, one first prompt. Pick your AI host below.
Install
One-command install in your AI assistant.
Authenticate
Google OAuth for Search Console and GA4. Other surfaces use API keys.
First prompt
Run weekly_review against your real Search Console property.
Tool reference
57 tools with parameters, annotations, result envelopes.
Workflow prompts
13 workflow prompts: what each one chains and when to use it.
Troubleshooting
Setup help, common errors, and the full reference in the GitHub README.
Install in your AI host.
SEOmonster ships as a Python package on PyPI and a one-click bundle for Claude Desktop. About three minutes to install in any supported host.
Claude Desktop
Download the .mcpb bundle from the GitHub Releases page and double-click to install.
open https://github.com/avansaber/seo-monster/releases/latestOne-click install. No terminal needed for the install step itself. You will still need to complete OAuth from a terminal for Google-backed tools.
Claude Code
Add SEOmonster as an MCP server in one command.
claude mcp add seo-monster -- uvx seo-monsterRestart Claude Code. SEOmonster appears in the MCP-tools palette.
Cursor
Add the entry to ~/.cursor/mcp.json.
{
"mcpServers": {
"seo-monster": {
"command": "uvx",
"args": ["seo-monster"]
}
}
}Restart Cursor. Look for "seo-monster" in the MCP indicator.
Cline / Codex
Same stdio config pattern. Drop the JSON into the host's MCP config file.
See your host's MCP documentation for the exact config path.SEOmonster is host-agnostic at the protocol level.
Authenticate.
Each data surface uses its own auth. Run only the auth you need.
Google Search Console + GA4 (OAuth)
From a terminal:
uvx seo-monster authToken caches at ~/.config/seo-monster/token.json with mode 0600.
PageSpeed Insights + Chrome UX
Get a free API key from Google Cloud Console, set the env var:
export PSI_API_KEY="your-key"CrUX history works without a key in anonymous mode at lower rate.
Cloudflare
Create a token in Cloudflare dashboard with the scopes you need:
export CF_API_TOKEN="your-token"IndexNow
Pick any 32-character hex string, set it, host the verification file:
export SEO_MCP_INDEXNOW_KEY="your-32-char-hex"Full env-var matrix in the GitHub README. Read it on GitHub.
Run your first prompt.
In your AI assistant, ask:
Run my weekly SEO review for the last 14 days
on sc-domain:example.com
The host calls the weekly_review prompt. The server chains four tools and returns a 200-word summary in your chat. Total time: about 6 seconds.
Or, with no auth at all, ask:
Run inspect_meta on https://www.anthropic.comReturns title, meta description, OG tags, canonical. The technical-SEO and structured-data tools work this way, no credentials required.
Reference.
The README on GitHub is the canonical reference for all 57 tools and 13 prompts. We mirror it back here in a follow-up release.