# Yandex Webmaster Mcp

> MCP server for Yandex Webmaster — SEO, indexing, search queries (Russia). Part of WWmcp — 114 MCP servers for emerging markets.

- **Type:** MCP server
- **Install:** `agentstack add mcp-theyahia-yandex-webmaster-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [theYahia](https://agentstack.voostack.com/s/theyahia)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [theYahia](https://github.com/theYahia)
- **Source:** https://github.com/theYahia/yandex-webmaster-mcp

## Install

```sh
agentstack add mcp-theyahia-yandex-webmaster-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# @theyahia/yandex-webmaster-mcp

MCP-сервер для API Яндекс.Вебмастер — сайты, индексация, поисковые запросы, sitemaps,
диагностика и переобход. 13 инструментов, вывод в компактном Markdown (или сыром JSON).

[](https://www.npmjs.com/package/@theyahia/yandex-webmaster-mcp)
[](https://opensource.org/licenses/MIT)

## Установка

### Claude Desktop

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

### Claude Code

```bash
claude mcp add yandex-webmaster -e YANDEX_WEBMASTER_TOKEN=ваш_oauth_токен -- npx -y @theyahia/yandex-webmaster-mcp
```

## Авторизация

Нужен только **`YANDEX_WEBMASTER_TOKEN`** — OAuth-токен с правом `webmaster:api`.
`user_id` определяется автоматически через `GET /user/`, задавать его руками не нужно.

Как получить токен:

1. Создайте приложение на  и выдайте ему право
   **Яндекс.Вебмастер (`webmaster:api`)**.
2. Получите OAuth-токен по
   [инструкции Яндекса](https://yandex.ru/dev/id/doc/ru/access) и положите его в
   `YANDEX_WEBMASTER_TOKEN`.

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

| Переменная                 | Обяз. | Назначение                                                               |
| -------------------------- | :---: | ------------------------------------------------------------------------ |
| `YANDEX_WEBMASTER_TOKEN`   |  да   | OAuth-токен с правом `webmaster:api`                                     |
| `YANDEX_WEBMASTER_USER_ID` |  нет  | Числовой user ID. Если не задан — определяется автоматически             |
| `PORT`                     |  нет  | Порт HTTP-режима (по умолчанию `3100`)                                   |
| `MCP_ALLOWED_HOSTS`        |  нет  | Разрешённые Host для HTTP (CSV). `*` — отключить защиту от DNS-rebinding |
| `MCP_HTTP_AUTH_TOKEN`      |  нет  | Если задан — требует `Authorization: Bearer ` на `POST /mcp`      |

## Инструменты (13)

| Инструмент                   | Описание                                                               |
| ---------------------------- | ---------------------------------------------------------------------- |
| `get_hosts`                  | Список сайтов: URL, статус подтверждения                               |
| `get_user_info`              | Данные аккаунта (user_id)                                              |
| `get_popular_search_queries` | Поисковые запросы по сайту: показы, клики, средняя позиция (per-query) |
| `get_query_analytics`        | Агрегированный тренд трафика во времени (НЕ per-query)                 |
| `get_search_queries`         | ⚠️ deprecated — алиас `get_popular_search_queries`                     |
| `get_indexing`               | Сводка индексации сайта                                                |
| `get_indexing_history`       | Тренд проиндексированных/исключённых страниц                           |
| `submit_url`                 | Отправить URL на переобход (расходует дневную квоту)                   |
| `get_recrawl_quota`          | Остаток дневной квоты переобхода                                       |
| `get_recrawl_task`           | Статус задачи переобхода по `task_id`                                  |
| `get_sitemaps`               | Список sitemap'ов сайта                                                |
| `get_diagnostics`            | Диагностика сайта: ошибки обхода, DNS, проблемы сервера                |
| `get_important_urls`         | Мониторинг важных URL                                                  |

У каждого инструмента есть параметр `format`: `markdown` (по умолчанию, компактно) или
`json` (сырой ответ API).

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

```
Какие сайты у меня в Вебмастере?
По каким запросам находят мой сайт за последнюю неделю?
Сколько страниц проиндексировано и есть ли деиндексация?
Отправь https://example.com/new-page на переобход и покажи остаток квоты.
```

## HTTP-режим

Помимо stdio сервер умеет работать по Streamable HTTP:

```bash
YANDEX_WEBMASTER_TOKEN=... npx @theyahia/yandex-webmaster-mcp --http
# POST /mcp  — MCP endpoint
# GET  /health — { "status": "ok", "version": "..." }
```

По умолчанию включена защита от DNS-rebinding (разрешены только `localhost`/`127.0.0.1`).
Для доступа с другого хоста задайте `MCP_ALLOWED_HOSTS`. Токен в HTTP-режиме общий
(берётся из окружения) — multi-tenancy не поддерживается.

## Разработка

```bash
npm install
npm run dev          # запуск из исходников (tsx)
npm test             # тесты (vitest)
npm run typecheck    # tsc --noEmit (src + tests)
npm run lint         # eslint
npm run format       # prettier --check
npm run build        # сборка в dist/
```

## Лицензия

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [theYahia](https://github.com/theYahia)
- **Source:** [theYahia/yandex-webmaster-mcp](https://github.com/theYahia/yandex-webmaster-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-theyahia-yandex-webmaster-mcp
- Seller: https://agentstack.voostack.com/s/theyahia
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.