Skip to main content
Glama
bwengr

Google Search Console MCP Server

by bwengr

MCP-сервер Google Search Console

Запрашивайте данные Google Search Console из любого ИИ-ассистента, поддерживающего протокол MCP: рейтинги, клики, показы и эффективность на уровне страниц.

Предварительные требования

  • Node.js 18+

  • Аккаунт Google с доступом к Google Search Console

Related MCP server: Google Search Console + GA4 MCP Server

Настройка

1. Установка зависимостей

npm install

2. Создание проекта в Google Cloud

  1. Перейдите в Google Cloud Console

  2. Создайте новый проект (или выберите существующий)

  3. Включите Search Console API:

    • Перейдите в APIs & Services > Library

    • Найдите "Search Console API"

    • Нажмите Enable

3. Создание учетных данных OAuth2

  1. Перейдите в APIs & Services > Credentials

  2. Нажмите Create Credentials > OAuth client ID

  3. Тип приложения: Desktop app (или Web application)

  4. Назовите его как угодно

  5. Скопируйте Client ID и Client Secret

4. Настройка файла .env

cp .env.example .env

Заполните значения:

Переменная

Где найти

GSC_SITE_URL

GSC Settings > Association > Sc-domain (например, sc-domain:bwengr.com)

GOOGLE_CLIENT_ID

Google Cloud Console > Credentials (из шага 3)

GOOGLE_CLIENT_SECRET

Google Cloud Console > Credentials (из шага 3)

5. Запуск сервера

npm start

При первом запуске автоматически откроется окно браузера для завершения аутентификации OAuth. После этого токены будут сохранены локально в файле .tokens.json, и повторный запрос не потребуется.

Подключение к вашему ИИ-ассистенту

Этот сервер взаимодействует через stdio (стандартный ввод/вывод), что является стандартным способом подключения MCP-серверов к ИИ-ассистентам. Настройте свой ИИ-ассистент на использование:

node /path/to/src/index.js

Замените /path/to на фактический путь к этому проекту на вашем компьютере.

Доступные инструменты

getTopQueries

Возвращает ваши лучшие поисковые запросы, отсортированные по количеству кликов.

  • Параметры: startDate (ГГГГ-ММ-ДД), endDate (ГГГГ-ММ-ДД), rowLimit (необязательно, по умолчанию 10)

  • Возвращает: запрос, клики, показы, CTR, позицию для каждой строки

getSiteSummary

Возвращает общие показатели эффективности поиска по сайту.

  • Параметры: startDate (ГГГГ-ММ-ДД), endDate (ГГГГ-ММ-ДД)

  • Возвращает: общее количество кликов, показов, CTR, среднюю позицию

getPagePerformance

Возвращает данные об эффективности, отфильтрованные по конкретной странице.

  • Параметры: pageUrl (точный URL, как показано в GSC), startDate (ГГГГ-ММ-ДД), endDate (ГГГГ-ММ-ДД)

  • Возвращает: клики, показы, CTR, позицию для этой страницы

getRankingChanges

Находит страницы с наибольшими изменениями позиции между двумя периодами.

  • Параметры: days (количество дней для сравнения, по умолчанию 28)

  • Возвращает: URL страницы, изменение позиции, текущую позицию, предыдущую позицию

Важно

Никогда не добавляйте .env или .tokens.json в систему контроля версий. Эти файлы уже исключены через .gitignore.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides access to Google Search Console to retrieve and analyze search performance data including queries, pages, and rankings. It enables users to perform rich data analysis through customizable reporting periods and dimensions using the Search Console API.
    4,242 npm
    MIT
  • F
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables querying Google Search Console and Google Analytics 4 data to retrieve search performance and site analytics. It provides tools for listing web properties and running detailed reports using secure Google OAuth authentication.
    -
  • A
    license
    A
    quality
    A
    maintenance
    Provides AI agents with read-only access to Google Search Console data, including search analytics, index coverage, and sitemap status. It enables users to query clicks, impressions, and ranking performance or check URL indexing status through natural language.
    4
    124 npm
    10
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Query Google Search Console search analytics, inspect URL indexing status, manage sitemaps, and analyze keyword performance. 13 tools covering search queries, page performance, sitemap management, and index coverage.
    13
    527 npm
    7
    MIT