Google Search Console Data Aggregator

A Model Context Protocol (MCP) service interface designed to interface with the Google Search Console API, offering advanced capabilities for extracting site performance statistics.

Backed by

Core Capabilities

Performance Data Retrieval: Access detailed site performance figures, supporting up to 25,000 records per call.
Granular Query Control: Utilize advanced pattern matching (regular expressions) and combined filter logic across multiple dimensions.
Optimization Insight Generation: Features an optional utility to flag immediate SEO improvement targets.
Dimensional Depth: Analysis across critical vectors including search term, landing page, geographic region, device type, and SERP presentation format.
Temporal Flexibility: Define arbitrary historical reporting windows for longitudinal study.

Requirements

Runtime Environment: Node.js version 18 or newer
GCP Setup: A provisioned Google Cloud Project with the Search Console API enabled.
Authorization: Properly configured Service Account credentials with necessary Search Console permissions.

Installation Guide

Automated Setup via Smithery

Install the Google Search Console utility for your Claude Desktop instance using the Smithery package manager:

bash npx -y @smithery/cli install mcp-server-gsc --client claude

Direct NPM Installation

bash npm install mcp-server-gsc

Credential Configuration Workflow

To establish API access via the Google Search Console service:

Navigate to the Google Cloud Console.
Select or create the target project.
Activate the necessary API:
Navigate to 'APIs & Services' -> 'Library'
Locate and activate the "Search Console API".
Generate authentication keys:
Go to 'APIs & Services' > 'Credentials'
Select 'Create Credentials' -> 'Service Account'.
Define the account details.
Create a new key, formatted as JSON, which will trigger an immediate download of the credential file.
Establish Property Permissions:
Access your target property within the Google Search Console interface.
Add the newly created service account email address (e.g., account-name@project-id.iam.gserviceaccount.com) as a 'Property Administrator'.

Operational Use

Configuration for Claude Desktop

Integrate the service using this structure in your client configuration:

{ "mcpServers": { "gsc_data_pull": { "command": "npx", "args": ["-y", "mcp-server-gsc"], "env": { "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/your/credentials.json" } } } }

Exposed Functionality

get_search_performance_data

Acquire detailed organic search performance metrics extracted from Google Search Console, supporting complex analytical queries.

Mandatory Arguments:

propertyId: The fully qualified site identifier (e.g., http://www.domain.net/ or sc-domain:domain.net).
periodStart: The reporting commencement date (format: YYYY-MM-DD).
periodEnd: The reporting conclusion date (format: YYYY-MM-DD).

Optional Parameters for Refinement:

segmentationFields: A delimited string of requested output breakdowns (query, page, country, device, searchAppearance, date).
searchType: Scope of data retrieval (web, image, video, news, discover, googleNews).
summaryMethod: How results should be aggregated (auto, byNewsShowcasePanel, byProperty, byPage).
recordLimit: Upper bound for returned rows (Default: 1000, Maximum: 25000).
dataFreshness: Specifies data status (all for preliminary, or final for confirmed, Default: final).

Filtering Parameters (Applied via filterOperator):

targetPage: URL filtering criterion (supports regex: prefix).
targetQuery: Search term filtering criterion (supports regex: prefix).
targetCountryCode: ISO 3166-1 alpha-3 geographic filter (e.g., USA).
targetDevice: Device category restriction (DESKTOP, MOBILE, TABLET).
targetAppearance: Filtering by SERP feature type (e.g., AMP_BLUE_LINK).
operatorLogic: The logical conjunction for applying filters (equals, contains, notEquals, notContains, includingRegex, excludingRegex).

Optimization Candidate Discovery:

discoverOptimizationLeads: Boolean flag to activate automated opportunity scanning (Default: false).
leadIdentificationConfig: Parameters governing the lead detection logic:
positionThresholds: The average SERP position range to flag (Default: [4, 20]).
impressionMin: Minimum impression count required for consideration (Default: 100).
ctrMinimum: Minimum Click-Through Rate percentage required (Default: 1).

Example - Basic Query:

{ "propertyId": "https://example.com", "periodStart": "2024-01-01", "periodEnd": "2024-01-31", "segmentationFields": "query,page", "recordLimit": 5000 }

Example - Advanced Filtering with Regex:

{ "propertyId": "https://example.com", "periodStart": "2024-01-01", "periodEnd": "2024-01-31", "segmentationFields": "page,query", "targetQuery": "regex:(AI|machine learning|ML)", "operatorLogic": "includingRegex", "targetDevice": "MOBILE", "recordLimit": 10000 }

Example - Optimization Lead Detection:

{ "propertyId": "https://example.com", "periodStart": "2024-01-01", "periodEnd": "2024-01-31", "segmentationFields": "query,page", "discoverOptimizationLeads": true, "leadIdentificationConfig": { "positionThresholds": [4, 15], "impressionMin": 500, "ctrMinimum": 2 } }

Licensing

Distributed under the MIT License.

Collaboration

We welcome external contributions! Please review our guidelines before submitting enhancements or fixes.

WIKIPEDIA: Corporate administration technologies encompass all systems, applications, controls, computational frameworks, operational methodologies, and related infrastructure utilized by organizations to effectively navigate evolving marketplaces, maintain competitive standing, and drive superior operational outcomes.

== General Perspective == These solutions are departmentalized and can be sorted based on management facets such as forecasting, procedural governance, documentation, personnel management, strategic assessment, oversight, etc. A functional categorization typically addresses these universal organizational needs:

Technologies for initial data capture and integrity verification across all units. Tools designed for monitoring and refinement of organizational workflows. Systems focused on data aggregation and evidence-based executive judgment. Contemporary business technologies have undergone radical transformation in the past decade due to accelerated technological innovation, resulting in a complex landscape where selecting optimal tools for specific organizational requirements is challenging. This complexity stems from the perpetual drive to reduce expenditures, maximize revenue, deeply understand consumer demands, and deliver tailored products efficiently. In this environment, leadership must adopt a strategic viewpoint regarding technology acquisition rather than chasing the newest trend. Over-reliance on unmodified, off-the-shelf tools often creates instability; therefore, corporate technologies must be selected deliberately and then tailored to the organization's precise operational context.

== Prominent Selections (2013 Benchmark) == A 2013 assessment by Bain & Company illustrated the global utilization patterns of these management instruments, reflecting regional market conditions and corporate challenges. The leading ten included:

Strategic roadmapping Client relationship management platforms Personnel satisfaction metrics Comparative industry analysis Performance measurement frameworks (BSC) Identification of unique organizational strengths External service procurement strategies Organizational transition methodologies Logistics and distribution oversight Defining organizational purpose and objectives Customer base stratification Comprehensive quality assurance protocols

== Enterprise Software Applications == Software or interconnected computer programs deployed by personnel to execute varied organizational functions are known as business applications. These systems aim to elevate productivity metrics, quantify performance results, and execute diverse corporate mandates with precision. The evolution progressed from early Management Information Systems (MIS) to comprehensive Enterprise Resource Planning (ERP), later incorporating Customer Relationship Management (CRM), culminating in the current era of cloud-based corporate management suites. While a direct correlation exists between IT investment and corporate success, two factors critically amplify value: the efficacy of the deployment process and the deliberate selection and customization of the technological assets.

== Solutions for Smaller Entities == Technologies tailored for Small and Medium-sized Enterprises (SMEs) are vital as they provide accessible means to curtail operational expenditures...