What is Ahonn Mcp Server Gsc

ahonn_mcp-server-gsc is a Model Context Protocol (MCP) server that provides access to Google Search Console, allowing users to retrieve and analyze search analytics data.

Use cases

Use cases include generating reports on search performance, analyzing user queries, and optimizing website content based on search analytics data.

How to use

To use ahonn_mcp-server-gsc, install it via npm with ‘npm install mcp-server-gsc’. Configure the server by setting up authentication with Google Search Console API credentials and defining the server in your application configuration.

Key features

Key features include search analytics data retrieval with support for various dimensions and customizable reporting periods for rich data analysis.

Where to use

ahonn_mcp-server-gsc can be used in web development, SEO analysis, and digital marketing to enhance understanding of website performance in search results.

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

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: [email protected]) 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.