# grain-seo-mcp

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

> English | [简体中文](./README_zh-CN.md)

## 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](https://console.cloud.google.com/)
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`:

```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