# yandex-webmaster-mcp

Connects Yandex.Webmaster API to your coding agent. Inspect search traffic and submit pages for indexing directly from chat.

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

## What it does

This server exposes 13 tools for Yandex.Webmaster. It lets you review search query performance and track page indexing trends. The agent can return responses formatted as Markdown or raw JSON.

Setup requires a Yandex OAuth token with the `webmaster:api` permission. You do not need to configure a numerical user ID manually because the server detects it automatically. It communicates over standard I/O or runs as a Streamable HTTP service.

HTTP mode restricts traffic to localhost by default to protect against DNS rebinding attacks. Multi-tenancy is not supported. The authentication token is shared globally through a single environment variable.

## 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 @theyahia/yandex-webmaster-mcp
```
Replace <…> with your own values

### Codex

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

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "theyahia-yandex-webmaster-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/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": {
        "theyahia-yandex-webmaster-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/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> theyahia-yandex-webmaster-mcp npx -y @theyahia/yandex-webmaster-mcp
```
Replace <…> with your own values

## When to use it
- track search queries and click metrics in Yandex
- request recrawls for updated web pages
- inspect site diagnostics and crawling errors
- monitor sitemaps and indexing history

## Example prompts
- Check the indexing status and recent exclusion trends for my site.
- Show the top search queries and impressions from the past week.
- Submit a URL for recrawling and report the remaining daily quota.

## Similar
- [Yandex Webmaster MCP](https://affpapa.org/en/nevibecode/mcp/yandex-webmaster-mcp.md) — MCP server · ★ 19
- [SEO Tools: Yandex Wordstat](https://affpapa.org/en/nevibecode/mcp/seo-tools-yandex-wordstat.md) — MCP server · ★ 8
- [Yandex Wordstat MCP](https://affpapa.org/en/nevibecode/mcp/yandex-wordstat-mcp.md) — MCP server · ★ 19
- [nextjs-developer](https://affpapa.org/en/nevibecode/agents/nextjs-developer.md) — subagent · 898 installs
- [wix-manage](https://affpapa.org/en/nevibecode/skills/wix-manage.md) — skill · 502 installs
- [geoflow-content-automation](https://affpapa.org/en/nevibecode/skills/geoflow-content-automation.md) — skill · 442 installs

---
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