seo-monster

Package (pypi 0.9.3)

uvx seo-monster

Or add to your MCP client config:

{
  "mcpServers": {
    "seo-monster": {
      "command": "uvx",
      "args": [
        "seo-monster"
      ],
      "env": {
        "PSI_API_KEY": "<YOUR_VALUE>",
        "CF_API_TOKEN": "<YOUR_VALUE>",
        "SEO_MCP_INDEXNOW_KEY": "<YOUR_VALUE>",
        "DATAFORSEO_LOGIN": "<YOUR_VALUE>",
        "DATAFORSEO_PASSWORD": "<YOUR_VALUE>",
        "OPENPAGERANK_API_KEY": "<YOUR_VALUE>",
        "PERPLEXITY_API_KEY": "<YOUR_VALUE>",
        "OPENAI_API_KEY": "<YOUR_VALUE>",
        "ANTHROPIC_API_KEY": "<YOUR_VALUE>",
        "GEMINI_API_KEY": "<YOUR_VALUE>",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<YOUR_VALUE>"
      }
    }
  }
}

• 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.