ahonn/mcp-server-gsc

A Model Context Protocol (MCP) server providing comprehensive access to Google Search Console data with enhanced analytics capabilities.
Features
- **Enhanced Search Analytics**: Retrieve up to 25,000 rows of performance data
- **Advanced Filtering**: Support for regex patterns and multiple filter operators
- **Quick Wins Detection**: Automatically identify optimization opportunities
- **Rich Dimensions**: Query, page, country, device, and search appearance analysis
- **Flexible Date Ranges**: Customizable reporting periods with historical data access
Sponsored by
macuse.app is a native macOS application that gives your AI superpowers by integrating AI assistants with macOS apps like Calendar, Mail, and Notes, plus universal UI control for any application. Supports Claude Desktop, Cursor, and Raycast with one-click setup. Privacy-first, runs locally.
Prerequisites
- Node.js 18 or later
- Google Cloud Project with Search Console API enabled
- Service Account credentials with Search Console access
Installation
Authentication Setup
To obtain Google Search Console API credentials:
1. Visit the Google Cloud Console
2. Create a new project or select an existing one
3. Enable the API:
- Go to "APIs & Services" > "Library"
- Search for and enable "Search Console API"
4. Create credentials:
- Navigate to "APIs & Services" > "Credentials"
- Click "Create Credentials" > "Service Account"
- Fill in the service account details
- Create a new key in JSON format
- The credentials file (.json) will download automatically
5. Grant access:
- Open Search Console
- Add the service account email (format: name@project.iam.gserviceaccount.com) as a property administrator
Usage
Claude Desktop Configuration
Available Tools
search_analytics
Get comprehensive search performance data from Google Search Console with enhanced analytics capabilities.
**Required Parameters:**
- siteUrl: Site URL (format: http://www.example.com/ or sc-domain:example.com)
- startDate: Start date (YYYY-MM-DD)
- endDate: End date (YYYY-MM-DD)
**Optional Parameters:**
- dimensions: Comma-separated list (query, page, country, device, searchAppearance, date)
- type: Search type (web, image, video, news, discover, googleNews)
- aggregationType: Aggregation method (auto, byNewsShowcasePanel, byProperty, byPage)
- rowLimit: Maximum rows to return (default: 1000, max: 25000)
- dataState: Data freshness (all or final, default: final)
**Filter Parameters:**
- pageFilter: Filter by page URL (supports regex with regex: prefix)
- queryFilter: Filter by search query (supports regex with regex: prefix)
- countryFilter: Filter by country ISO 3166-1 alpha-3 code (e.g., USA, CHN)