A Model Context Protocol (MCP) server providing access to Google Search Console
A Model Context Protocol (MCP) server providing comprehensive access to Google Search Console data with enhanced analytics capabilities.
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.
npm install mcp-server-gsc
To obtain Google Search Console API credentials:
{
"mcpServers": {
"gsc": {
"command": "npx",
"args": ["-y", "mcp-server-gsc"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
}
}
}
}
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)deviceFilter: Filter by device type (DESKTOP, MOBILE, TABLET)searchAppearanceFilter: Filter by search feature (e.g., AMP_BLUE_LINK, AMP_TOP_STORIES)filterOperator: Operator for filters (equals, contains, notEquals, notContains, includingRegex, excludingRegex)Quick Wins Detection:
detectQuickWins: Enable automatic detection of optimization opportunities (default: false)quickWinsConfig: Configuration for quick wins detection:positionRange: Position range to consider (default: [4, 20])minImpressions: Minimum impressions threshold (default: 100)minCtr: Minimum CTR percentage (default: 1)Example - Basic Query:
{
"siteUrl": "https://example.com",
"startDate": "2024-01-01",
"endDate": "2024-01-31",
"dimensions": "query,page",
"rowLimit": 5000
}
Example - Advanced Filtering with Regex:
{
"siteUrl": "https://example.com",
"startDate": "2024-01-01",
"endDate": "2024-01-31",
"dimensions": "page,query",
"queryFilter": "regex:(AI|machine learning|ML)",
"filterOperator": "includingRegex",
"deviceFilter": "MOBILE",
"rowLimit": 10000
}
Example - Quick Wins Detection:
{
"siteUrl": "https://example.com",
"startDate": "2024-01-01",
"endDate": "2024-01-31",
"dimensions": "query,page",
"detectQuickWins": true,
"quickWinsConfig": {
"positionRange": [4, 15],
"minImpressions": 500,
"minCtr": 2
}
}
MIT
Contributions are welcome! Please read our contributing guidelines before submitting pull requests.
Be the first to comment.