Каталог MCP
acamolese/google-search-console-mcp

acamolese/google-search-console-mcp

Name: acamolese/google-search-console-mcp
Availability: InStock
Author: acamolese

MCP-сервер для Google Search Console: подключает данные о производительности, индексации и запросах к ИИ-ассистентам. Полезен SEO-специалистам и разработчикам — генерирует HTML-аудит, проверяет URL...

README

17 инструментов

Версии

Установить сервер

Google Search Console MCP Server

Read this in: English | Italiano

Open-source Model Context Protocol (MCP) server for Google Search Console. Brings your Search Console performance data, URL inspection, indexing checks, and sitemaps into Claude Code, Claude Desktop, Cursor, Zed, Continue, and any MCP-compatible client, and generates complete brandable HTML SEO audit reports in a single call.

If you work with SEO and use an AI coding assistant, this MCP server removes the copy-paste loop between Search Console and your chat: ask for top queries, check which pages are indexed, inspect a URL, or produce a 30/60/90-day SEO roadmap as an HTML report, all without leaving the assistant.

Features

Read-only access to Search Console (no write operations to your properties, only the webmasters.readonly OAuth scope)
8 tools covering sites, performance queries, pages, devices, countries, indexing, sitemaps, URL inspection
gsc_audit: one-call generator for a self-contained HTML SEO report with Chart.js graphs, automatic issue detection, concrete examples, actionable strategy and a 30/60/90-day roadmap
Brandable reports: customize logo, font, and color palette via branding.json, perfect for agencies delivering white-label audits
Stateless-friendly: credentials via environment variables (ideal for CI, Docker, hosted MCP) or via the XDG config directory
Zero setup with uvx: no clone, no virtualenv, runs straight from PyPI
Works with any MCP client: Claude Code, Claude Desktop, Cursor, Zed, Continue, Windsurf

Инструменты были проиндексированы: 09.09.2026

gsc_alertsтолько чтениеидемпотентныйвнешний мир

Показывает, что изменилось настолько резко, что заслуживает сегодняшнего уведомления. Сравнивает последние window_days с предыдущим окном как по запросам, так и по страницам, и возвращает только движения, соответствующие правилам оповещения: потерянные позиции, упавший CTR, исчезнувшие или пропавшие страницы.

Параметры

date_tostring
End date YYYY-MM-DD. Defaults to today.
no_cacheboolean
response_formatstring
tsv (default, compact) or json.
row_limitinteger
Rows returned. Default 100, capped at 1000.
site_urlstringобязательный
sc-domain:example.com for a domain property, or https://example.com/ with the trailing slash for a URL-prefix property. Call gsc_sites if unsure.
thresholdsobject | null
Override the adaptive thresholds: min_impressions, min_clicks, high_visibility_impressions, ctr_curve.
window_daysinteger
Length of the window to compare.

gsc_auditтолько чтениеидемпотентныйвнешний мир

Создаёт полный автономный HTML-аудит SEO для одного сайта. Собирает период и его базовый уровень, топ-запросы и страницы, устройства, страны, дневную динамику, историю за шесть месяцев, карты сайта и проверку индексации, затем выявляет проблемы и строит стратегию с приоритетами и дорожную карту. Пороговые значения адаптируются под размер сайта, так что небольшие сайты тоже получают отчёт. Доступен на английском и итальянском языках. Запрашивает у пользователя период, если тот не указан: значение по умолчанию в 28 дней редко подходит для клиентского отчёта. Возвращает сначала компактную сводку в JSON (KPI с дельтами, количество проблем, лучшие быстрые победы, дорожную карту), чтобы можно было обсудить результаты без чтения HTML, а затем путь к отчёту или сам документ.

Параметры

