Context7
Up-to-date docs for AI agents
作者による説明(英語の原文)
MCP server for Yandex Webmaster API: indexing, search queries, sitemaps, diagnostics, links.
この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。
このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。
使っているAIアプリを選んで、設定をコピーしてください。
YANDEX_OAUTH_TOKEN, YANDEX_USER_ID, YANDEX_WEBMASTER_HOST_ID, YANDEX_WEBMASTER_API_BASE, YANDEX_WEBMASTER_TIMEOUT_MS, YANDEX_WEBMASTER_MAX_RETRIES「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。
必要なもの
どのアプリを使っていますか?
上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。
Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます
{
"mcpServers": {
"yandex-webmaster": {
"command": "npx",
"args": [
"-y",
"mcp-yandex-webmaster"
],
"env": {
"YANDEX_OAUTH_TOKEN": "your-value",
"YANDEX_USER_ID": "your-value",
"YANDEX_WEBMASTER_HOST_ID": "your-value",
"YANDEX_WEBMASTER_API_BASE": "your-value",
"YANDEX_WEBMASTER_TIMEOUT_MS": "your-value",
"YANDEX_WEBMASTER_MAX_RETRIES": "your-value"
}
}
}
}ターミナルでこれを実行します
claude mcp add yandex-webmaster --env YANDEX_OAUTH_TOKEN=your-value --env YANDEX_USER_ID=your-value --env YANDEX_WEBMASTER_HOST_ID=your-value --env YANDEX_WEBMASTER_API_BASE=your-value --env YANDEX_WEBMASTER_TIMEOUT_MS=your-value --env YANDEX_WEBMASTER_MAX_RETRIES=your-value -- npx -y mcp-yandex-webmaster動かす前に、空欄の値を入力してください。
プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます
{
"mcpServers": {
"yandex-webmaster": {
"command": "npx",
"args": [
"-y",
"mcp-yandex-webmaster"
],
"env": {
"YANDEX_OAUTH_TOKEN": "your-value",
"YANDEX_USER_ID": "your-value",
"YANDEX_WEBMASTER_HOST_ID": "your-value",
"YANDEX_WEBMASTER_API_BASE": "your-value",
"YANDEX_WEBMASTER_TIMEOUT_MS": "your-value",
"YANDEX_WEBMASTER_MAX_RETRIES": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
プロジェクトの .vscode/mcp.json に貼り付けます
{
"servers": {
"yandex-webmaster": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-yandex-webmaster"
],
"env": {
"YANDEX_OAUTH_TOKEN": "your-value",
"YANDEX_USER_ID": "your-value",
"YANDEX_WEBMASTER_HOST_ID": "your-value",
"YANDEX_WEBMASTER_API_BASE": "your-value",
"YANDEX_WEBMASTER_TIMEOUT_MS": "your-value",
"YANDEX_WEBMASTER_MAX_RETRIES": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。
選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。
YANDEX_USER_ID envYANDEX_WEBMASTER_HOST_ID envYANDEX_WEBMASTER_API_BASE envYANDEX_WEBMASTER_TIMEOUT_MS envYANDEX_WEBMASTER_MAX_RETRIES envこの設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント askads で確認済みです
このリポジトリはまだGitHubから読み取っていません
このリポジトリはまだGitHubから読み取っていません
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
入力が必要なもの:YANDEX_OAUTH_TOKEN
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は–、最新バージョン(1.2.4)がレジストリに届いたのは6 日前です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
同じカテゴリには:Context7, Codebase Memory, Exa
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Up-to-date docs for AI agents
Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.
Connect AI agents to Exa for web search, content fetching, and multi-step research.
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
Яндекс Вебмастер MCP подключает AI-приложение — Claude, Cursor, Codex и другие — к данным Яндекс Вебмастера. Спросите на естественном языке, как сайт выглядит в поиске Яндекса: какие страницы попали или не попали в поиск, что происходит с показами и кликами, какие проблемы видит Вебмастер, как устроены sitemap и внешние ссылки. Подключение начинается прямо в диалоге: не нужно заранее создавать токен или редактировать конфигурацию.
Попробуйте первым сообщением:
Какие критичные проблемы сейчас видит диагностика на моём сайте?
Подключить сервер · Посмотреть сценарии · Открыть техническую документацию
Вы: Покажи мои сайты в Вебмастере и кратко оцени их состояние.
Ассистент: Показывает сайты, доступные по токену, их ИКС, число страниц в поиске и исключённых страниц, а также количество проблем по степени серьёзности.
Вы: Какие критичные проблемы есть у основного сайта и что проверить в первую очередь?
Ассистент: Разбирает текущую диагностику Вебмастера, отделяет критичные проблемы от рекомендаций и объясняет, какие из них требуют действий на сайте.
Вы: По каким запросам сайт чаще всего показывался за последнюю неделю?
Ассистент: Показывает запросы с показами, кликами и средними позициями. При необходимости сравнивает динамику для компьютеров и мобильных устройств.
Нужен Node.js 20+. npx скачает сервер при первом запуске — отдельно устанавливать пакет не нужно. Токен заранее получать не нужно: подключение проходит прямо в диалоге.
Для CI и автоматических установок можно задать готовый токен — см. Подключение и настройка.
Codex
Через интерфейс. Откройте Settings → Plugins → MCP servers , нажмите Add server и укажите:
Сохраните сервер. Он появится в списке MCP-серверов Codex.
Через командную строку. Вместо интерфейса можно выполнить:
codex mcp add yandex-webmaster \
-- npx -y mcp-yandex-webmaster@latest
Проверить, что сервер добавлен: codex mcp list.
Claude Code
claude mcp add --transport stdio --scope user \
yandex-webmaster -- npx -y mcp-yandex-webmaster@latest
Проверить подключение: claude mcp list.
Claude Desktop
Откройте Settings → Developer → Edit Config и добавьте в claude_desktop_config.json:
{
"mcpServers": { "yandex-webmaster": { "command": "npx", "args": ["-y", "mcp-yandex-webmaster@latest"] } } }
Если раздела Developer нет, откройте файл вручную: macOS — ~/Library/Application Support/Claude/claude_desktop_config.json, Windows — %APPDATA%\Claude\claude_desktop_config.json. Перезапустите Claude Desktop.
Cursor
Откройте ~/.cursor/mcp.json, чтобы подключить сервер во всех проектах, или .cursor/mcp.json в конкретном проекте. Добавьте:
{
"mcpServers": { "yandex-webmaster": { "command": "npx", "args": ["-y", "mcp-yandex-webmaster@latest"] } } }
VS Code
В палитре команд выполните MCP: Open User Configuration . В открывшемся mcp.json добавьте сервер:
{
"servers": { "yandex-webmaster": { "type": "stdio", "command": "npx", "args": ["-y", "mcp-yandex-webmaster@latest"] } } }
После сохранения выполните MCP: List Servers и запустите сервер из списка.
Работа начинается со списка сайтов. У каждого есть технический идентификатор host_id — сервер подхватывает его из вашего запроса или из переменной YANDEX_WEBMASTER_HOST_ID, если она задана.
После подтверждения прав на сайт сервер может собрать в одном диалоге:
Если прав на сайт нет, Вебмастер вернёт HOST_NOT_VERIFIED. Если сайт ещё не загружен или не проиндексирован, HOST_NOT_LOADED и HOST_NOT_INDEXED означают, что данных пока нет, а не нулевые показатели.
Большинство вопросов к серверу только читают данные. Следующие операции меняют состояние в Яндекс Вебмастере:
| Действие | Что происходит | На что обратить внимание |
|---|---|---|
| Добавить сайт | Сайт появляется в списке сайтов аккаунта. | Права на него нужно подтвердить отдельно. |
| Запустить подтверждение прав | Вебмастер начинает проверять DNS-запись, HTML-файл или мета-тег. | Перед запуском нужно разместить код, который выдал Вебмастер. |
| Добавить sitemap | Sitemap передаётся Вебмастеру. | Повторное добавление вернёт сообщение, что файл уже есть. |
| Отправить страницу на переобход | URL попадает в очередь на обход роботом. | Тратится суточная квота сайта; ответ покажет её остаток. |
| Выполнить прямой запрос API | raw_request открывает пути API, для которых нет отдельного инструмента. | POST тоже может менять данные, а DELETE — безвозвратно удалить сайт или sitemap. |
Инструменты, которые меняют состояние, помечены для AI-приложения как действия, а raw_request с возможным удалением — как потенциально необратимое. Приложение может запросить подтверждение, но его поведение зависит от конкретного клиента. Для удаления нужна явная просьба.
Сервер обращается к Yandex Webmaster API v4 от имени вашего аккаунта Яндекса и видит те же сайты, которые доступны этому аккаунту в веб-интерфейсе Вебмастера.
Для обычного использования токен заранее не нужен:
Сервер использует PKCE: код из чата сам по себе нельзя обменять на токен, поэтому пересылать его в чате безопасно. Полученный токен хранится локально в ~/.config/mcp-yandex-webmaster/credentials.json с правами только для владельца (0600). Дальше подключение живёт само: доступ продлевается автоматически и не отваливается через год. Проверить состояние — попросите «покажи статус подключения», отключить — «отключи Вебмастер»; выданный доступ отзывается в Яндекс ID.
Для CI и нестандартных установок доступна настройка через переменные окружения:
| Переменная | Назначение |
|---|---|
YANDEX_OAUTH_TOKEN | Готовый OAuth-токен с доступом к Вебмастеру; имеет приоритет над входом из диалога — такой токен сервер не обновляет и не удаляет. |
YANDEX_WEBMASTER_HOST_ID | Сайт (host_id) по умолчанию, чтобы не уточнять его в каждом запросе. Узнать host_id можно командой «Покажи мои сайты в Вебмастере». |
YANDEX_WEBMASTER_OAUTH_CLIENT_ID | ClientID собственного OAuth-приложения вместо приложения по умолчанию. |
YANDEX_USER_ID | Идентификатор пользователя Вебмастера; по умолчанию определяется автоматически. |
YANDEX_WEBMASTER_TIMEOUT_MS | Таймаут запроса; по умолчанию 60 000 мс. |
YANDEX_WEBMASTER_MAX_RETRIES | Число повторов при временных ошибках; по умолчанию 3. |
YANDEX_WEBMASTER_API_BASE | Базовый адрес API; по умолчанию https://api.webmaster.yandex.net/v4. |
Готовый токен для YANDEX_OAUTH_TOKEN можно получить так: создайте приложение на oauth.yandex.ru, в правах доступа выберите API Яндекс Вебмастера — оба права, webmaster:hostinfo и webmaster:verify, и получите токен по инструкции Яндекс OAuth. Это же приложение подойдёт и для входа из диалога — задайте его ClientID в YANDEX_WEBMASTER_OAUTH_CLIENT_ID (Redirect URI — https://oauth.yandex.ru/verification_code).
Не публикуйте токен в чате, репозитории или скриншотах: он даёт доступ к сайтам вашего аккаунта.
По умолчанию сервер отправляет анонимные технические события: случайный идентификатор установки, название вызванного инструмента, версии сервера, AI-приложения, Node.js и операционной системы. При вызове инструмента сервер также отправляет его исход, а при ошибке - фрагмент её текста: код и сообщение, в которых e-mail, адреса, токены, числа от 4 цифр и текст в кавычках заменены на «#
冒頭だけを表示しています。続きはリポジトリで読めます