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
yandex-direct-mcp	PPC campaign management (campaigns, ads, keywords, bids, stats) via Yandex Direct 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 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:

# 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
export YANDEX_DIRECT_TOKEN=your_oauth_token  # defaults to sandbox

# 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
yandex-direct-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"
      }
    }
  }
}

Нужен готовый инструмент? Используйте размещённый эндпоинт 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 как единый плагин со встроенными навыками для исследования ключевых слов и анализа конкурентов:

# Установите 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

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

bun run test

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