branding_pathstring
Path to a branding.json overriding colours, logo, name and thresholds.
brand_termsstring[] | null
Words that mark a query as branded. Without them the first label of the domain is used, which is often wrong.
date_fromstring
Start date YYYY-MM-DD. Overrides period and days.
date_tostring
End date YYYY-MM-DD. Defaults to today.
daysinteger | null
Rolling window length ending today.
inspect_top_pagesinteger
How many top pages to run through URL Inspection. 0 disables it.
languagestring
Report language: en, it. Defaults to en.
outputstring
file writes the report and returns its path, inline returns the HTML as an embedded resource, both does both, auto picks by transport.
output_dirstring
Where to write the report. Defaults to ~/gsc-reports/.
periodstring
Named range: last_7_days, last_28_days, last_3_months, last_month, this_month, last_16_months.
sectionsstring[] | null
Subset of sections to render: overview, issues, top_queries, top_pages, countries, sitemaps, indexing, strategy, roadmap.
site_urlstringобязательный
sc-domain:example.com for a domain property, or https://example.com/ with the trailing slash for a URL-prefix property. Call gsc_sites if unsure.
thresholdsobject | null
Override the adaptive thresholds: min_impressions, min_clicks, high_visibility_impressions, ctr_curve.

gsc_cannibalizationтолько чтениеидемпотентныйвнешний мир

Запросы, в которых несколько страниц сайта конкурируют за один и тот же результат. Читает одну страницу до 25 000 пар запрос/страница; на очень большом проекте хвост отсекается, а мета сообщает, сколько пар было проанализировано. Каждая строка перечисляет конкурирующие страницы с их собственными кликами и позициями.

Параметры

date_fromstring
Start date YYYY-MM-DD. Overrides period and days.
date_tostring
End date YYYY-MM-DD. Defaults to today.
daysinteger | null
Rolling window length ending today.
min_pagesinteger
Minimum competing pages per query.
min_sharenumber
A page must hold this share of the query's impressions to count.
no_cacheboolean
periodstring
Named range: last_7_days, last_28_days, last_3_months, last_month, this_month, last_16_months.
response_formatstring
tsv (default, compact) or json.
row_limitinteger
Rows returned. Default 100, capped at 1000.
site_urlstringобязательный
sc-domain:example.com for a domain property, or https://example.com/ with the trailing slash for a URL-prefix property. Call gsc_sites if unsure.
thresholdsobject | null
Override the adaptive thresholds: min_impressions, min_clicks, high_visibility_impressions, ctr_curve.

gsc_compare_periodsтолько чтениеидемпотентныйвнешний мир

Объединяет два периода по одному измерению и сортирует строки по дельте кликов. Отвечает на вопрос «что изменилось» без того, чтобы модель вручную сравнивала две таблицы. Строки, присутствующие только в одном периоде, сохраняются, с нулями на отсутствующей стороне; возвращаются наибольшие изменения в обоих направлениях, начиная с наихудших. Мета подсчитывает, сколько строк получили прирост кликов и сколько потеряли.

Параметры

date_fromstring
Start date YYYY-MM-DD. Overrides period and days.
date_tostring
End date YYYY-MM-DD. Defaults to today.
daysinteger | null
Rolling window length ending today.
dimensionstring
One of query, page, country, device, searchAppearance.
min_impressionsinteger
Drop rows below this impression count in both periods.
no_cacheboolean
Bypass the response cache for this call.
periodstring
Named range: last_7_days, last_28_days, last_3_months, last_month, this_month, last_16_months.
prev_date_fromstring
Baseline start YYYY-MM-DD. Defaults to the equally long period ending the day before date_from.
prev_date_tostring
Baseline end YYYY-MM-DD.
response_formatstring
tsv (default, compact) or json.
row_limitinteger
Rows returned. Default 100, capped at 1000.
site_urlstringобязательный
sc-domain:example.com for a domain property, or https://example.com/ with the trailing slash for a URL-prefix property. Call gsc_sites if unsure.

gsc_content_decayтолько чтениеидемпотентныйвнешний мир

Страницы скользят вниз месяц за месяцем. Периодическое сравнение скрывает это: страница, которая уменьшается вдвое за шесть месяцев, никогда не показывает резкого падения ни в одной помесячной проверке. Один запрос в месяц выполняется параллельно.

Параметры

