Skip to main content
Glama
deenesjakoruzh
GiorgiKemo

mcp-seo-audit

by GiorgiKemo
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

mcp-seo-audit

Сервер протокола Model Context Protocol (MCP) для SEO-аудита, включающий Google Search Console, Indexing API, отчет Chrome UX, PageSpeed Insights, локальный Lighthouse, проверку robots.txt, анализ карты сайта, проверку SEO на странице, аудит сканирования и анализ сайта в реальном времени. Работает с Claude Code, Claude Desktop, Cursor и любым клиентом, поддерживающим MCP.

Форк AminForou/mcp-gsc, расширенный до более масштабного сервера для технического SEO и аудита производительности, включающий 30 инструментов и полный набор тестов.

Возможности

Категория

Инструменты

Описание

Управление ресурсами

list_properties, add_site, delete_site

Список, добавление и удаление ресурсов GSC

Аналитика поиска

get_search_analytics, get_advanced_search_analytics, get_performance_overview, get_search_by_page_query, compare_search_periods

Запрос кликов, показов, CTR, позиций с фильтрацией, измерениями и сравнением периодов

Проверка URL

inspect_url, batch_inspect_urls

Проверка статуса индексации, информации о сканировании, канонических ссылок, robots для одного или нескольких URL

Indexing API

request_indexing, request_removal, check_indexing_notification, batch_request_indexing

Отправка/удаление URL из индекса Google через Indexing API

Карты сайта

get_sitemaps, submit_sitemap, delete_sitemap

Список, отправка и удаление карт сайта

Core Web Vitals

get_core_web_vitals

LCP, FID, CLS, INP, TTFB через API отчета Chrome UX (CrUX)

Аудит производительности

get_pagespeed_insights, run_lighthouse_audit

Запуск PageSpeed Insights и локальных аудитов Lighthouse с оценками категорий и сводками ошибок

Техническое SEO

inspect_robots_txt, analyze_sitemap, analyze_page_seo, crawl_site_seo, audit_live_site

Проверка robots.txt, валидация карт сайта, извлечение SEO-сигналов со страницы, сканирование внутренних страниц и запуск SEO-аудита в реальном времени без доступа к GSC

SEO-анализ

find_striking_distance_keywords, detect_cannibalization, split_branded_queries

Поиск ключевых слов на позициях 5-20, обнаружение страниц, конкурирующих по одному запросу, разделение брендового и небрендового трафика

Аудит сайта

site_audit

Комплексный отчет: состояние карты сайта, статус индексации, несоответствия канонических ссылок, сводка производительности

Авторизация

reauthenticate

Смена аккаунтов Google путем очистки кэшированных токенов OAuth

Всего 30 инструментов.

Настройка

1. Учетные данные Google API

OAuth (рекомендуется)

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

  2. Включите Search Console API и Web Search Indexing API

  3. Создайте OAuth 2.0 Client ID (для настольного приложения)

  4. Скачайте client_secrets.json

Сервисный аккаунт

  1. Создайте сервисный аккаунт в Google Cloud Console

  2. Скачайте файл JSON-ключа

  3. Добавьте email сервисного аккаунта в свои ресурсы GSC

2. Установка

git clone https://github.com/GiorgiKemo/mcp-seo-audit.git
cd mcp-seo-audit
python -m venv .venv

# Activate:
# macOS/Linux: source .venv/bin/activate
# Windows:     .venv\Scripts\activate

pip install -r requirements.txt

3. Настройка MCP-клиента

Claude Code (~/.claude/settings.json)

