yandex-webmaster-mcp

MCP server for Yandex Webmaster API — site analytics, indexing status, search queries, and SEO diagnostics.


English | Русский

---

English

$3

| Tool | Description |
|------|-------------|
| get-user | Get authenticated user ID |
| list-hosts | List all sites in Webmaster |
| get-host | Get site information and status |
| get-summary | Site statistics (SQI, indexed pages, problems) |
| get-sqi-history | Site Quality Index history |
| get-diagnostics | Site health diagnostics |
| get-popular-queries | Popular search queries (shows, clicks, positions) |
| get-query-history | Aggregated query statistics over time |
| get-indexing-history | Pages downloaded by robot (by HTTP status) |
| get-indexing-samples | Examples of downloaded pages |
| get-insearch-history | Pages in search results over time |
| get-insearch-samples | Examples of pages in search |
| get-search-events-history | Pages added/removed from search |
| get-search-events-samples | Examples of search events |
| get-external-links | Backlinks pointing to the site |
| get-external-links-history | Backlinks count over time |
| get-broken-internal-links | Broken internal links |
| get-broken-internal-links-history | Broken links count over time |
| get-sitemaps | Auto-detected sitemap files |
| get-sitemap | Specific sitemap details |
| get-user-sitemaps | User-added sitemaps |
| get-important-urls | Monitored important pages |
| get-important-url-history | Important page change history |
| get-recrawl-quota | Reindexing quota status |

$3

#### Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

``json
{
"mcpServers": {
"yandex-webmaster": {
"command": "npx",
"args": ["-y", "yandex-webmaster-mcp"],
"env": {
"YANDEX_WEBMASTER_TOKEN": "your_oauth_token"
}
}
}
}
`

$3

Follow the official Yandex Webmaster OAuth guide or these steps:

#### Step 1: Create an OAuth Application

1. Go to Yandex OAuth app registration
2. Create an application:
- Select platform: Web services (Веб-сервисы)
- Set Redirect URI to: https://oauth.yandex.ru/verification_code
- Under "Data access", enable these scopes:
- webmaster:hostinfo — access to site statistics
- webmaster:verify — access to site verification
3. Save the application and copy your ClientID (and Client secret for auth command)

#### Step 2: Get a Token

Option A: Using the auth command

`bash
export YANDEX_CLIENT_ID=your_client_id
export YANDEX_CLIENT_SECRET=your_client_secret

npx yandex-webmaster-mcp auth
`

Option B: Manual token retrieval

Open this URL in your browser (replace with your actual ID):
`
https://oauth.yandex.ru/authorize?response_type=token&client_id=
`
Authorize and copy the token from the resulting page.

#### Step 3: Configure

Set the token as YANDEX_WEBMASTER_TOKEN environment variable.

> Note: Tokens are valid for 6 months. Repeat Step 2 to get a new token when it expires.

$3

List your sites:
`
"Show me all my sites in Yandex Webmaster"
`

Get site statistics:
`
"What's the SQI and indexing status for example.com?"
`

Analyze search queries:
`
"What are the top search queries bringing traffic to my site?"
`

Check backlinks:
`
"Show me external links pointing to my site"
`

Site diagnostics:
`
"Are there any SEO problems detected for my site?"
`

---

Русский

$3

| Инструмент | Описание |
|------------|----------|
| get-user | Получить ID пользователя |
| list-hosts | Список всех сайтов в Вебмастере |
| get-host | Информация о сайте |
| get-summary | Статистика сайта (ИКС, индексация, проблемы) |
| get-sqi-history | История изменения ИКС |
| get-diagnostics | Диагностика проблем сайта |
| get-popular-queries | Популярные поисковые запросы |
| get-query-history | История статистики запросов |
| get-indexing-history | История загрузки страниц роботом |
| get-indexing-samples | Примеры загруженных страниц |
| get-insearch-history | История страниц в поиске |
| get-insearch-samples | Примеры страниц в поиске |
| get-search-events-history | История добавления/удаления из поиска |
| get-search-events-samples | Примеры изменений в поиске |
| get-external-links | Внешние ссылки на сайт |
| get-external-links-history | История количества внешних ссылок |
| get-broken-internal-links | Битые внутренние ссылки |
| get-broken-internal-links-history | История битых ссылок |
| get-sitemaps | Обнаруженные файлы Sitemap |
| get-sitemap | Детали конкретного Sitemap |
| get-user-sitemaps | Добавленные пользователем Sitemap |
| get-important-urls | Мониторинг важных страниц |
| get-important-url-history | История изменений важных страниц |
| get-recrawl-quota | Квота на переобход |

$3

#### Claude Desktop

Добавьте в конфигурацию Claude Desktop:

`json
{
"mcpServers": {
"yandex-webmaster": {
"command": "npx",
"args": ["-y", "yandex-webmaster-mcp"],
"env": {
"YANDEX_WEBMASTER_TOKEN": "ваш_oauth_токен"
}
}
}
}
`

$3

Следуйте официальной инструкции Яндекса или этим шагам:

#### Шаг 1: Создание OAuth-приложения

1. Перейдите на страницу регистрации приложения
2. Создайте приложение:
- Выберите платформу: Веб-сервисы
- Укажите Redirect URI: https://oauth.yandex.ru/verification_code
- В разделе "Доступ к данным" включите:
- webmaster:hostinfo — доступ к статистике сайтов
- webmaster:verify — доступ к верификации сайтов
3. Сохраните приложение и скопируйте ClientID (и Client secret для команды auth)

#### Шаг 2: Получение токена

Вариант А: Через команду auth

`bash
export YANDEX_CLIENT_ID=your_client_id
export YANDEX_CLIENT_SECRET=your_client_secret

npx yandex-webmaster-mcp auth
`

Вариант Б: Вручную

Откройте в браузере (замените на ваш ID):
`
https://oauth.yandex.ru/authorize?response_type=token&client_id=
`
Авторизуйтесь и скопируйте токен со страницы результата.

#### Шаг 3: Настройка

Установите токен в переменную окружения YANDEX_WEBMASTER_TOKEN.

> Примечание: Токен действителен 6 месяцев. Для получения нового повторите шаг 2.

$3

Список сайтов:
`
"Покажи все мои сайты в Яндекс.Вебмастере"
`

Статистика сайта:
`
"Какой ИКС и статус индексации у example.com?"
`

Анализ запросов:
`
"Какие поисковые запросы приводят трафик на мой сайт?"
`

Проверка ссылок:
`
"Покажи внешние ссылки на мой сайт"
`

Диагностика:
`
"Есть ли какие-то SEO проблемы на моем сайте?"
``

---

License

MIT