MCP Gsc

A tool that connects Google Search Console with Claude AI, analyzes SEO data through natural language conversations, and provides functions such as site management, search analysis, URL checking, and sitemap management.

Marketing Search tools #SEO Analysis #Data Visualization #Google Integration .Python

rating : 2.5 points

downloads : 78

update time : 2025-04-29

Function Overview

This tool allows users to query Google Search Console data through natural language, automatically generate analysis reports and provide suggestions. It supports functions such as multi - website management, performance trend analysis, and index problem troubleshooting.

Main Features

1. Supports OAuth and service account authentication; 2. Provides a natural language query interface; 3. Automatically generates visual reports; 4. Supports batch data analysis.

Multi - website ManagementSupports monitoring and analyzing website data under multiple Google Search Console accounts simultaneously.

Performance Trend AnalysisAutomatically generates time - series reports of search performance, including trend analysis of indicators such as impressions, clicks, and click - through rates.

Index Problem TroubleshootingIdentifies unindexed pages and provides repair suggestions.

Get API Key

Do I need programming knowledge to use this tool?

How to handle data from multiple Google accounts?

Official Documentation

Official documentation and usage guide for the Google Search Console API.

Sample Code Repository

Open - source implementation of the MCP tool and its usage examples.

🚀 How to Connect Claude to Google Search Console

This guide provides a step-by-step process to connect Claude to Google Search Console, enabling you to automate the acquisition and analysis of SEO data.

📦 Installation of Node.js and npm

Visit the official Node.js download page, select the appropriate version according to your operating system, and download and install it.
After installation, open the Terminal (macOS) or Command Prompt (Windows) and enter the following commands to check if the installation was successful:
```
node --version
npm --version
```
If version numbers similar to v18.x.x and 6.x.x are displayed, the installation was successful.

📦 Installation and Configuration of Google Search Console API

Create a Project and Enable the API

Open the Google Cloud Platform Console, create a new project, or select an existing one.
In the project, navigate to the "Library" section, search for, and enable the Google Search Console API and Cloud Storage JSON API.

Create a Service Account

Return to the project overview page and click "Create service account".
Fill in the name of the service account, select the role as Project Viewer, and then click "Create".
Download the generated JSON key file and save it in a secure location.

🔧 Configure Claude to Connect to Google Search Console

Install Necessary Packages

Open the Terminal or Command Prompt and run the following command to install the required Node.js packages:
```
npm install google-search-console@latest @google-cloud/searchConsole@latest
```

Create a Configuration File

Create a new file config.js in the project directory and add the following content (replace the information in parentheses with your actual information):
```
const config = {
  projectId: 'YOUR_PROJECT_ID',
  keyFilename: './path/to/your/service-account-key.json'
};

module.exports = config;
```

Write a Connection Script

Create another file search-console-connector.js and add the following code:

const { GoogleSearchConsole } = require('@google-cloud/searchConsole');
const config = require('./config');

async function main() {
  const searchConsole = new GoogleSearchConsole({
    projectId: config.projectId,
    keyFilename: config.keyFilename
  });

  // Example: Get the list of associated websites
  const sites = await searchConsole.sites.list();
  console.log('Associated websites:', sites.data);

  // Add more functionality, such as getting performance data or verifying sites
}

main().catch(console.error);

✅ Verify the Connection

Run the following command in the Terminal to execute the script:
```
node search-console-connector.js
```
If everything is set up correctly, you should see the "Associated websites" and other relevant information. If there are errors, check the configuration file and API permissions.

💻 Use Claude for Data Analysis

Claude can help you analyze the data obtained from Google Search Console and provide in-depth insights. Here are some tasks you can ask Claude to perform:

Get ranking data: Use the get_advanced_search_analytics tool to view the ranking of keywords.
Compare period performance: Analyze performance changes over different time intervals using the compare_search_periods tool.
Check index status: Use the list_sitemaps_enhanced tool to view the index status of your website and identify potential issues.

📊 Data Visualization

Claude can not only acquire data but also present it in various ways:

Trend charts: Observe the changing trends of various indicators over time.
Comparison graphs: Compare data performance across different dimensions or time periods.
Distribution maps: Analyze the performance of content at different locations.

For example, you can ask Claude to generate a "click-through rate trend chart for the past three months" to intuitively understand traffic fluctuations.

⚠️ Troubleshooting

Encountered the "Python command not found" issue?

On macOS, the default Python command is python3, not python. This may cause some Python-dependent tools to fail.

Solution:

Update the symbolic link:

sudo ln -mfs /usr/bin/python3 /usr/bin/python

Verify the success:
```
python --version
```

Other Common Issues

Permission issues: Ensure that your service account has sufficient API permissions and that the corresponding website is associated in Google Search Console.
Network issues: Check your internet connection to ensure that you can access Google's API services.
Code errors: Carefully review the error messages in the console output and make adjustments and fixes accordingly.

🌟 Conclusion

By following the steps above, you can successfully configure and use Claude to connect to Google Search Console, thereby automating the acquisition and analysis of SEO data. This will significantly improve your work efficiency and help you better optimize your website's performance in search engines.