io.github.avansaber/seo-monster MCP Server

io.github.avansaber/seo-monster

Repository Registry

What is the io.github.avansaber/seo-monster MCP server?

Local-first SEO MCP: track AI citations, Search Console, GA4, PageSpeed, Cloudflare, IndexNow, CrUX.

How to install io.github.avansaber/seo-monster

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

SEO_MCP_GOOGLE_OAUTH_CLIENT
Path to your Desktop-app OAuth client-secrets JSON, downloaded from Google Cloud Console. Required for Search Console, Indexing, and GA4 tools.
SEO_MCP_GOOGLE_TOKEN
Writable path where the cached OAuth token is stored. On first use, a browser opens for one-time consent and the token is written here. Default: ${HOME}/.config/seo-monster/token.json
SEO_MCP_GSC_DEFAULT_SITE
Default Search Console property, e.g. 'sc-domain:example.com' or 'https://www.example.com/'.
SEO_MCP_GA4_PROPERTY_ID
Default GA4 property, e.g. 'properties/123456789' or bare '123456789'.
PSI_API_KEY
secret
Google API key shared by PageSpeed Insights and Chrome UX Report History tools. Optional; both work anonymously at a tighter rate limit when unset.
CF_API_TOKEN
secret
Cloudflare API token. Optional; needed only for the Cloudflare tools. Scopes: Zone:Read, DNS:Read, Account Analytics:Read, and (only when destructive mode is on) Cache Purge:Purge, Single Redirect:Edit, Zone Settings:Edit, and (for bulk redirects) Account Rulesets:Edit + Account Filter Lists:Edit.
CF_ZONE
Default Cloudflare zone hostname, e.g. 'example.com'.
SEO_MCP_INDEXNOW_KEY
secret
IndexNow shared key (any 8-128 hex string you generate). Required only for the IndexNow tools. Host the key file at https://<your-host>/<key>.txt for engine verification.
SEO_MCP_INDEXNOW_KEY_LOCATION
Override the default IndexNow key-file URL (https://<host>/<key>.txt). Set only if you host the key file at a non-standard path.
SEO_MCP_ALLOW_DESTRUCTIVE
Set to 'true' to enable the Cloudflare cache-purge tools. Default false: all destructive tools refuse to run.
DATAFORSEO_LOGIN
secret
DataForSEO Basic-auth login. Optional (v0.9). Unlocks SERP/PAA/related, keyword volume+difficulty+intent, competitor keyword-gap, and Google AI Overview citations for keyword_universe / serp_adjacency_expand / onpage_serp_gap auto-fetch / ai_citation_track.
DATAFORSEO_PASSWORD
secret
DataForSEO Basic-auth password. Optional (v0.9). Required alongside DATAFORSEO_LOGIN.
OPENPAGERANK_API_KEY
secret
Open PageRank (DomCop) free API key. Optional (v0.9). Free competitor domain-authority proxy for onpage_serp_gap.
PERPLEXITY_API_KEY
secret
Perplexity Sonar API key. Optional (v0.9). One of the AI answer-engines for ai_citation_track.
OPENAI_API_KEY
secret
OpenAI API key (Responses web_search). Optional (v0.9). One of the AI answer-engines for ai_citation_track.
ANTHROPIC_API_KEY
secret
Anthropic API key (web_search tool). Optional (v0.9). One of the AI answer-engines for ai_citation_track.
GEMINI_API_KEY
secret
Google Gemini API key (Search grounding). Optional (v0.9). One of the AI answer-engines for ai_citation_track.
GOOGLE_ADS_DEVELOPER_TOKEN
secret
Google Ads API developer token. Optional (v0.9). Volume-only alternative to DataForSEO for keyword_universe; live use also needs an adwords-scope OAuth re-consent.
GOOGLE_ADS_CUSTOMER_ID
Google Ads customer id (digits). Optional (v0.9). Required alongside GOOGLE_ADS_DEVELOPER_TOKEN.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "seo-monster": {
      "command": "uvx",
      "args": [
        "seo-monster"
      ],
      "env": {
        "SEO_MCP_GOOGLE_OAUTH_CLIENT": "<YOUR_SEO_MCP_GOOGLE_OAUTH_CLIENT>",
        "SEO_MCP_GOOGLE_TOKEN": "<YOUR_SEO_MCP_GOOGLE_TOKEN>",
        "SEO_MCP_GSC_DEFAULT_SITE": "<YOUR_SEO_MCP_GSC_DEFAULT_SITE>",
        "SEO_MCP_GA4_PROPERTY_ID": "<YOUR_SEO_MCP_GA4_PROPERTY_ID>",
        "PSI_API_KEY": "<YOUR_PSI_API_KEY>",
        "CF_API_TOKEN": "<YOUR_CF_API_TOKEN>",
        "CF_ZONE": "<YOUR_CF_ZONE>",
        "SEO_MCP_INDEXNOW_KEY": "<YOUR_SEO_MCP_INDEXNOW_KEY>",
        "SEO_MCP_INDEXNOW_KEY_LOCATION": "<YOUR_SEO_MCP_INDEXNOW_KEY_LOCATION>",
        "SEO_MCP_ALLOW_DESTRUCTIVE": "<YOUR_SEO_MCP_ALLOW_DESTRUCTIVE>",
        "DATAFORSEO_LOGIN": "<YOUR_DATAFORSEO_LOGIN>",
        "DATAFORSEO_PASSWORD": "<YOUR_DATAFORSEO_PASSWORD>",
        "OPENPAGERANK_API_KEY": "<YOUR_OPENPAGERANK_API_KEY>",
        "PERPLEXITY_API_KEY": "<YOUR_PERPLEXITY_API_KEY>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<YOUR_GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_CUSTOMER_ID": "<YOUR_GOOGLE_ADS_CUSTOMER_ID>"
      }
    }
  }
}