consecutive_monthsinteger
Months of uninterrupted decline required.
date_tostring
End date YYYY-MM-DD. Defaults to today.
min_peak_clicksinteger
Ignore pages that never reached this many clicks in a month.
monthsinteger
How many months of history to read (2-16).
no_cacheboolean
response_formatstring
tsv (default, compact) or json.
row_limitinteger
Rows returned. Default 100, capped at 1000.
site_urlstringобязательный
sc-domain:example.com for a domain property, or https://example.com/ with the trailing slash for a URL-prefix property. Call gsc_sites if unsure.
thresholdsobject | null
Override the adaptive thresholds: min_impressions, min_clicks, high_visibility_impressions, ctr_curve.

gsc_ctr_gapsтолько чтениеидемпотентныйвнешний мир

Строки, которые хорошо ранжируются, но кликаются гораздо реже, чем предполагает их позиция. Проблема в сниппете, а не в ранжировании, что делает эти исправления самыми дешёвыми из доступных. expected_ctr — это то, что обычно получает результат на этой позиции.

Параметры

date_fromstring
Start date YYYY-MM-DD. Overrides period and days.
date_tostring
End date YYYY-MM-DD. Defaults to today.
daysinteger | null
Rolling window length ending today.
entitystring
Analyse by page (default) or by query.
gap_rationumber
Flag rows whose CTR is below this fraction of the expected CTR.
max_positionnumber
Only consider rows at or above this position.
no_cacheboolean
periodstring
Named range: last_7_days, last_28_days, last_3_months, last_month, this_month, last_16_months.
response_formatstring
tsv (default, compact) or json.
row_limitinteger
Rows returned. Default 100, capped at 1000.
site_urlstringобязательный
sc-domain:example.com for a domain property, or https://example.com/ with the trailing slash for a URL-prefix property. Call gsc_sites if unsure.
thresholdsobject | null
Override the adaptive thresholds: min_impressions, min_clicks, high_visibility_impressions, ctr_curve.

gsc_doctorтолько чтениеидемпотентныйвнешний мир

Сообщает конфигурацию сервера и то, отвечает ли Search Console. Вызывайте этот инструмент первым при сбое: он называет используемый режим аутентификации, срок действия токена, количество свойств, доступных для чтения, состояние кэша и значения по умолчанию, которые применяют все остальные инструменты. Секреты маскируются.

Параметры

Без параметров.

gsc_indexing_issuesтолько чтениеидемпотентныйвнешний мир

Проверяет, проиндексирован ли пакет URL-адресов, и если нет — почему. Запускает проверки параллельно и возвращает по одной строке на каждый входной URL в порядке ввода. URL-адрес, который не проверяется, получает столбец error вместо вердикта; остальная часть пакета всё равно возвращается. Для полной полезной нагрузки отдельной страницы (удобство для мобильных, расширенные результаты, AMP) используйте gsc_inspect_url. Квота: 600 проверок в минуту и 2 000 в день на одно свойство. Столбцы: url, verdict (PASS / PARTIAL / FAIL / NEUTRAL), coverage_state, robots_txt_state, indexing_state, page_fetch_state, crawled_as, last_crawl_time, google_canonical, user_canonical, error. В метаданных содержится сводка вердиктов.

Параметры

no_cacheboolean
Bypass the response cache for this call.
pagesstring[]обязательный
Fully qualified URLs under site_url. At most 100 per call.
response_formatstring
tsv (default, compact) or json.
site_urlstringобязательный
sc-domain:example.com for a domain property, or https://example.com/ with the trailing slash for a URL-prefix property. Call gsc_sites if unsure.

gsc_inspect_urlтолько чтениеидемпотентныйвнешний мир

Полная проверка URL для одной страницы: индексация, мобильная версия, расширенные результаты и AMP. Используйте это, когда требуется диагностика одной страницы. Для массовой проверки индексации множества URL используйте gsc_indexing_issues. Квота: 600 проверок в минуту и 2 000 в день на одно свойство.

Параметры

no_cacheboolean
Bypass the response cache for this call.
page_urlstringобязательный
Fully qualified URL under site_url.
site_urlstringобязательный
sc-domain:example.com for a domain property, or https://example.com/ with the trailing slash for a URL-prefix property. Call gsc_sites if unsure.

gsc_performance_overviewтолько чтениеидемпотентныйвнешний мир