{
  "mcpServers": {
    "seo-audit": {
      "command": "/path/to/mcp-seo-audit/.venv/bin/python",
      "args": ["/path/to/mcp-seo-audit/gsc_server.py"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/path/to/client_secrets.json",
        "PAGESPEED_API_KEY": "your-google-api-key",
        "CRUX_API_KEY": "your-google-api-key"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json)

Та же структура JSON — см. документацию Claude Desktop MCP для поиска расположения файла конфигурации.

4. Опционально: API-ключи для производительности

Для получения данных о производительности (полевых и лабораторных) установите CRUX_API_KEY и PAGESPEED_API_KEY в блоке env:

"env": {
  "GSC_OAUTH_CLIENT_SECRETS_FILE": "/path/to/client_secrets.json",
  "CRUX_API_KEY": "your-google-api-key",
  "PAGESPEED_API_KEY": "your-google-api-key"
}

Вы также можете установить GOOGLE_API_KEY; сервер использует его как резервный ключ для PageSpeed Insights.

Переменные окружения

Переменная

Обязательно

По умолчанию

Описание

GSC_OAUTH_CLIENT_SECRETS_FILE

OAuth

client_secrets.json

Путь к секретам OAuth-клиента

GSC_CREDENTIALS_PATH

Сервисный аккаунт

service_account_credentials.json

Путь к ключу сервисного аккаунта

GSC_SKIP_OAUTH

Нет

false

Установите true, чтобы пропустить OAuth и использовать только сервисный аккаунт

GSC_DATA_STATE

Нет

all

all = свежие данные, соответствующие панели GSC, final = подтвержденные данные (задержка 2-3 дня)

CRUX_API_KEY

Нет

нет

API-ключ Google для Core Web Vitals (CrUX)

PAGESPEED_API_KEY

Нет

нет

API-ключ Google для вызовов PageSpeed Insights / Lighthouse API

GOOGLE_API_KEY

Нет

нет

Резервный источник для PAGESPEED_API_KEY

LIGHTHOUSE_CHROME_PATH

Нет

автоопределение

Опциональный явный путь к Chrome/Chromium для локального Lighthouse CLI

Примеры запросов

"List my GSC properties"
"Show search analytics for cdljobscenter.com last 28 days"
"Find striking distance keywords for my site"
"Detect keyword cannibalization"
"Run a full site audit"
"Check Core Web Vitals for cdljobscenter.com"
"Run PageSpeed Insights for https://example.com"
"Run a local Lighthouse audit for https://example.com"
"Inspect robots.txt for https://example.com"
"Analyze https://example.com/sitemap.xml"
"Analyze on-page SEO for https://example.com/jobs"
"Crawl https://example.com and report duplicate titles"
"Run a live SEO audit for https://example.com"
"Inspect indexing status of these URLs: /jobs, /companies, /pricing"
"Request indexing for https://mysite.com/new-page"
"Compare search performance this month vs last month"

Тесты

81 тест, охватывающий все 30 инструментов с использованием моков для вызовов Google/API/web-audit:

# Activate venv first
python -m pytest test_gsc_server.py -v

Что изменилось по сравнению с оригиналом

  • 30 инструментов — добавлены PSI, локальный Lighthouse, проверка robots.txt, валидация карт сайта, анализ SEO страниц, аудит сканирования и аудит сайта в реальном времени

  • 7 исправлений ошибок — сопоставление направления сортировки, определение origin/URL, сбой при пустых строках, утечка API-ключа, блокировка sleep, кэширование сервисов, устаревший кэш при повторной аутентификации

  • Набор QA из 81 теста — покрытие для GSC, CrUX, PSI, Lighthouse CLI, robots, карт сайта, аудита сканирования и композиции аудита в реальном времени

  • Безопасность — API-ключи удалены из сообщений об ошибках

  • Производительность — объекты сервиса Google API кэшируются, используется асинхронный sleep вместо блокирующего, плюс инструменты лабораторной производительности поверх полевых данных CrUX

Лицензия

MIT. См. LICENSE.

Основано на AminForou/mcp-gsc.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
B
quality - B tier

How are these scores calculated?

Resources

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/GiorgiKemo/mcp-seo-audit'

If you have feedback or need assistance with the MCP directory API, please join our Discord server