Yandex Webmaster MCP server (npm)

@theyahia/yandex-webmaster-mcp

A TypeScript MCP server for the Yandex Webmaster API: sites, indexing, search queries, sitemaps, diagnostics and recrawl, 13 tools

MCP serverRussian stack

theyahia/yandex-webmaster-mcpAuthor:theYahia

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/theyahia-yandex-webmaster-mcp

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Run in a terminal

claude mcp add --transport stdio --env 'YANDEX_WEBMASTER_TOKEN=<your YANDEX_WEBMASTER_TOKEN>' yandex-webmaster -- npx -y @theyahia/yandex-webmaster-mcp

Or add to the file .mcp.json, in the project

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/yandex-webmaster-mcp"
      ],
      "env": {
        "YANDEX_WEBMASTER_TOKEN": "<your YANDEX_WEBMASTER_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

YANDEX_WEBMASTER_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in Cursor

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Add to the file ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/yandex-webmaster-mcp"
      ],
      "env": {
        "YANDEX_WEBMASTER_TOKEN": "<your YANDEX_WEBMASTER_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Keys and settings

YANDEX_WEBMASTER_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in VS Code

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Run in a terminal

code --add-mcp '{"name":"yandex-webmaster","type":"stdio","command":"npx","args":["-y","@theyahia/yandex-webmaster-mcp"],"env":{"YANDEX_WEBMASTER_TOKEN":"<your YANDEX_WEBMASTER_TOKEN>"}}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "yandex-webmaster": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/yandex-webmaster-mcp"
      ],
      "env": {
        "YANDEX_WEBMASTER_TOKEN": "<your YANDEX_WEBMASTER_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

YANDEX_WEBMASTER_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add yandex-webmaster --env 'YANDEX_WEBMASTER_TOKEN=<your YANDEX_WEBMASTER_TOKEN>' -- npx -y @theyahia/yandex-webmaster-mcp

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.yandex-webmaster]
command = "npx"
args = ["-y", "@theyahia/yandex-webmaster-mcp"]
env = { YANDEX_WEBMASTER_TOKEN = "<your YANDEX_WEBMASTER_TOKEN>" }

If the file already exists, append the block to the end.

Keys and settings

