Yandex Webmaster API v4.1 MCP server

Яндекс Вебмастер MCP-сервер

A Python MCP server with full Yandex Webmaster API v4.1 coverage: 37 tools from diagnostics and sitemaps to important-URL monitoring

  • 0 ★ on the repository
  • Last commit
MCP server

Extended access

Why this level

  • Can add and remove sites, sitemaps and trigger recrawl without a separate confirmation step
  • A broad-permission Webmaster OAuth token is passed through an environment variable
All reasons and checks
Russian stack

crash-sv/yandex-webmaster-mcp-server-for-api-v4-1

Install

Manual install

pip install -e .

Install from source via pip.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Can add and remove sites, sitemaps and trigger recrawl without a separate confirmation step
  • A broad-permission Webmaster OAuth token is passed through an environment variable

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

What it does

The server covers almost the entire Yandex Webmaster API v4.1: sites and adding or removing them, verification status and owner lists, a summary with ИКС quality scores and its history, popular queries (top 3000) and analytics, recrawl quota and submission, diagnostics, indexing history by HTTP status, important-URL monitoring, pages in search with history and samples, auto-discovered and manually added sitemaps, and external and broken internal links. The server URL-encodes the host_id in scheme:domain:port form itself when sending API requests.

Who it is for. For SEO specialists who want the widest possible Yandex Webmaster API coverage in a single Python server.

Good fit when

  • You need the full Webmaster spectrum: from diagnostics and ИКС to important-URL monitoring and external links
  • Installing via pip install -e . and running the Python server directly is fine
  • You need call examples with real date and indicator parameters

Not a fit when

  • You need write operations gated by explicit confirmation, no confirm flag is documented
  • You need in-chat login without pre-creating an OAuth app

Example request

Show example.com's popular queries for March 2026 with impressions, clicks and average position

MCP

Transport
stdio
Authentication
API key

Environment variables

YANDEX_WEBMASTER_API_KEY required, secret
OAuth token with webmaster:hostinfo and webmaster:verify scopes, valid for 6 months

Limitations

The OAuth token lasts 6 months and needs manual refresh. The README does not describe write operations being gated by a confirmation step. The host_id format (scheme:domain:port with no slashes) needs care when building requests manually.

How to disable. Remove the yandex-webmaster block from your MCP client config.

FAQ

What is a host_id?

Yandex Webmaster's special site identifier format: scheme:domain:port with no slashes, e.g. https:example.com:443, not a regular URL.

How long does the OAuth token last?

Six months from issuance, after which it needs to be obtained again through the same oauth.yandex.ru/authorize link.

How is this Yandex Webmaster MCP different from other Webmaster servers?

The Python server covers almost all of Yandex Webmaster API v4.1 in 37 tools: sites, adding and removing, verification, owners, a summary with the quality index and its history, popular queries (top 3000), diagnostics, sitemaps and important URL monitoring.

What is host_id and how long does an OAuth token live?

host_id is a site identifier in Webmaster in the format protocol:domain:port, for example https:example.ru:443. Yandex sets the OAuth token lifetime at issue, see the Yandex OAuth docs for the current value. Install with pip install -e ., it works in Claude Desktop and Claude Code.

Discussion

No questions or reviews yet.

Russian stack

A Yandex Webmaster v4 API MCP server with 29 tools and friendly site names instead of host_id, every write requires confirm: true

MCP serverExtended access

Yandex Webmaster MCP

Yandex Webmaster MCP Server

Russian stack

MCP server for Yandex Webmaster API v4: indexing, search queries, broken links, SQI, recrawl, sitemaps and feeds

MCP serverBroad access7Repository stars

Yandex Webmaster MCP server (npm)

@theyahia/yandex-webmaster-mcp

Russian stack

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

MCP serverExtended access6Repository stars

Yandex Webmaster MCP by Rezlazy

@rezlazy/yandex-webmaster-mcp

Russian stack

An MCP server with 42 tools for the Yandex Webmaster API v4: sites, sitemaps, search queries, indexing, links, recrawl and diagnostics

MCP serverExtended access

Yandex Webmaster MCP

Яндекс Вебмастер MCP

Russian stack

A Yandex Webmaster MCP server with in-chat OAuth PKCE login: 20 tools for diagnostics, search queries, sitemaps and recrawl

MCP serverExtended access1Repository stars
Russian stack

A Python MCP server for Yandex Webmaster with writes disabled by default and a site whitelist for sitemaps and recrawl

MCP serverExtended access

README in short

The Russian README lists capabilities by section covering nearly all of API v4.1, shows pip install -e . installation, obtaining an OAuth token with the right permissions, Claude Desktop and Claude Code configuration, and tool call examples with real date, indicator and host_id parameters.

README badge

Report a problem