Yandex Tools MCP

io.github.ruslan-mm18由 GitHub 帳號 ruslan-mm18 發布v1.0.0更新於 Oct 29, 2026

MCP servers for Yandex APIs: Wordstat, Search, Webmaster, Metrika, Direct. Open source, by Seyka AI.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取資料與分析商業與電商

概覽

AI 產生的概覽

面向 Yandex API 的 MCP 伺服器，讓助理執行網頁搜尋、關鍵字研究、網站 SEO 檢查、網站分析與 PPC 廣告管理，主要服務俄羅斯市場。

可以做什麼
  • 透過 Yandex Search API 進行網頁搜尋
  • 用 Yandex Wordstat v2 研究關鍵字、搜尋量與趨勢
  • 透過 Yandex Webmaster 檢視網站收錄、SEO 與網站分析
  • 讀取 Yandex Metrika 的流量與網站分析資料
  • 透過 Yandex Direct 管理 PPC 廣告活動、廣告、關鍵字、出價與統計
適用情境
適合處理俄羅斯市場的工作：關鍵字與競品研究、搜尋結果頁分析、檢查網站收錄狀況、取得流量報表，或在對話中管理 Yandex Direct 廣告投放。
執行需求
可使用 mcp.seyka.ru 託管端點並以 OAuth 驗證，也可用 npx 在本機執行各個 npm 套件（需要 Node.js）。本機方式中，搜尋與 Wordstat 需要 Yandex Cloud 憑證 YANDEX_SEARCH_API_KEY 與 YANDEX_FOLDER_ID，其餘服務需要 OAuth 權杖 YANDEX_WEBMASTER_TOKEN、YANDEX_METRIKA_TOKEN 與 YANDEX_DIRECT_TOKEN。
安裝前請注意
需要可存取搜尋、站長、分析與廣告帳戶的 Yandex Cloud API 金鑰與 OAuth 權杖，請勿寫入共用設定。Direct 服務可變更廣告活動、廣告、關鍵字與出價，預設使用沙箱，設定 YANDEX_DIRECT_LIVE=1 後會指向真實帳戶並可能產生費用。查詢與帳戶資料會傳送給 Yandex，使用託管版本時也會傳送給服務提供者的端點。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Yandex Tools MCP，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.ruslan-mm18%2Fyandex-tools-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "yandex-tools": {
      "type": "http",
      "url": "https://mcp.seyka.ru/mcp"
    }
  }
}

README

yandex-tools-mcp

MCP servers for Yandex APIs — search, keyword research, webmaster tools, and web analytics for the Russian market.

English | Русский

English

Packages

PackageDescriptionnpm
yandex-wordstat-mcpKeyword research & search trends via the Yandex Wordstat v2 API (Yandex Cloud)[npm]
yandex-search-mcpWeb search via Yandex Search API[npm]
yandex-webmaster-mcpSite analytics, indexing & SEO via Yandex Webmaster API[npm]
yandex-metrika-mcpWeb analytics & traffic data via Yandex Metrika API[npm]
yandex-direct-mcpPPC campaign management (campaigns, ads, keywords, bids, stats) via Yandex Direct API[npm]

Quick Start

Yandex Wordstat v2 (keyword research) — Yandex Cloud Search API; uses the same key as Search:

json
{  "mcpServers": {    "yandex-wordstat": {      "command": "npx",      "args": ["-y", "yandex-wordstat-mcp"],      "env": {        "YANDEX_SEARCH_API_KEY": "your_api_key",        "YANDEX_FOLDER_ID": "your_folder_id"      }    }  }}

Prefer a hosted tool? Use the managed endpoint at seyka.ru/developers/api/seo/wordstat — no Yandex Cloud credentials to manage.

Yandex Search (web search):

json
{  "mcpServers": {    "yandex-search": {      "command": "npx",      "args": ["-y", "yandex-search-mcp"],      "env": {        "YANDEX_SEARCH_API_KEY": "your_api_key",        "YANDEX_FOLDER_ID": "your_folder_id"      }    }  }}

Yandex Webmaster (site analytics & SEO):

json
{  "mcpServers": {    "yandex-webmaster": {      "command": "npx",      "args": ["-y", "yandex-webmaster-mcp"],      "env": {        "YANDEX_WEBMASTER_TOKEN": "your_oauth_token"      }    }  }}

Yandex Metrica (web analytics):

json
{  "mcpServers": {    "yandex-metrika": {      "command": "npx",      "args": ["-y", "yandex-metrika-mcp"],      "env": {        "YANDEX_METRIKA_TOKEN": "your_oauth_token"      }    }  }}

Yandex Direct (PPC campaign management — defaults to sandbox; set YANDEX_DIRECT_LIVE=1 for the real account):

json
{  "mcpServers": {    "yandex-direct": {      "command": "npx",      "args": ["-y", "yandex-direct-mcp"],      "env": {        "YANDEX_DIRECT_TOKEN": "your_oauth_token"      }    }  }}

See individual package READMEs for detailed setup instructions.

Hosted versions on seyka.ru: Yandex Search · Wordstat · Webmaster · Metrika

Online usage example: seyka.ru

Claude Code Plugin

Install all five MCPs as a single plugin with built-in skills for keyword research and competitive analysis:

