kurerok-yandex-webmaster-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@kurerok-yandex-webmaster-mcp get my search queries for the last 7 days"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
kurerok-yandex-webmaster-mcp
Local-first MCP server for Yandex Webmaster. It exposes the pieces we need for Kurerok SEO operations: search query analytics, sitemap state, indexing history, pages in search, recrawl quota/submission, diagnostics, and link samples.
This project intentionally talks to the official Yandex Webmaster API directly. It was informed by the public MCP ecosystem, especially:
altrr2/yandex-tools-mcpfor the multi-package Yandex API direction.theYahia/yandex-webmaster-mcpfor a compact Webmaster-only surface.yandex/yandex-search-mcp-serverfor official Yandex MCP packaging ideas.
It does not require sending OAuth tokens to a hosted third party.
Tools
Read-only:
yandex_get_useryandex_list_hostsyandex_get_host_summaryyandex_get_diagnosticsyandex_get_sitemapsyandex_get_search_queriesyandex_get_indexing_historyyandex_get_pages_in_search_historyyandex_get_search_events_samplesyandex_get_recrawl_quotayandex_get_recrawl_queueyandex_get_external_linksyandex_get_broken_internal_links
State-changing, quota-sensitive:
yandex_add_sitemapyandex_submit_recrawl_urls
Both require confirmed: true.
Related MCP server: Yandex Webmaster MCP Server
Setup
npm install
npm run buildCreate a Yandex OAuth application with Yandex Webmaster API access and set:
export YANDEX_WEBMASTER_TOKEN="..."
export YANDEX_WEBMASTER_HOST_ID="https:kurerok.ru:443"Codex/Claude MCP config:
{
"mcpServers": {
"kurerok-yandex-webmaster": {
"command": "node",
"args": ["/absolute/path/to/kurerok-yandex-webmaster-mcp/dist/index.js"],
"env": {
"YANDEX_WEBMASTER_TOKEN": "use-env-or-secret-manager",
"YANDEX_WEBMASTER_HOST_ID": "https:kurerok.ru:443"
}
}
}
}Security Notes
Tokens are read only from environment variables.
The server never prints the token intentionally.
API errors are surfaced without request headers.
Mutating tools require explicit
confirmed: true.Default auth scheme is
OAuth, matching Yandex API examples.Keep the OAuth token out of shell history and MCP config files when possible.
Kurerok Workflow
Recommended daily/weekly sequence:
yandex_get_sitemapsyandex_get_recrawl_quotayandex_get_search_queriesyandex_get_pages_in_search_historyyandex_get_indexing_historyBuild a curated URL queue from sitemap + Google winners.
yandex_submit_recrawl_urlswithconfirmed: true.
Do not bulk-submit weak external-apply or low-value pages before fixing the Yandex vacancies feed and JobPosting/directApply semantics.
Available Tools
15 toolsyandex_add_sitemapC
Add a sitemap file to Yandex Webmaster. Requires confirmed=true.
Inputs: confirmed (required), sitemap_url (required), host_id.
yandex_get_broken_internal_linksC
Get broken internal link samples.
Inputs: host_id.
yandex_get_diagnosticsC
Get Yandex Webmaster diagnostics for the site.
Inputs: host_id.
yandex_get_external_linksC
Get external link samples known to Yandex Webmaster.
Inputs: limit, offset, host_id.
yandex_get_host_summaryC
Get site summary metrics from Yandex Webmaster.
Inputs: host_id.
yandex_get_indexing_historyC
Get crawl/indexing history for a date range.
Inputs: date_to (required), date_from (required), host_id.
yandex_get_pages_in_search_historyC
Get pages-in-search count history for a date range.
Inputs: date_to (required), date_from (required), host_id.
yandex_get_recrawl_queueC
Get Yandex recrawl queue/tasks.
Inputs: host_id.
yandex_get_recrawl_quotaB
Check remaining Yandex recrawl quota.
Inputs: host_id.
yandex_get_search_events_samplesB
Get sample pages added to or removed from Yandex search.
Inputs: host_id.
yandex_get_search_queriesC
Get Yandex search query metrics for a date range.
Inputs: date_to (required), date_from (required), host_id.
yandex_get_sitemapsB
List sitemap files known to Yandex Webmaster.
Inputs: host_id.
yandex_get_userA
Get the authenticated Yandex Webmaster user id.
Inputs: no named parameters.
yandex_list_hostsA
List sites available in Yandex Webmaster.
Inputs: no named parameters.
yandex_submit_recrawl_urlsB
Submit up to 150 URLs to Yandex recrawl queue. Requires confirmed=true.
Inputs: urls (required), confirmed (required), host_id.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
Each tool targets a distinct aspect of Yandex Webmaster, such as sitemaps, diagnostics, links, indexing, and search queries. There is no functional overlap, making it easy for an agent to select the correct tool.
All tools follow a consistent 'yandex_<verb>_<object>' pattern in snake_case, using descriptive verbs like 'add', 'get', 'list', and 'submit'. The naming is predictable and uniform.
With 15 tools, the set is well-scoped for a Yandex Webmaster API wrapper. It covers essential operations without being excessive, and each tool serves a clear purpose within the domain.
The tool set provides comprehensive coverage of Yandex Webmaster features, including sitemap management, diagnostics, link analysis, indexing history, search queries, recrawl operations, and user/host info. No obvious gaps are present.
Maintenance
Related MCP Connectors
MCP servers for Yandex APIs: Wordstat, Search, Webmaster, Metrika, Direct. Open source, by Seyka AI.
Read-only Google Search Console MCP server for AI assistants.
Unified 15-tool SEO, SERP, clean Markdown & GEO (LLM citation Share-of-Voice) MCP server.
Audit, rank-track and analyze SEO for sites via an authenticated MCP server.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for interacting with Yandex.Webmaster API to manage sites, retrieve search queries, and check indexing status. Requires an OAuth token.1396 npm6MIT
- AlicenseCqualityDmaintenanceMCP server that provides 46 tools for managing Yandex Webmaster API v4, enabling site management, sitemaps, indexing, search analytics, and more through natural language.4630 npm7MIT
- AlicenseAqualityBmaintenanceThis MCP server lets you query Yandex Webmaster data in plain language, covering search queries, indexing, diagnostics, sitemaps, backlinks, and recrawl status. It is read-only by default (except recrawl submission) and uses OAuth without storing secrets.10125 npm4MIT
- AlicenseNot gradedqualityNot gradedmaintenanceSelf-hosted MCP server for Google Search Console. Enables natural language queries to list sites, analyze search analytics, inspect URLs, and check sitemaps through AI assistants.MIT