Telegram Обсудить проект
MCP · бесплатно · только чтение

MCP-серверы для SEO

Три MCP-сервера подключают Яндекс Вебмастер, Яндекс Метрику и Google Search Console к Claude, Cursor и другим ИИ-агентам. Вы спрашиваете обычными словами — агент сам выгружает запросы, трафик и индексацию и сводит их.

Версия 1.0.0 · Python 3.10+ · лицензия MIT

Коротко

MCP-серверы SEO Drift — три маленькие программы на Python, которые подключают Яндекс Вебмастер, Яндекс Метрику и Google Search Console к ИИ-агенту: Claude Code, Claude Desktop, Cursor и любому клиенту MCP. Агент сам ходит в API сервисов и отвечает на вопросы вроде «какие запросы дают показы, но почти нет кликов».

Серверы работают на вашем компьютере и только читают данные. Ключ — ваш собственный: OAuth-токен Яндекса и клиент OAuth Google. Он лежит в папке сервера и уходит только в официальные API Яндекса и Google. Установка — около 15 минут.

Как начать

Понадобится: Python 3.10 или новее; клиент MCP — Claude Code, Claude Desktop, Cursor или другой; доступ к сайтам в Вебмастере, Метрике или Search Console.

  1. 1

    Скачайте архив

    Все три сервера одним архивом или каждый отдельно — они независимы.

  2. 2

    Поставьте зависимости

    В папке сервера: python -m venv .venv и pip install -r requirements.txt.

  3. 3

    Впишите свой ключ

    Переименуйте .env.example в .env и вставьте OAuth-токен Яндекса; для Google положите credentials.json и запустите auth_setup.py.

  4. 4

    Подключите к агенту

    Одна команда для Claude Code или блок настроек для Claude Desktop и Cursor.

  5. 5

    Задайте вопрос

    Например: «Сделай сводку по example.ru: ИКС и проблемы из Вебмастера, трафик из Метрики, топ запросов из Search Console».

Три сервера

СерверЧто умеетКлюч
Яндекс Вебмастерсайты, ИКС и проблемы, популярные запросы с позициями, история обходаOAuth-токен Яндекса
Яндекс Метрикалюбой отчёт: источники, страницы входа, устройства, регионы, цели, UTMOAuth-токен Яндекса
Google Search Consoleзапросы, страницы, CTR и позиции, файлы Sitemap, проверка индексации URLклиент OAuth Google

Скачать по отдельности: yandex-webmaster-mcp.zip · yandex-metrika-mcp.zip · google-search-console-mcp.zip. Каждый сервер — один файл server.py без лишних зависимостей: код можно прочитать перед установкой.

Что спрашивать: готовые вопросы

  • Сводка по сайту. «Сделай сводку по example.ru: ИКС и проблемы из Вебмастера, трафик за 30 дней по дням из Метрики, топ-20 запросов из Search Console. Что бросается в глаза?»
  • Точки роста. «Найди запросы, где в Яндексе и Google позиция 4–15 и много показов. Сгруппируй по страницам — какие дотягивать первыми?»
  • Разбор просадки. «Трафик из поиска упал в октябре. Сравни с сентябрём по Метрике (источники и страницы входа), по Вебмастеру (запросы и индексация) и по Search Console. Где просело и почему?»
  • Аудит CTR. «Какие запросы дают много показов, но CTR ниже 2 %? Предложи новые title и description для этих страниц».
  • Индексация. «Проверь в Search Console, в индексе ли эти 10 адресов и какой канонический выбрал Google».
  • Переходы из нейросетей. «Сколько визитов за месяц пришло с chatgpt.com, perplexity.ai и gemini.google.com и на какие страницы?» Как это считать вручную — в инструменте «Переходы из нейросетей».

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

1. Python. Нужен Python 3.10 или новее — python.org/downloads. На Windows при установке отметьте Add python.exe to PATH.

2. Архив. Распакуйте его, например, в C:\mcp. Откройте папку сервера, в адресной строке Проводника наберите powershell и нажмите Enter — терминал откроется в этой папке.

3. Зависимости. В папке каждого сервера:

python -m venv .venv
.venv\Scripts\pip install -r requirements.txt

