Этот проект предоставляет сервер Model Context Protocol (MCP), который позволяет Claude AI (через приложение Claude Desktop) или другим взаимодействовать с API Google Search Console. Вы можете использовать его для запроса данных о производительности, проверки URL-адресов, проверки статуса индексации и многого другого непосредственно из вашего чата Claude (или других).

Вы можете следить за мной на X @metehan777 и посетить мой блог.

Особенности

На основе доступных конечных точек Google Search Console API, разрешенных в этом проекте:

** Сайты:** Перечислите доступные сайты / свойства в своей учетной записи Search Console. ** Аналитика поиска:** Получите данные о производительности поиска (клики, показы, CTR, положение) с различными фильтрами и размерами. *** Инспекция URL:** Проверьте статус определенного URL-адреса в индексе Google, проверьте его статус индексации и запросите индексацию. Карты: Список представленных карт сайта для сайта. ** (Помощник)* Получить общую сводку производительности сайта (полученную из данных поисковой аналитики).

• (Примечание: данные об охвате индекса и ошибки сканирования за пределами того, что доступно в API проверки URL, обычно не отображаются через API Google Search Console.)

См. функции API Search Console и объявления здесь: https://developers.

Google Search Console MCP Server

This project provides a Model Context Protocol (MCP) server that allows Claude AI (via the Claude Desktop app) or others to interact with the Google Search Console API. You can use it to query performance data, inspect URLs, check indexing status, and more, directly from your Claude chat (or others).

You can follow me on X @metehan777 and visit my blog https://metehan.ai

Features

Based on the available Google Search Console API endpoints allowed in this project:

• Sites: List accessible sites/properties in your Search Console account.
• Search Analytics: Fetch search performance data (clicks, impressions, CTR, position) with various filters and dimensions.
• URL Inspection: Inspect the status of a specific URL in the Google index, check its indexing status, and request indexing.
• Sitemaps: List submitted sitemaps for a site.
• (Helper) Get an overall site performance summary (derived from Search Analytics data).

(Note: Index coverage details and crawl errors beyond what’s available in the URL Inspection API are generally not exposed via the Google Search Console API.)

See the Search Console API capabilities & announcements here: https://developers.google.com/webmaster-tools/v1/api_reference_index

Prerequisites

• Python: Version 3.11 or higher.
• pip: Python package installer (usually comes with Python).
• Virtual Environment Tool: venv (recommended, built into Python 3).
• Google Account: With access to the Google Search Console properties you want to query.
• Claude Desktop App: Installed and running.

Setup Instructions

1. Clone or Download: Get the project files onto your local machine. If using git:

   git clone https://github.com/metehan777/google-search-console-mcp.git
   cd search-console-mcp
   

2. Create and Activate Virtual Environment: It’s highly recommended to use a virtual environment to manage dependencies.

   # Create the virtual environment (using the name 'fresh_env' as in previous steps)
   python3 -m venv fresh_env
   
   # Activate the environment
   # On macOS/Linux:
   source fresh_env/bin/activate
   # On Windows:
   # .\fresh_env\Scripts\activate
   

   (You should see (fresh_env) at the beginning of your terminal prompt)

3. Install Dependencies: Install the required Python packages, including the project itself in editable mode.

   pip install -e .
   

4. Google Cloud Setup & Credentials:

   • Enable API: Go to the Google Cloud Console and create a new project or select an existing one. Enable the “Google Search Console API” for your project.
   • Create OAuth Credentials:
     • Navigate to “APIs & Services” -> “Credentials”.