grain-seo-mcp

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

English | 简体中文

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

Go to Google Cloud Console
Create project, enable Search Console API
Create OAuth credentials (Desktop app) or Service Account
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