YWM MCP — Яндекс.Вебмастер для Claude

MCP-сервер и CLI-выгрузчик в одном файле. Парный к gsc-mcp: те же имена CSV, та же структура summary.md, те же названия метрик — чтобы выгрузки Яндекса и Google можно было положить рядом.

Главное, ради чего он существует: API Search Console не отдаёт внешние ссылки, отчёт по ссылкам живёт только в интерфейсе. API Вебмастера отдаёт — и список доноров, и историю изменения их количества. То есть текущий ссылочный профиль сайта вы получаете бесплатно, без подписки на Ahrefs.

Два режима:

• CLI — запустили, получили папку CSV + summary.md.

• MCP — подключается к Claude Desktop, данные запрашиваются прямо в чате.

1. Установка

pip install -r requirements.txt

Python 3.10+. Из зависимостей только mcp — HTTP на стандартной библиотеке. Если нужен исключительно CLI, можно вообще ничего не ставить.

Related MCP server: marketscore-seo-mcp

2. Токен

Никаких сервисных аккаунтов и облачных проектов, в отличие от Google.

1. Откройте oauth.yandex.ru/client/new.

2. Название приложения — любое, например ywm-export.

3. Платформа: Веб-сервисы. Redirect URI: https://oauth.yandex.ru/verification_code

4. Доступы: найдите Яндекс.Вебмастер и отметьте «Получение информации о сайтах пользователя» (webmaster:hostinfo).

5. Создайте приложение и скопируйте ClientID.

6. Откройте в браузере, подставив свой ClientID:

   https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENT_ID

7. Нажмите «Разрешить» — токен появится прямо на странице.

Сохраните его:

# Linux / WSL / macOS
export YWM_TOKEN="<ВАШ_ТОКЕН>"

# или в файл, чтобы не светить в истории команд
echo "<ВАШ_ТОКЕН>" > ~/.ywm_token && chmod 600 ~/.ywm_token
export YWM_TOKEN_FILE=~/.ywm_token

# Windows, навсегда
setx YWM_TOKEN "<ВАШ_ТОКЕН>"

Токен даёт доступ ко всем сайтам аккаунта. Держите его вне общих папок и вне репозиториев — по нему видно всё, что видно в Вебмастере.

3. Проверка и выгрузка

python3 ywm_mcp.py list

Выведет подтверждённые сайты и их host_id. Пусто — значит сайт не подтверждён в Вебмастере под этим аккаунтом.

python3 ywm_mcp.py export \
  --host "example.com" \
  --days 90 \
  --out "~/seo-exports/ywm_export" \
  --brand "example.com,бренд,brand name"

--host принимает и голый домен, и полный URL, и host_id — скрипт сам разберётся.

Что появится в папке

CSV в UTF-8 с BOM — Excel открывает кириллицу корректно.

Точечные команды без полной выгрузки:

python3 ywm_mcp.py links   --host example.com --out ./links
python3 ywm_mcp.py queries --host example.com --days 180 --limit 100

4. Подключение к Claude Desktop

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "python",
      "args": ["D:\\projects\\ywm-mcp\\ywm_mcp.py"],
      "env": {
        "YWM_TOKEN": "y0_ВАШ_ТОКЕН",
        "YWM_OUT_DIR": "D:\\projects\\ywm_export"
      }
    }
  }
}

Если сервер запускается из WSL, а Claude Desktop стоит на Windows:

{
  "command": "wsl.exe",
  "args": ["-e", "python3", "/home/USER/ywm-mcp/ywm_mcp.py"]
}

5. Инструменты MCP

Примеры формулировок:

Покажи доноров example.com — есть ли среди них мусорные Найди запросы на позициях 5–20 в Яндексе Сравни динамику ссылок за полгода — были ли резкие скачки

6. Что важно знать про данные

Показы Яндекса и показы Google — разные величины. Методики подсчёта не совпадают. Сравнивайте динамику внутри каждой системы и структуру спроса, но не складывайте абсолютные числа и не делите одно на другое.

Позиция показа и позиция клика — разные метрики. Яндекс отдаёт обе. AVG_SHOW_POSITION сопоставима с «средней позицией» Google; AVG_CLICK_POSITION показывает, с какой позиции реально кликают, и обычно она заметно выше.

Ссылки — это выборка. Вебмастер отдаёт count (сколько всего знает) и примеры постранично. Скрипт по умолчанию тянет до 5000 ссылок и честно пишет в summary.md, если упёрся в лимит. Поднять — флагом --max-links.

Глубина истории по запросам ограничена. Если API вернёт ошибку на длинном периоде, уменьшите --days.

Ни один эндпоинт не роняет выгрузку. Если что-то недоступно по правам или данных ещё нет, соответствующий CSV будет пустым, а причина попадёт в раздел «Не удалось получить» в summary.md. Тихих провалов нет.

7. Если что-то не работает

8. Самопроверка

_selftest.py прогоняет весь код против поддельного API — без сети и без токена. Проверяет пагинацию, лимиты, агрегацию доноров, разбор истории и то, что выгрузка переживает отказ отдельного эндпоинта.

python3 _selftest.py