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
Скачайте архив
Все три сервера одним архивом или каждый отдельно — они независимы.
- 2
Поставьте зависимости
В папке сервера: python -m venv .venv и pip install -r requirements.txt.
- 3
Впишите свой ключ
Переименуйте .env.example в .env и вставьте OAuth-токен Яндекса; для Google положите credentials.json и запустите auth_setup.py.
- 4
Подключите к агенту
Одна команда для Claude Code или блок настроек для Claude Desktop и Cursor.
- 5
Задайте вопрос
Например: «Сделай сводку по example.ru: ИКС и проблемы из Вебмастера, трафик из Метрики, топ запросов из Search Console».
Три сервера
| Сервер | Что умеет | Ключ |
|---|---|---|
| Яндекс Вебмастер | сайты, ИКС и проблемы, популярные запросы с позициями, история обхода | OAuth-токен Яндекса |
| Яндекс Метрика | любой отчёт: источники, страницы входа, устройства, регионы, цели, UTM | OAuth-токен Яндекса |
| 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.txtpython3 -m venv .venv
.venv/bin/pip install -r requirements.txt4. Ключи. Подробно — на странице каждого сервера:
- Вебмастер и Метрика — один 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.
Claude Desktop: Settings → Developer → Edit Config. Cursor: Settings → MCP или файл ~/.cursor/mcp.json. Слеши — прямые.
{
"mcpServers": {
"yandex-webmaster": {
"command": "C:/mcp/seo-mcp-servers/yandex-webmaster-mcp/.venv/Scripts/python.exe",
"args": ["C:/mcp/seo-mcp-servers/yandex-webmaster-mcp/server.py"]
},
"yandex-metrika": {
"command": "C:/mcp/seo-mcp-servers/yandex-metrika-mcp/.venv/Scripts/python.exe",
"args": ["C:/mcp/seo-mcp-servers/yandex-metrika-mcp/server.py"]
},
"google-search-console": {
"command": "C:/mcp/seo-mcp-servers/google-search-console-mcp/.venv/Scripts/python.exe",
"args": ["C:/mcp/seo-mcp-servers/google-search-console-mcp/server.py"]
}
}
}Если в файле уже есть другие серверы, добавьте эти три внутрь блока "mcpServers". Claude Desktop перезапустите полностью — через значок в трее.
В путях вместо .venv/Scripts/python.exe — .venv/bin/python, например:
claude mcp add yandex-webmaster --scope user -- ~/mcp/seo-mcp-servers/yandex-webmaster-mcp/.venv/bin/python ~/mcp/seo-mcp-servers/yandex-webmaster-mcp/server.pyНазвания пунктов меню у клиентов меняются — сверяйтесь с их документацией.
Частые проблемы
| Ошибка | Что делать |
|---|---|
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 работает на нашем сервере и отдаёт нашу базу доноров. Эти три сервера работают у вас и отдают данные ваших сайтов по вашему ключу.