Итоги по сайту за период, по умолчанию сравниваются с предыдущим. Начните с этого: он отвечает на вопрос «работает сайт или нет» за один вызов, с процентным изменением по каждому показателю. position_delta отрицателен, когда средняя позиция улучшается.

Параметры

compare_previousboolean
Also fetch the equally long preceding period.
data_statestring
all (default, includes today's partial data) or final.
date_fromstring
Start date YYYY-MM-DD. Overrides period and days.
date_tostring
End date YYYY-MM-DD. Defaults to today.
daysinteger | null
Rolling window length ending today.
no_cacheboolean
Bypass the response cache for this call.
periodstring
Named range: last_7_days, last_28_days, last_3_months, last_month, this_month, last_16_months.
site_urlstringобязательный
sc-domain:example.com for a domain property, or https://example.com/ with the trailing slash for a URL-prefix property. Call gsc_sites if unsure.
typestring
web, image, video, news, discover or googleNews.

gsc_portfolioтолько чтениеидемпотентныйвнешний мир

Все доступные свойства с первого взгляда, отсортированы от худшего к лучшему. Одна строка на свойство с текущим периодом, предыдущим и индикатором состояния: критический ниже -30% кликов, предупреждение ниже -15%. Используйте его, чтобы решить, на какое свойство обратить внимание перед запуском чего-либо ещё.

Параметры

date_tostring
End date YYYY-MM-DD. Defaults to today.
daysinteger | null
Rolling window length ending today.
limitinteger
How many properties to check.
no_cacheboolean
response_formatstring
tsv (default, compact) or json.

gsc_queryтолько чтениеидемпотентныйвнешний мир

Запрашивает отчет Search Analytics: клики, показы, CTR, позиция. Это инструмент общего назначения. Если не указаны даты, он охватывает последние 28 дней, заканчивающиеся сегодняшним днем (UTC), с data_state=all, поэтому сегодняшние частичные данные включены, что соответствует отображению в интерфейсе Search Console. Пример: site_url="sc-domain:example.com", dimensions="query,page", period="last_28_days", row_limit=100. Возвращает строку # meta ..., затем таблицу TSV или JSON с полями meta и rows. В meta указываются точный диапазон, количество строк, наличие дополнительных строк и start_row для следующего запроса.

Параметры

aggregation_typestring
auto, byPage or byProperty.
data_statestring
all (default, includes today's partial data) or final.
date_fromstring
Start date YYYY-MM-DD. Overrides period and days.
date_tostring
End date YYYY-MM-DD. Defaults to today.
daysinteger | null
Rolling window length ending today.
dimensionsstring
Comma-separated dimensions: query, page, country, device, date, searchAppearance, hour. hour covers only the last 10 days.
filter_group_typestring
Only and is supported by the API within one group.
filtersobject[] | null
List of {dimension, operator, expression}. Operators: equals, notEquals, contains, notContains, includingRegex, excludingRegex.
no_cacheboolean
Bypass the response cache for this call.
periodstring
Named range: last_7_days, last_28_days, last_3_months, last_month, this_month, last_16_months.
response_formatstring
tsv (default, compact) or json.
row_limitinteger
Rows returned. Default 100, capped at 1000.
site_urlstringобязательный
sc-domain:example.com for a domain property, or https://example.com/ with the trailing slash for a URL-prefix property. Call gsc_sites if unsure.
start_rowinteger
Zero-based pagination offset.
typestring
web, image, video, news, discover or googleNews.

gsc_quick_winsтолько чтениеидемпотентныйвнешний мир

Запросы, достаточно близкие к вершине, чтобы продвижение окупилось. Ранжирование по кликам, которые каждый запрос получит на позиции target_position, а не по показам: большой запрос, уже близкий к своему потолку, не является возможностью. Мета-отчёт сообщает о применённых пороговых значениях.

Параметры

date_fromstring
Start date YYYY-MM-DD. Overrides period and days.
date_tostring
End date YYYY-MM-DD. Defaults to today.
daysinteger | null
Rolling window length ending today.
max_positionnumber
Ignore queries below this position.
min_positionnumber
Ignore queries above this position.
no_cacheboolean
periodstring
Named range: last_7_days, last_28_days, last_3_months, last_month, this_month, last_16_months.
response_formatstring
tsv (default, compact) or json.
row_limitinteger
Rows returned. Default 100, capped at 1000.
site_urlstringобязательный
sc-domain:example.com for a domain property, or https://example.com/ with the trailing slash for a URL-prefix property. Call gsc_sites if unsure.
target_positioninteger
Position to size the opportunity against.
thresholdsobject | null
Override the adaptive thresholds: min_impressions, min_clicks, high_visibility_impressions, ctr_curve.

gsc_site_detailsтолько чтениеидемпотентныйвнешний мир

Уровень разрешений и тип свойства для одного свойства.

Параметры

no_cacheboolean
Bypass the response cache for this call.
response_formatstring
tsv (default, compact) or json.
site_urlstringобязательный
sc-domain:example.com for a domain property, or https://example.com/ with the trailing slash for a URL-prefix property. Call gsc_sites if unsure.

gsc_sitemapsтолько чтениеидемпотентныйвнешний мир

Перечисляет карты сайта, о которых Google знает для вашего ресурса, с ошибками и предупреждениями. Только чтение: отправка или удаление карты сайта требует область read-write, которую этот сервер никогда не запрашивает. Возвращает одну строку на карту сайта: путь, временные метки последней отправки и загрузки, флаг ожидания, флаг индекса, количество предупреждений и ошибок, а также количество отправленных/проиндексированных URL-адресов, когда Google сообщает их.

Параметры

no_cacheboolean
Bypass the response cache for this call.
response_formatstring
tsv (default, compact) or json.
site_urlstringобязательный
sc-domain:example.com for a domain property, or https://example.com/ with the trailing slash for a URL-prefix property. Call gsc_sites if unsure.

gsc_sitesтолько чтениеидемпотентныйвнешний мир

Перечислите все ресурсы, которые может просматривать аутентифицированная учётная запись. Вызывайте этот инструмент первым, когда строка ресурса не срабатывает: возвращает точные значения site_url, которые ожидают другие инструменты, и показывает, доменный это ресурс (sc-domain:example.com) или ресурс с префиксом URL.

Параметры

no_cacheboolean
Bypass the response cache for this call.
response_formatstring
tsv (default, compact) or json.

gsc_traffic_dropsтолько чтениеидемпотентныйвнешний мир

Страницы, потерявшие клики относительно базового показателя, каждая с вероятной причиной. diagnosis разделяет потерю ранжирования, падение спроса, снижение CTR и страницу, которая исчезла: эти четыре проблемы требуют разных исправлений, и сырые числа для обоих периодов находятся в строке, чтобы вызов можно было проверить.

Параметры

date_fromstring
Start date YYYY-MM-DD. Overrides period and days.
date_tostring
End date YYYY-MM-DD. Defaults to today.
daysinteger | null
Rolling window length ending today.
min_drop_pctnumber
Minimum click loss, in percent.
no_cacheboolean
periodstring
Named range: last_7_days, last_28_days, last_3_months, last_month, this_month, last_16_months.
response_formatstring
tsv (default, compact) or json.
row_limitinteger
Rows returned. Default 100, capped at 1000.
site_urlstringобязательный
sc-domain:example.com for a domain property, or https://example.com/ with the trailing slash for a URL-prefix property. Call gsc_sites if unsure.
thresholdsobject | null
Override the adaptive thresholds: min_impressions, min_clicks, high_visibility_impressions, ctr_curve.

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "uvx",
  "args": [
    "mcp-google-search-console"
  ]
}

Нужен uvx

Сервер запускается через uvx
Без него ничего работать не будет.

Как установить uvx

Информация о сервере

Номер в рейтинге: #198
Звезд на Github: 8
Форков на Github: 2
Загрузок: 4 008
Язык реализации: Python
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 09.09 в 01:01
Идентификатор: ldT3xCIepFIp8tkx
Категории: Визуализация данных, Инструменты для разработчиков, Исследования и данные, Маркетинг, Поиск