yandex-webmaster-mcp

Name: yandex-webmaster-mcp
Author: BoxLab-Ltd

本地服务

github.com/BoxLab-Ltd商业与营销42 天前更新

代码仓库

关于 yandex-webmaster-mcp

yandex-webmaster-mcp 将 Yandex Webmaster 的站点数据封装为结构化 MCP 工具，面向需要查询索引、搜索表现和诊断信息的 Agent。它默认只读，并支持提交 URL 重新抓取。

主要功能

01查看站点及 SQI 摘要
02分析搜索查询和趋势
03检查抓取与索引状态
04查看站点问题和站点地图
05查询外链及重新抓取任务
06提交 URL 重新抓取

适用场景

01比较不同日期或设备的搜索查询表现
02查找站点抓取、索引或 DNS 问题
03查看指向站点的外链样例
04请求 Yandex 提前重新抓取 URL

MCP 相关

作为 MCP 服务，它向客户端提供 Yandex Webmaster 数据查询工具，并允许提交 URL 重新抓取。可通过交互式 OAuth PKCE 登录，也可配置静态令牌。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "boxlab-ltd-yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "@boxlab/yandex-webmaster-mcp"
      ],
      "env": {
        "YANDEX_WEBMASTER_TOKEN": "<YANDEX_WEBMASTER_TOKEN>",
        "YANDEX_WEBMASTER_HOST_ID": "<YANDEX_WEBMASTER_HOST_ID>"
      }
    }
  }
}

启动命令npx -y @boxlab/yandex-webmaster-mcp

需要配置的环境变量

YANDEX_WEBMASTER_TOKEN密钥Yandex Webmaster OAuth token (webmaster:hostinfo). Optional if you run the `auth` login.

YANDEX_WEBMASTER_HOST_IDDefault host id, so tools may omit hostId.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@boxlab/yandex-webmaster-mcp0.1.1stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
oob	boolean	否	强制使用复制粘贴流程，而不是自动本地重定向。

详细介绍

Yandex Webmaster MCP

用通俗语言查询 Yandex Webmaster 数据——可通过 Claude、Cursor 或任何 MCP 客户端进行。

按设计仅支持只读操作（另支持 URL 重新抓取），不存储机密信息。使用内置的公共 OAuth 客户端通过 PKCE 登录——无需注册应用，也无需客户端密钥。

早期开发阶段（v0.1）。 工具集仍在扩展中。

一个 Model Context Protocol 服务，将 Yandex Webmaster 封装为一组小巧、灵活且描述清晰的工具，而非为每个 API 端点各提供一个简单封装。可与 yandex-metrica-mcp 搭配使用：同时运行两者，Agent 就能在一次对话中交叉参照 Webmaster 中的搜索查询数据，以及 Metrica 中的站内行为和转化数据。

快速开始

1. 将服务添加到 MCP 客户端（Claude Desktop、Cursor 等）：

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

2. 登录——交互式操作，无需密钥：

npx @boxlab/yandex-webmaster-mcp auth

在浏览器中批准访问，然后粘贴 Yandex 显示的代码。令牌会缓存至 ~/.config/yandex-webmaster-mcp/token.json（模式 0600）。

3. 向 Agent 提问——例如 “列出我的 Webmaster 主机，并显示 example.com 的 SQI。”

或安装为 Claude Code 插件

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

原因

现有的社区服务往往只是简单封装——每个 API 端点提供一个工具，并将原始 JSON 倾倒到模型的上下文中。这个服务旨在做到精心设计：提供更少但更智能的工具；输出紧凑、结构化；默认只读，让 Agent 能够安全地探索你的 Webmaster 数据。

工具（v0.1）

get_hosts — 列出令牌可访问的网站及其 host_id、URL 和验证状态；也可选择包含主机摘要（SQI、已编入索引／已排除的页面、站点问题）。只读。请先调用此工具。
search_queries — Yandex Search 的搜索查询分析数据：展示次数、点击次数、平均展示／点击排名。report="top" 按流量从高到低排列查询；report="trend" 返回时间序列（按查询或站点汇总）。可按设备和日期范围筛选。只读。
get_indexing — Yandex 如何抓取和编入主机索引。report="history" 按 HTTP 状态码类别显示各时间段抓取的页面；report="crawled" 列出示例抓取 URL 及其状态码；report="in_search" 列出当前出现在搜索结果中的示例页面。只读。
get_diagnostics — 检测到的站点问题（DNS、响应缓慢、robots.txt、4xx 等），包含严重程度，活跃问题优先显示。只读。
list_sitemaps — 列出 Yandex 已知的 Sitemap 文件，包括 URL 数量、错误数量，以及每个文件的发现位置。只读。
get_external_links — 入站链接（反向链接）：report="samples" 返回含来源／目标的示例链接，report="history" 返回随时间变化的数量。只读。
recrawl_status — 剩余的每日重新抓取配额，以及近期重新抓取任务及其状态；传入 taskId 可查看单个任务。只读。
recrawl_submit — 请求 Yandex 尽快重新抓取指定 URL。这是唯一的写入工具；每次调用消耗一单位每日配额。返回任务 ID。

计划中： 用于 Sitemap、原创文本和 Feed 的写入工具，将在后续的可选加入版本中推出。

要求

Node.js >= 18
至少添加了一个网站的 Yandex 账号 Yandex Webmaster

身份验证

按优先级排序的三种方式：

交互式登录（推荐） — npx @boxlab/yandex-webmaster-mcp auth。使用内置的公共 OAuth 客户端通过 PKCE 进行身份验证；令牌有效期约为 6 个月。
静态令牌 — 设置 YANDEX_WEBMASTER_TOKEN（例如用于 CI），其值为具有 webmaster:hostinfo 范围的应用的 OAuth 令牌。
使用自己的 OAuth 应用 — 设置 YANDEX_OAUTH_CLIENT_ID（以及 YANDEX_OAUTH_CLIENT_SECRET 以启用自动令牌刷新）。该应用需要 webmaster:hostinfo 和 webmaster:verify 范围。

所有配置请参阅 .env.example。

开发

优先使用 Bun：

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`

已发布的软件包使用 Node 运行；本地开发使用 Bun。