MCP servers for Yandex APIs — search, keyword research, webmaster tools, and web analytics for the Russian market.
English | Русский
English
Packages
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 seyka.ru/developers/api/seo/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"
}
}
}
}
Yandex Direct (PPC campaign management — defaults to sandbox; set YANDEX_DIRECT_LIVE=1 for the real account):
{
"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:
export YANDEX_SEARCH_API_KEY=your_api_key
export YANDEX_FOLDER_ID=your_folder_id
export YANDEX_WEBMASTER_TOKEN=your_oauth_token
export YANDEX_METRIKA_TOKEN=your_oauth_token
export YANDEX_DIRECT_TOKEN=your_oauth_token
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
Русский
Пакеты
Быстрый старт
Яндекс Вордстат 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"
}
}
}
}
Нужен готовый инструмент? Используйте размещённый эндпоинт seyka.ru/developers/api/seo/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_токен"
}
}
}
}
Яндекс Директ (управление РРС-кампаниями — по умолчанию песочница; установите YANDEX_DIRECT_LIVE=1 для боевого аккаунта):
{
"mcpServers": {
"yandex-direct": {
"command": "npx",
"args": ["-y", "yandex-direct-mcp"],
"env": {
"YANDEX_DIRECT_TOKEN": "ваш_oauth_токен"
}
}
}
}
Подробные инструкции по настройке в README каждого пакета.
Хостинг-версии на seyka.ru: Поиск Яндекса · Wordstat · Вебмастер · Метрика
Онлайн пример использования: seyka.ru
Плагин для Claude Code
Установите все пять MCP как единый плагин со встроенными навыками для исследования ключевых слов и анализа конкурентов:
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
git clone https://github.com/seyka-ai/yandex-tools-mcp.git
cd yandex-tools-mcp
bun 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):
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
cd packages/yandex-metrika-mcp && npm publish
cd packages/yandex-direct-mcp && npm publish
License
MIT © Seyka AI