webmaster-mcp
A Python MCP server for Yandex Webmaster with writes disabled by default and a site whitelist for sitemaps and recrawl
- 0 ★ on the repository
- Last commit
Extended access
Why this level
- Once its flags are enabled it can add sitemaps and submit recrawl URLs
- The Webmaster OAuth token is stored in .env next to the server code
Install
- Works in
- Services
Manual install
python -m venv .venv && source .venv/bin/activate && pip install -e . && cp .env.example .envInstall from source via venv and pip.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Once its flags are enabled it can add sitemaps and submit recrawl URLs
- The Webmaster OAuth token is stored in .env next to the server code
This is third-party code. Review the repository files before installing.
What it does
The server provides ten read tools: auth status, site list, diagnostics, sitemaps, recrawl quota, popular queries and their history, plus two write operations: add a sitemap and submit a recrawl. Both writes are disabled by default via separate environment variables, require confirm=true on the call, and are only allowed for sites in an explicit YANDEX_WEBMASTER_WRITE_HOST_WHITELIST. Built with an OpenCode example, including a ready mcp.json config.
Who it is for. For OpenCode users who want Webmaster writes disabled by default and to explicitly list which sites are allowed to write.
Good fit when
- You want a server where writes are off until explicitly enabled via environment variables
- You work in OpenCode and want a ready config example
- You need a whitelist of sites where writes are allowed
Not a fit when
- You need broad API coverage: important-URL diagnostics, external links or indexing events are not implemented here
- You need to add new sites or start verification, these tools are not included
Example request
Show example.com's recrawl quota and top queries for the last monthMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
YANDEX_WEBMASTER_OAUTH_TOKENrequired, secret- Yandex Webmaster OAuth token
YANDEX_WEBMASTER_ENABLE_ADD_SITEMAP- Enables sitemap writes, off by default
YANDEX_WEBMASTER_ENABLE_RECRAWL- Enables recrawl submission, off by default
YANDEX_WEBMASTER_WRITE_HOST_WHITELIST- List of sites where writes are allowed
YANDEX_WEBMASTER_DEFAULT_HOST- Default site
Limitations
Only ten tools, no important URLs, external links or indexing events. Both write operations are off by default and need separate enabling via YANDEX_WEBMASTER_ENABLE_ADD_SITEMAP and YANDEX_WEBMASTER_ENABLE_RECRAWL. No packaged distribution, install via pip install -e .
How to disable. Remove the webmaster-mcp block from your OpenCode or other MCP client config.
FAQ
Why doesn't recrawl fire right away?
Writes are off by default: you need to enable YANDEX_WEBMASTER_ENABLE_RECRAWL, add the site to the whitelist and pass confirm=true when calling webmaster_request_recrawl.
How is the server wired to OpenCode?
The README gives a ready snippet for ~/.config/opencode/opencode.json with a bash command that loads .env itself and runs python -m yandex_webmaster_mcp.server.
Discussion
No questions or reviews yet.
Related
All Yandex Webmaster toolsYandex Webmaster MCP
Яндекс Вебмастер MCP
A Yandex Webmaster MCP server with in-chat OAuth PKCE login: 20 tools for diagnostics, search queries, sitemaps and recrawl
Yandex 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 for a local SEO routine
kurerok-yandex-webmaster-mcp
A local Yandex Webmaster MCP server with a recommended weekly routine: queries, indexing, recrawl and diagnostics in order
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
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 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
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| webmaster-mcp (this card) | no | API key | 0 | |
| Yandex Webmaster MCP server (npm) | no | API key | 6 | indexing and queries |
| Yandex Webmaster MCP for a local SEO routine | no | API key | 0 | with a ready weekly SEO routine |
README in short
The English README lists the ten tools, venv and pip install -e . based installation, required and optional environment variables, write safety (off by default, site whitelist, required confirm), how to run the server, and a ready OpenCode config example.