bash
# Set your API keysexport YANDEX_SEARCH_API_KEY=your_api_key   # also used by Wordstatexport YANDEX_FOLDER_ID=your_folder_id      # also used by Wordstatexport YANDEX_WEBMASTER_TOKEN=your_oauth_tokenexport YANDEX_METRIKA_TOKEN=your_oauth_tokenexport YANDEX_DIRECT_TOKEN=your_oauth_token  # defaults to sandbox
# Run with pluginclaude --plugin-dir /path/to/yandex-tools-mcp

Included Skills:

  • yandex-keyword-research — Automatically triggered for keyword research, search volumes, and trend analysis
  • yandex-competitive-analysis — Automatically triggered for competitor analysis and SERP research

Русский

Пакеты

ПакетОписаниеnpm
yandex-wordstat-mcpИсследование ключевых слов через API Яндекс Вордстат v2 (Yandex Cloud)[npm]
yandex-search-mcpВеб-поиск через Yandex Search API[npm]
yandex-webmaster-mcpАналитика сайта, индексация и SEO через Яндекс Вебмастер API[npm]
yandex-metrika-mcpВеб-аналитика и данные о трафике через Яндекс Метрика API[npm]
yandex-direct-mcpУправление РРС-кампаниями (кампании, объявления, фразы, ставки, статистика) через API Яндекс Директа[npm]

Быстрый старт

Яндекс Вордстат v2 (исследование ключевых слов) — Yandex Cloud Search API; использует тот же ключ, что и Поиск:

json
{  "mcpServers": {    "yandex-wordstat": {      "command": "npx",      "args": ["-y", "yandex-wordstat-mcp"],      "env": {        "YANDEX_SEARCH_API_KEY": "ваш_api_ключ",        "YANDEX_FOLDER_ID": "ваш_folder_id"      }    }  }}

Нужен готовый инструмент? Используйте размещённый эндпоинт seyka.ru/developers/api/seo/wordstat — без необходимости управлять учётными данными Yandex Cloud.

Яндекс Поиск (веб-поиск):

json
{  "mcpServers": {    "yandex-search": {      "command": "npx",      "args": ["-y", "yandex-search-mcp"],      "env": {        "YANDEX_SEARCH_API_KEY": "ваш_api_ключ",        "YANDEX_FOLDER_ID": "ваш_folder_id"      }    }  }}

Яндекс Вебмастер (аналитика сайта и SEO):

json
{  "mcpServers": {    "yandex-webmaster": {      "command": "npx",      "args": ["-y", "yandex-webmaster-mcp"],      "env": {        "YANDEX_WEBMASTER_TOKEN": "ваш_oauth_токен"      }    }  }}

Яндекс Метрика (веб-аналитика):

json
{  "mcpServers": {    "yandex-metrika": {      "command": "npx",      "args": ["-y", "yandex-metrika-mcp"],      "env": {        "YANDEX_METRIKA_TOKEN": "ваш_oauth_токен"      }    }  }}

Яндекс Директ (управление РРС-кампаниями — по умолчанию песочница; установите YANDEX_DIRECT_LIVE=1 для боевого аккаунта):

json
{  "mcpServers": {    "yandex-direct": {      "command": "npx",      "args": ["-y", "yandex-direct-mcp"],      "env": {        "YANDEX_DIRECT_TOKEN": "ваш_oauth_токен"      }    }  }}

Подробные инструкции по настройке в README каждого пакета.

Хостинг-версии на seyka.ru: Поиск Яндекса · Wordstat · Вебмастер · Метрика

Онлайн пример использования: seyka.ru

Плагин для Claude Code

Установите все пять MCP как единый плагин со встроенными навыками для исследования ключевых слов и анализа конкурентов:

bash
# Установите API ключиexport YANDEX_SEARCH_API_KEY=ваш_api_ключ   # также используется Вордстатомexport YANDEX_FOLDER_ID=ваш_folder_id       # также используется Вордстатомexport YANDEX_WEBMASTER_TOKEN=ваш_oauth_токенexport YANDEX_METRIKA_TOKEN=ваш_oauth_токенexport YANDEX_DIRECT_TOKEN=ваш_oauth_токен  # по умолчанию песочница
# Запустите с плагиномclaude --plugin-dir /path/to/yandex-tools-mcp

Включённые навыки:

  • yandex-keyword-research — Автоматически активируется для исследования ключевых слов, объёмов поиска и анализа трендов
  • yandex-competitive-analysis — Автоматически активируется для анализа конкурентов и исследования SERP

Development

bash
git clone https://github.com/seyka-ai/yandex-tools-mcp.gitcd yandex-tools-mcpbun install

Run bun install before starting Claude Code in this repo. The local .mcp.json runs each server from source with node, so without installed dependencies every server crashes on startup (Cannot find package '@modelcontextprotocol/sdk') and Claude Code reports it as CONNECTION_CLOSED. Bun installs each package's dependencies into its own packages/*/node_modules. The plugin setup above uses npx and doesn't need this step.

Run all tests (each package with a test script):

bash
bun run test

Lint and format:

bash
bun run lintbun run format

Publish packages:

bash
cd packages/yandex-wordstat-mcp && npm publishcd packages/yandex-search-mcp && npm publishcd packages/yandex-webmaster-mcp && npm publishcd packages/yandex-metrika-mcp && npm publishcd packages/yandex-direct-mcp && npm publish

License

MIT © Seyka AI

來源：README.md，提交 f3230f6

工具

0
該伺服器需要 API 金鑰等憑證，因此 SourceWeft 無法在沒有憑證的情況下讀取其工具，也未收錄。

版本歷史

1
  1. v1.0.0最新Oct 29, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分