yandex-tools-mcp

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

English | Русский

---

English

Packages

Package	Description	npm
yandex-wordstat-mcp	Keyword research & search trends via the Yandex Wordstat v2 API (Yandex Cloud)
yandex-search-mcp	Web search via Yandex Search API
yandex-webmaster-mcp	Site analytics, indexing & SEO via Yandex Webmaster API
yandex-metrika-mcp	Web analytics & traffic data via Yandex Metrika API

Quick Start

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

{
  "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 unoapi.ru/services/wordstat — no Yandex Cloud credentials to manage.

Yandex Search (web search):

{
  "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):

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

Yandex Metrica (web analytics):

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

See individual package READMEs for detailed setup instructions.

Online usage example: seyka.ru

Claude Code Plugin

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

# Set your API keys
export YANDEX_SEARCH_API_KEY=your_api_key   # also used by Wordstat
export YANDEX_FOLDER_ID=your_folder_id      # also used by Wordstat
export YANDEX_WEBMASTER_TOKEN=your_oauth_token
export YANDEX_METRIKA_TOKEN=your_oauth_token

# Run with plugin
claude --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)
yandex-search-mcp	Веб-поиск через Yandex Search API
yandex-webmaster-mcp	Аналитика сайта, индексация и SEO через Яндекс Вебмастер API
yandex-metrika-mcp	Веб-аналитика и данные о трафике через Яндекс Метрика API

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

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

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

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

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

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

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

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

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

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

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

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

Плагин для Claude Code

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

# Установите API ключи
export YANDEX_SEARCH_API_KEY=ваш_api_ключ   # также используется Вордстатом
export YANDEX_FOLDER_ID=ваш_folder_id       # также используется Вордстатом
export YANDEX_WEBMASTER_TOKEN=ваш_oauth_токен
export YANDEX_METRIKA_TOKEN=ваш_oauth_токен

# Запустите с плагином
claude --plugin-dir /path/to/yandex-tools-mcp

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

---

Development

git clone https://github.com/altrr2/yandex-tools-mcp.git
cd yandex-tools-mcp
bun install

Lint and format:

bun run lint
bun run format

Publish packages:

cd packages/yandex-wordstat-mcp && npm publish
cd packages/yandex-search-mcp && npm publish
cd packages/yandex-webmaster-mcp && npm publish

License

MIT © Alternex