Yandex Webmaster MCP
Ask your Yandex Webmaster data in plain language — from Claude, Cursor, or any MCP client.
Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y @boxlab/[email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
YANDEX_WEBMASTER_TOKEN=<secret> YANDEX_WEBMASTER_HOST_ID=<value> claude mcp add io.github.boxlab-ltd-yandex-webmaster-mcp -- npx -y @boxlab/yandex-webmaster-mcp@0.1.1รันในเทอร์มินัล
{ "mcpServers": { "io.github.boxlab-ltd-yandex-webmaster-mcp": { "command": "npx", "args": [ "-y", "@boxlab/[email protected]" ], "env": { "YANDEX_WEBMASTER_TOKEN": "<secret>", "YANDEX_WEBMASTER_HOST_ID": "<value>" } } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิด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.
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."
/plugin marketplace add BoxLab-Ltd/yandex-webmaster-mcp
/plugin install yandex-webmaster-mcp@boxlab
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.
get_hosts — list the sites available to your token with their host_id,
URL and verification state; optionally a host summary (SQI, indexed/excluded
pages, site problems). Read-only. Call this first.search_queries — search-query analytics from Yandex Search: impressions,
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.get_indexing — how Yandex crawls and indexes the host. report="history"
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.get_diagnostics — problems detected on the site (DNS, slow response,
robots.txt, 4xx, …) with severity, active problems first. Read-only.list_sitemaps — the Sitemap files Yandex knows, with URL counts, error
counts and where each was discovered. Read-only.get_external_links — inbound links (backlinks): report="samples" for
example links with source/target, report="history" for the count over time.
Read-only.recrawl_status — remaining daily recrawl quota plus recent recrawl tasks
and their state; pass taskId to check one task. Read-only.recrawl_submit — ask Yandex to recrawl a specific URL sooner. The one
write tool; consumes one unit of the daily quota. Returns the task id.Planned: write tools for sitemaps, original texts and feeds, deferred to a later, opt-in release.
Three ways, in priority order:
npx @boxlab/yandex-webmaster-mcp auth.
Uses the built-in public OAuth client over PKCE; the token is valid ~6 months.YANDEX_WEBMASTER_TOKEN (e.g. for CI) to an OAuth
token for an app with the webmaster:hostinfo scope.YANDEX_OAUTH_CLIENT_ID (and
YANDEX_OAUTH_CLIENT_SECRET to enable automatic token refresh). The app needs
the webmaster:hostinfo and webmaster:verify scopes.See .env.example for all configuration.
Bun-first:
bun install
bun run dev # watch mode
bun run typecheck
bun run lint
bun test
bun run build # emits dist/ (Node-compatible)
bun run try # smoke against the real API after `bun run auth`
The published package runs on Node; local development uses Bun.
MIT
Query Yandex Webmaster indexing, queries, diagnostics and backlinks, and recrawl, via an AI agent.
{ "mcpServers": { "io.github.boxlab-ltd-yandex-webmaster-mcp": { "command": "npx", "args": [ "-y", "@boxlab/[email protected]" ], "env": { "YANDEX_WEBMASTER_TOKEN": "<secret>", "YANDEX_WEBMASTER_HOST_ID": "<value>" } } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ผู้เผยแพร่ระบุตัวแปรสภาพแวดล้อมเหล่านี้: YANDEX_WEBMASTER_TOKEN, YANDEX_WEBMASTER_HOST_ID
Yandex Webmaster ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-08 Query Yandex Webmaster indexing, queries, diagnostics and backlinks, and recrawl, via an AI agent.