Yandex Webmaster MCP server

Yandex Webmaster MCP

Ask your Yandex Webmaster data in plain language — from Claude, Cursor, or any MCP client.

Read-only by design (plus URL recrawl), no secrets stored. Sign in with a

built-in public OAuth client over PKCE — no app registration, no client secret.

Early development (v0.1). The tool surface is still growing.

A Model Context Protocol server that exposes Yandex Webmaster as a small set of flexible, well-described tools instead of one-thin-wrapper-per-endpoint. Pairs with yandex-metrica-mcp: run both and an agent can cross-reference search queries from Webmaster with on-site behavior and conversions from Metrica in a single conversation.

Quickstart

1. Add the server to your MCP client (Claude Desktop, Cursor, …):

{
    "mcpServers": {
        "yandex-webmaster": {
            "command": "npx",
            "args": ["-y", "@boxlab/yandex-webmaster-mcp"]
        }
    }
}

2. Sign in — interactive, no secret needed:

npx @boxlab/yandex-webmaster-mcp auth

Approve access in the browser, paste the code Yandex shows you. The token is cached at ~/.config/yandex-webmaster-mcp/token.json (mode 0600).

3. Ask your agent — e.g. "List my Webmaster hosts and show the SQI for example.com."

Or install as a Claude Code plugin

/plugin marketplace add BoxLab-Ltd/yandex-webmaster-mcp
/plugin install yandex-webmaster-mcp@boxlab

Why

Existing community servers tend to be thin wrappers — one tool per API endpoint, dumping raw JSON into the model's context. This server aims to be well-engineered: fewer, smarter tools; compact, structured output; read-only by default so an agent can explore your Webmaster data safely.

Tools (v0.1)

URL and verification state; optionally a host summary (SQI, indexed/excluded pages, site problems). Read-only. Call this first.

• gethosts — list the sites available to your token with their hostid,

clicks, average show/click position. report="top" ranks the queries bringing the most traffic; report="trend" returns a time series (per query or the site aggregate). Filter by device and date range. Read-only.

• searchqueries** — search-query analytics from Yandex Search: impressions,

gives crawled pages by HTTP status class over time; report="crawled" lists example crawled URLs with their codes; report="in_search" lists example pages currently in search. Read-only.

• getindexing** — how Yandex crawls and indexes the host. report="history"

robots.txt, 4xx, …) with severity, active problems first. Read-only.

• getdiagnostics** — problems detected on the site (DNS, slow response,

counts and where each was discovered. Read-only.

• listsitemaps** — the Sitemap files Yandex knows, with URL counts, error

example links with source/target, report="history" for the count over time. Read-only.

• getexternallinks — inbound links (backlinks): report="samples" for

and their state; pass taskId to check one task. Read-only.

• recrawlstatus** — remaining daily recrawl quota plus recent recrawl tasks

write tool; consumes one unit of the daily quota. Returns the task id.

• recrawlsubmit** — ask Yandex to recrawl a specific URL sooner. The one

Planned: write tools for sitemaps, original texts and feeds, deferred to a later, opt-in release.

Requirements

Yandex Webmaster

• Node.js >= 18
• A Yandex account with at least one site added in

Authentication

Shortened. The full README is on GitHub.