grain-seo-mcp

SEO analysis MCP server — Google Search Console, Bing Webmaster Tools, GA4 analytics, with custom Grain Analysis Tools.

Grain Analysis Tools (new)

Tool	What it does
grain_content_decay	Detect pages with 3 consecutive 30-day traffic decline
grain_traffic_drops	Diagnose WHY traffic dropped: ranking loss / CTR collapse / demand decline
grain_ctr_benchmark	Compare CTR vs industry benchmarks by position
grain_verify_claim	Anti-hallucination: re-query GSC to verify numeric claims (±5% tolerance)
grain_topic_cluster	Aggregate performance for URL path patterns (e.g. /blog/)
grain_content_recommendations	Prioritized SEO actions: update / create / consolidate

Platform Tools

Google Search Console, Bing Webmaster Tools, Google Analytics 4 tools. See tools_list.md for full list.

Setup

Google Cloud Credentials

1. Go to Google Cloud Console
2. Create project, enable Search Console API
3. Create OAuth credentials (Desktop app) or Service Account
4. Download JSON

Claude Code Configuration

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "grain-seo": {
      "command": "node",
      "args": ["/Users/bobby/Projects/Github/zhangluka/grain-seo-mcp/dist/index.js"],
      "env": {
        "GSC_OAUTH_SECRETS_FILE": "/path/to/client_secrets.json"
      }
    }
  }
}

First use opens browser for Google sign-in. Token cached after that.

License

MIT