# Yandex Webmaster MCP

> Yandex Webmaster MCP is an MCP server for marketing and seo. Ask AI about your site's Yandex search indexing, queries and diagnostics. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI
- **Repository:** https://github.com/askads/mcp-yandex-webmaster
- **MCP Registry name:** io.github.askads/mcp-yandex-webmaster
- **Categories:** [marketing and SEO](https://ai-powered.com/categories/marketing-and-seo)
- **Listing updated:** 2026-11-15

## About

The server is built around Yandex's own view of a site. It answers questions about which pages are in or out of the Yandex index, how impressions, clicks and average positions move by date and device type, which problems the Webmaster diagnostics flag, how sitemaps are read and which external links point at the site. It does not cover traffic analytics, search demand or advertising data, so it complements rather than replaces those tools.

Connection happens inside the chat. You ask the assistant to connect Yandex Webmaster, Yandex opens a sign-in page, a one-time code is valid for 10 minutes, and the server checks access to your sites straight afterwards. A ready-made OAuth token can be supplied instead for CI or unattended setups.

Most calls only read data. A few can change state in the Webmaster account: adding a site, starting ownership verification by DNS record, HTML file or meta tag, adding a sitemap, and queuing a page for recrawl, which uses the site's daily recrawl quota. Statistics and diagnostics need verified ownership; otherwise Webmaster returns HOST_NOT_VERIFIED.

## Features

- **Twenty Webmaster tools:** The README describes 20 tools covering sites, diagnostics, search queries, indexing, sitemaps and external links.
- **Search query statistics:** Shows impressions, clicks and average positions by date and for desktop versus mobile.
- **Indexing and diagnostics:** Reports pages in and excluded from search, status changes and problems grouped by severity.
- **Sitemap and recrawl actions:** Adds sitemaps and queues pages for recrawl, with the remaining daily quota shown in the reply.
- **Sign-in from the conversation:** Connects to Yandex through a browser login with a 10-minute one-time code, so no token has to be prepared first.
- **Configurable limits:** Environment variables set a default host, request timeout and retry count for rate-limited or failing calls.

## Good for

- Review critical Yandex diagnostics issues for a site
- Check which important pages changed indexing status
- Compare mobile and desktop search visibility over a month
- Verify a sitemap and see when the crawler last read it
- Queue a changed page for recrawl while watching the daily quota

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-yandex-webmaster --env YANDEX_OAUTH_TOKEN='<YANDEX_OAUTH_TOKEN>' -- npx -y mcp-yandex-webmaster
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "<YANDEX_OAUTH_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "<YANDEX_OAUTH_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-yandex-webmaster": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "<YANDEX_OAUTH_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "<YANDEX_OAUTH_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "<YANDEX_OAUTH_TOKEN>"
      }
    }
  }
}
```

## FAQ

### Do I need to create a token first?

No. The assistant starts a Yandex sign-in during the chat. For automation you can instead set YANDEX_OAUTH_TOKEN.

### Does it include Metrica or Wordstat data?

No. It covers organic search data from Yandex Webmaster only, with no traffic, search demand or ad data.

### Can it change my account?

Some tools can add a site or sitemap, start ownership verification or queue a recrawl. Everything else reads data.

### What does HOST_NOT_VERIFIED mean?

Webmaster returns it when site ownership is not confirmed, which blocks statistics and diagnostics.

### How do I add Yandex Webmaster MCP to Claude Code?

Run this command in your terminal: claude mcp add mcp-yandex-webmaster --env YANDEX_OAUTH_TOKEN='<YANDEX_OAUTH_TOKEN>' -- npx -y mcp-yandex-webmaster

### What are the best alternatives to Yandex Webmaster MCP?

The closest alternatives to Yandex Webmaster MCP are Yandex Direct MCP, LV24 SEO, Yandex Metrica MCP, Yandex Metrika and mowteng.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Yandex Direct MCP](https://ai-powered.com/mcp/yandex-direct-mcp-4): Yandex Direct MCP is an open-source MCP server for marketing and seo.
- [LV24 SEO](https://ai-powered.com/mcp/lv24-seo): LV24 SEO is a free MCP server for marketing and seo.
- [Yandex Metrica MCP](https://ai-powered.com/mcp/yandex-metrica-mcp): Yandex Metrica MCP is an open-source MCP server for analytics and data.
- [Yandex Metrika](https://ai-powered.com/mcp/yandex-metrika): Yandex Metrika is an open-source MCP server for analytics and data.
- [mowteng](https://ai-powered.com/mcp/mowteng): mowteng is an MCP server for web search and scraping.
- [Yandex Wordstat MCP](https://ai-powered.com/mcp/yandex-wordstat-mcp-2): Yandex Wordstat MCP is an open-source MCP server for marketing and seo.
- [MCPKit — Yandex Wordstat MCP](https://ai-powered.com/mcp/mcpkit-yandex-wordstat-mcp): MCPKit — Yandex Wordstat MCP is a free MCP server for marketing and seo.
- [Yandex Direct MCP](https://ai-powered.com/mcp/yandex-direct-mcp): Yandex Direct MCP is an open-source MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/yandex-webmaster-mcp-4
