google-seo-mcp

Google SEO MCP Expert Skill

This skill enables agents to manage the Google SEO MCP server (Google, Bing, and GA4). Use this to resolve configuration issues, list sites, and run performance queries.

🚀 Quick Start (Recommended)

Run the server directly without installation to verify setup:

npx google-seo-mcp setup

🛠️ Installation

Global Installation (CLI access)

npm install -g google-seo-mcp

Local Development

npm install && npm run build

⚙️ Configuration Patterns

1. Google Search Console (OAuth 2.0)

The default and most common way. Initiates a local server at localhost:3000 for browser authorization.

google-seo-mcp setup --engine=google

2. Bing Webmaster Tools

Requires an API key from Bing Webmaster Settings.

google-seo-mcp setup --engine=bing

3. Google Analytics 4 (Service Account)

Primary support for Service Accounts. JSON key file path is required.

google-seo-mcp setup --engine=ga4

🔍 Diagnostic & Debugging Workflows

If the user reports "0 results" or "not connected" errors, follow this diagnostic loop:

Step 1: Check Connectivity

Run the internal health check to verify API tokens and connectivity.

google-seo-mcp diagnostics

Step 2: Verify Authorized Sites

Verify which sites are actually authorized for use.

google-seo-mcp sites

Step 3: Verbose Debugging

Enable the internal logger to track account resolution and site filtering. Logs are sent to stderr.

DEBUG=true google-seo-mcp sites_list

🧪 Advanced Account Management

List All Configured Accounts

google-seo-mcp accounts list

Site Boundary Management

Google SEO MCP allows restricting an account to specific sites.

# Add a site to an account's whitelist
google-seo-mcp accounts add-site [email protected] --site=https://example.com/

# Remove an account entirely
google-seo-mcp accounts remove [email protected]

💡 Troubleshooting "0 Results" Guide

Common reasons for empty results:

1. Protocol Mismatch: https://example.com/ (URL prefix) is different from example.com (Domain).
2. GSC Data Lag: Data is typically unavailable for the last 2-3 days. Query ranges older than 3 days.
3. Account Scoping: The site might not be in the account's configured boundary. Use google-seo-mcp sites to confirm.