YANDEX_WEBMASTER_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.gemini/settings.json, for all projects

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/yandex-webmaster-mcp"
      ],
      "env": {
        "YANDEX_WEBMASTER_TOKEN": "<your YANDEX_WEBMASTER_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

YANDEX_WEBMASTER_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/devin/mcp_config.json, for all projects

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/yandex-webmaster-mcp"
      ],
      "env": {
        "YANDEX_WEBMASTER_TOKEN": "<your YANDEX_WEBMASTER_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Keys and settings

YANDEX_WEBMASTER_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/yandex-webmaster-mcp"
      ],
      "env": {
        "YANDEX_WEBMASTER_TOKEN": "<your YANDEX_WEBMASTER_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Keys and settings

YANDEX_WEBMASTER_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .roo/mcp.json, in the project

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/yandex-webmaster-mcp"
      ],
      "env": {
        "YANDEX_WEBMASTER_TOKEN": "<your YANDEX_WEBMASTER_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

YANDEX_WEBMASTER_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "yandex-webmaster": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@theyahia/yandex-webmaster-mcp"
      ],
      "environment": {
        "YANDEX_WEBMASTER_TOKEN": "<your YANDEX_WEBMASTER_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

YANDEX_WEBMASTER_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/yandex-webmaster-mcp"
      ],
      "env": {
        "YANDEX_WEBMASTER_TOKEN": "<your YANDEX_WEBMASTER_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

YANDEX_WEBMASTER_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .codeassistant/mcp.json, in the project

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/yandex-webmaster-mcp"
      ],
      "env": {
        "YANDEX_WEBMASTER_TOKEN": "<your YANDEX_WEBMASTER_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

YANDEX_WEBMASTER_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

You will need: Node.js

Checked against the repository on Sep 25, 2026, commit 7a9f243.

Text for your agent

Create an application at oauth.yandex.ru with the webmaster:api scope, get an OAuth token, then run claude mcp add yandex-webmaster -e YANDEX_WEBMASTER_TOKEN=your_token -- npx -y @theyahia/yandex-webmaster-mcp.

Other ways from the author

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

The README's command for connecting in Claude Code.

This is third-party code. Review the repository files before installing.

What it does

The server offers 13 tools for Yandex Webmaster: a list of verified sites, account info, search queries per site with impressions, clicks and average position, an aggregated traffic trend over time, an indexing summary, sitemap handling, important URLs, host diagnostics and requesting a page recrawl. Output defaults to compact Markdown, with raw JSON also available. Authorization needs only a webmaster:api token; the server resolves the numeric user_id itself via the API, with no manual entry needed. The server is part of the same author's broader YaAll bundle, where ten Yandex-service MCP servers live side by side, but it is distributed and runs as a standalone npm package.

Who it is for. For SEO specialists who want a compact standalone MCP for Yandex Webmaster specifically, without the rest of the Yandex service bundle.

Good fit when

You need indexing, search queries and diagnostics for a specific site in Webmaster
You want compact Markdown output instead of raw JSON to save context
You need to request a page recrawl after site changes

Not a fit when

You want the whole Yandex service stack at once: the same author's full YaAll bundle is simpler
You need data for a site you have not verified: access is limited to sites in the token's account

Example request

Show the site's indexing summary and request a recrawl of pages that have not updated recently

Limitations

You need an OAuth token with the webmaster:api scope, obtained through an application at oauth.yandex.ru. The get_search_queries tool is flagged in the README as a deprecated alias for get_popular_search_queries. HTTP mode does not check the Host header against DNS rebinding by default unless the MCP_ALLOWED_HOSTS list is explicitly set.

How to disable. Remove the server with claude mcp remove yandex-webmaster, or delete the yandex-webmaster block from your MCP client config.

MCP

Transport: stdio, http
Authentication: API key

Environment variables
Environment variables
YANDEX_WEBMASTER_TOKEN required, secret	OAuth token with the webmaster:api scope
YANDEX_WEBMASTER_USER_ID	The numeric user ID, resolved automatically if not set
MCP_ALLOWED_HOSTS	Allowed hosts for HTTP mode, protecting against DNS rebinding

Security check

Can request page recrawls and change sitemaps if the token has those rights
The OAuth token grants access to every verified site in the Webmaster account

README in short

The README notes that the server is part of the broader YaAll bundle with ten Yandex MCP servers, but is distributed separately here. It lists 13 tools for sites, indexing, search queries, sitemaps, important URLs, diagnostics and recrawl, an environment variable table with the token, an optional user_id and HTTP mode settings, installation for Claude Desktop and Claude Code via npx, and getting a token through oauth.yandex.ru with the webmaster:api scope.

FAQ

Do I need to set the user_id manually?

No, the server resolves it itself via a GET /user/ request.

Can I get raw JSON instead of Markdown?

Yes, output defaults to compact Markdown, but a raw JSON mode is also available.

DataLens Skills

Official

Official DataLens (Yandex) skills for Claude Code, Codex and OpenCode: SDK, HTML reports and RLS resolution

SkillMedium riskRussian stackNo VPN needed12

Yandex Metrika MCP Server

Editors’ pick

A Yandex Metrika MCP server generated from the API spec: 108 methods, 10 tools declared by default, transparent filters and response metadata

MCP serverMedium riskRussian stackNo VPN needed2

OpenSEO

Official

An open MCP server and agent skill set for SEO: keyword research, competitors, backlinks and site audits powered by DataForSEO

MCP serverMedium risk21.5K

Claude SEO

A Claude Code plugin for SEO audits: technical SEO, E-E-A-T, schema, local and AI search via parallel subagents

PluginHigh risk17.9K

Install

What it does

Good fit when

Not a fit when

Example request

Limitations

MCP

Security check

README in short

FAQ

Related

DataLens Skills

Yandex Metrika MCP Server

OpenSEO

Claude SEO