📌Overview

Purpose: To provide a streamlined interface for accessing Google Search Console data through a Model Context Protocol (MCP) server.

Overview: The Google Search Console MCP Server facilitates the retrieval of search analytics data, enabling users to perform rich data analysis with flexible reporting capabilities. It integrates seamlessly with Google Cloud services and can be set up easily with Node.js.

Key Features:

• Search Analytics Data Retrieval: Allows users to access search performance data with support for various dimensions, enabling detailed insights into search queries, page performance, and more.

• Customizable Reporting Periods: Users can define specific time frames for their data analysis, enhancing the relevance and precision of reports produced.

---

Google Search Console MCP Server

A Model Context Protocol (MCP) server providing access to Google Search Console.

Features

• Search analytics data retrieval with dimensions support
• Rich data analysis with customizable reporting periods

Prerequisites

• Node.js 18 or later
• Google Cloud Project with Search Console API enabled
• Service Account credentials with Search Console access

Installation

Installing via Smithery

To install Google Search Console for Claude Desktop automatically via Smithery:

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

Manual Installation

npm install mcp-server-gsc

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

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

Available Tools

search_analytics

Get search performance data from Google Search Console with customizable parameters:

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)
• type: Search type (web, image, video, news)
• aggregationType: Aggregation method (auto, byNewsShowcasePanel, byProperty, byPage)
• rowLimit: Maximum rows to return (default: 1000)

Example:

{
  "siteUrl": "https://example.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "query,country",
  "type": "web",
  "rowLimit": 500
}

License

MIT

Contributing

Contributions are welcome! Please read our contributing guidelines before submitting pull requests.