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