4. Ключи. Подробно — на странице каждого сервера:

  • Вебмастер и Метрика — один OAuth-токен Яндекса с правами webmaster:hostinfo и metrika:read. Как получить — шаг 2 в статье про API Вебмастера. Переименуйте .env.example в .env и впишите YANDEX_OAUTH_TOKEN=….
  • Search Console — свой клиент OAuth Google типа Desktop app, пошагово в статье про Search Console API. Файл положите в папку сервера как credentials.json и один раз запустите auth_setup.py.

5. Подключение к агенту. Пути замените на свои.

claude mcp add yandex-webmaster --scope user -- "C:\mcp\seo-mcp-servers\yandex-webmaster-mcp\.venv\Scripts\python.exe" "C:\mcp\seo-mcp-servers\yandex-webmaster-mcp\server.py"
claude mcp add yandex-metrika --scope user -- "C:\mcp\seo-mcp-servers\yandex-metrika-mcp\.venv\Scripts\python.exe" "C:\mcp\seo-mcp-servers\yandex-metrika-mcp\server.py"
claude mcp add google-search-console --scope user -- "C:\mcp\seo-mcp-servers\google-search-console-mcp\.venv\Scripts\python.exe" "C:\mcp\seo-mcp-servers\google-search-console-mcp\server.py"

Проверка: claude mcp list — у всех трёх статус Connected.

Названия пунктов меню у клиентов меняются — сверяйтесь с их документацией.

Частые проблемы

ОшибкаЧто делать
YANDEX_OAUTH_TOKEN не заданнет файла .env (а не .env.example) или токен не вставлен
401 от Яндексатокен истёк (живёт 6 месяцев) — получите новый
403 от Яндексау приложения нет нужного права: webmaster:hostinfo или metrika:read
access_denied в Googleприложение Google в статусе Testing — опубликуйте его
invalid_grant в Googleудалите gsc_token.json и снова запустите auth_setup.py
Сервера нет в агентеневерный путь. Проверьте вручную: .venv\Scripts\python server.py должен молча «зависнуть» — это норма, выход Ctrl+C

Безопасность

  • Все инструменты только читают данные.
  • Токены лежат в папке сервера на вашем компьютере. Никому не пересылайте .env, credentials.json и gsc_token.json.
  • Если токен Яндекса от агентского аккаунта со множеством сайтов, ограничьте доступ агента нужными: WEBMASTER_ALLOWED_HOSTS, METRIKA_ALLOWED_COUNTERS, GSC_ALLOWED_SITES в .env.
  • Отозвать доступ: Яндекс — удалите своё приложение на oauth.yandex.ru или отзовите доступ в Яндекс ID; Google — myaccount.google.com/permissions.

Вопросы и сообщения об ошибках — в Telegram-канал @seo_drift.

Чего не умеет

  • Серверы только читают данные — переобход, добавление сайтов и правки в кабинетах они не делают.
  • Нужен Python и немного работы в терминале. Сервер работает, пока открыт ваш агент.
  • Токен Яндекса живёт 6 месяцев — потом его нужно получить заново.

Какие данные собирает

Серверы работают у вас на компьютере. Токены и ключи лежат в папке сервера и уходят только в официальные API Яндекса и Google. SEO Drift их не видит и не хранит: ни ключей, ни данных ваших сайтов.

Вопросы и ответы

Что такое MCP-сервер для SEO?

MCP-сервер для SEO — маленькая программа, через которую ИИ-агент получает данные SEO-сервисов: Вебмастера, Метрики, Search Console. Агент сам вызывает нужный отчёт, а вы спрашиваете обычными словами. Подробно о самой технологии — в словаре: MCP-сервер.

Это бесплатно?

Да, серверы бесплатные, с открытым кодом под лицензией MIT. API Вебмастера, Метрики и Search Console тоже бесплатны. Платить можно только за подписку на сам ИИ-агент.

Можно поставить только один сервер?

Да, серверы независимы: ставьте только нужные. Для Вебмастера и Метрики подходит один и тот же OAuth-токен Яндекса.

С какими агентами работает?

С любым клиентом MCP, который запускает локальные серверы: Claude Code, Claude Desktop, Cursor, Windsurf, Cline и другие. Готовые настройки — для первых трёх.

Могут ли серверы что-то сломать в кабинете?

Нет. Все инструменты только читают данные; права на запись серверы не запрашивают.

Чем это отличается от Drift Donors MCP?

Drift Donors MCP работает на нашем сервере и отдаёт нашу базу доноров. Эти три сервера работают у вас и отдают данные ваших сайтов по вашему ключу.

Читать дальше по теме

Другие инструменты

Все инструменты →