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
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
Install
- Works in
- Services
Manual install
pip install -e .Install from source via pip.
Access and checks
How we reviewExtended 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 positionMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
YANDEX_WEBMASTER_API_KEYrequired, 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.
Related
All Yandex Webmaster toolsYandex Webmaster MCP with safe writes
Yandex Webmaster MCP
A Yandex Webmaster v4 API MCP server with 29 tools and friendly site names instead of host_id, every write requires confirm: true
Yandex Webmaster MCP
Yandex Webmaster MCP Server
MCP server for Yandex Webmaster API v4: indexing, search queries, broken links, SQI, recrawl, sitemaps and feeds
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
Yandex Webmaster MCP by Rezlazy
@rezlazy/yandex-webmaster-mcp
An MCP server with 42 tools for the Yandex Webmaster API v4: sites, sitemaps, search queries, indexing, links, recrawl and diagnostics
Yandex Webmaster MCP
Яндекс Вебмастер MCP
A Yandex Webmaster MCP server with in-chat OAuth PKCE login: 20 tools for diagnostics, search queries, sitemaps and recrawl
A Python MCP server for Yandex Webmaster with writes disabled by default and a site whitelist for sitemaps and recrawl
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.