# Yandex Webmaster MCP

Connects Yandex Webmaster API v4 to your AI coding agent. It checks indexing events, query impressions, clicks, diagnostics, and Site Quality Index trends.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 19
- Author: stufently
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/stufently/yandex-mcp/tree/HEAD/packages/yandex-webmaster-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/yandex-webmaster-mcp

## What it does

This integration provides 33 tools targeting Yandex Webmaster API v4. Agents can inspect domain diagnostics and query metrics directly inside the chat interface. It keeps search analytics context inside your workflow.

The server scans the event stream to isolate dropped URLs in `get-excluded-pages`. It filters exclusions against recent returns to search so active pages stay out of the drop list. Note that API v4 does not cover IndexNow or `robots.txt` inspections.

The package is published under `@stufently/yandex-webmaster-mcp`. The unscoped name belongs to someone else. You must supply an OAuth token in `YANDEX_WEBMASTER_TOKEN` before making requests.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `YANDEX_WEBMASTER_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add yandex-webmaster-mcp -e YANDEX_WEBMASTER_TOKEN=<YANDEX_WEBMASTER_TOKEN> -- npx -y @stufently/yandex-webmaster-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add yandex-webmaster-mcp --env YANDEX_WEBMASTER_TOKEN=<YANDEX_WEBMASTER_TOKEN> -- npx -y @stufently/yandex-webmaster-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "yandex-webmaster-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@stufently/yandex-webmaster-mcp"
            ],
            "env": {
                "YANDEX_WEBMASTER_TOKEN": "<YANDEX_WEBMASTER_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "yandex-webmaster-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@stufently/yandex-webmaster-mcp"
            ],
            "env": {
                "YANDEX_WEBMASTER_TOKEN": "<YANDEX_WEBMASTER_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e YANDEX_WEBMASTER_TOKEN=<YANDEX_WEBMASTER_TOKEN> yandex-webmaster-mcp npx -y @stufently/yandex-webmaster-mcp
```
Replace <…> with your own values

## When to use it
- inspect URLs removed from Yandex search results
- retrieve top search queries by clicks or impressions
- review Site Quality Index historical changes
- check site diagnostics and crawl issues

## Example prompts
- Fetch my verified domains and their `host_id` values from Yandex Webmaster
- Show top search queries ordered by clicks for host `https:example.com:443`
- Run `get-excluded-pages` on host `https:example.com:443` to find dropped URLs

## Similar
- [ahrefs-python](https://affpapa.org/en/nevibecode/skills/ahrefs-python.md) — skill · 313 installs
- [yandex-metrica-mcp](https://affpapa.org/en/nevibecode/mcp/yandex-metrica-mcp.md) — MCP server · ★ 15
- [seo-audit](https://affpapa.org/en/nevibecode/skills/coreyhaines31-seo-audit.md) — skill · 238500 installs
- [programmatic-seo](https://affpapa.org/en/nevibecode/skills/coreyhaines31-programmatic-seo.md) — skill · 150800 installs
- [backlink-analyzer](https://affpapa.org/en/nevibecode/skills/backlink-analyzer.md) — skill · 26100 installs

From the same set: [stufently/yandex-mcp](https://affpapa.org/en/nevibecode/by/stufently/yandex-mcp.md) — 5 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md