How avansaber/seo-monster works
SEOMonster is a local stdio MCP server that exposes SEO analysis tools to an AI assistant. The host dispatches a requested tool; tools use configured service clients and return results for the assistant to explain. Major product branches include Search Console and Analytics, content and keyword research, technical SEO, performance, AI visibility, and site operations. The README documents broad tool coverage, while sampled source is partial, so links between specific unsampled tools and clients are omitted.
Main entry points: server.py MCP server · gsc.py Google clients · gsc_tools.py Search Console · ga4_tools.py Analytics
Components 26
MCP interface
- MCP server
src/seo_mcp/server.py - Workflow prompts
src/seo_mcp/prompts.py
SEO analysis
- Search Console
src/seo_mcp/tools/gsc_tools.py - Analytics
src/seo_mcp/tools/ga4_tools.py - Content opportunities
src/seo_mcp/tools/content_tools.py - Keyword discovery
src/seo_mcp/tools/keyword_universe_tools.py - Topic clusters
src/seo_mcp/tools/topic_cluster_tools.py - Link analysis
src/seo_mcp/tools/linkgraph_tools.py - AI visibility
src/seo_mcp/tools/ai_citation_tools.py - AI readiness
src/seo_mcp/tools/ai_readiness_tools.py
Site operations
- Technical SEO
src/seo_mcp/tools/onpage_tools.py - Structured data
src/seo_mcp/tools/schema_tools.py - Crawl posture
src/seo_mcp/tools/robots_posture_tools.py - Page performance
src/seo_mcp/tools/psi_tools.py - Indexing requests
src/seo_mcp/tools/indexnow_tools.py - Cloudflare controls
src/seo_mcp/tools/cf_tools.py
Data integrations
- Client provider
src/seo_mcp/server.py - Google clients
src/seo_mcp/clients/gsc.py - Cloudflare client
src/seo_mcp/clients/cloudflare.py - AI engine client
src/seo_mcp/clients/ai_engines.py
Configuration
- Runtime config
src/seo_mcp/config.py - Google auth
src/seo_mcp/clients/google_auth.py
Other components
- AI assistant
- Google services
- Cloudflare API
- AI answer engines
Connections 31
- AI assistant → MCP server: MCP stdio
- MCP server → AI assistant: tool results
- MCP server → Search Console: dispatches
- MCP server → Analytics: dispatches
- MCP server → Content opportunities: dispatches
- MCP server → Keyword discovery: dispatches
- MCP server → Topic clusters: dispatches
- MCP server → Link analysis: dispatches
- MCP server → AI visibility: dispatches
- MCP server → AI readiness: dispatches
- MCP server → Technical SEO: dispatches
- MCP server → Structured data: dispatches
- MCP server → Crawl posture: dispatches
- MCP server → Page performance: dispatches
- MCP server → Indexing requests: dispatches
- MCP server → Cloudflare controls: dispatches
- MCP server → Workflow prompts: publishes
- MCP server → Client provider: builds lazily
- Client provider → Runtime config: reads
- Client provider → Google clients: builds
- Client provider → Cloudflare client: builds
- Client provider → AI engine client: builds
- Search Console → Client provider: gets clients
- Analytics → Client provider: gets clients
- Content opportunities → Client provider: gets clients
- Cloudflare controls → Client provider: gets clients
- Google clients → Google services: API calls
- Cloudflare client → Cloudflare API: API calls
- AI engine client → AI answer engines: queries
- Google auth → Runtime config: resolves credentials
- Google clients → Google auth: builds credentials