# Yandex Metrika MCP

MCP-сервер даёт ИИ-агенту доступ к API Яндекс Метрики: трафик, источники, география, поисковые фразы и свои отчёты. Пригодится, когда нужно спросить про статистику сайта прямо в чате.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 19
- Автор: stufently
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/stufently/yandex-mcp/tree/HEAD/packages/yandex-metrika-mcp
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/yandex-metrika-mcp

## Что делает

Сервер отдаёт агенту 12 инструментов. Пять из них управляют счётчиками: список сайтов, детали счётчика, цели, создание и удаление. Шесть отвечают за отчёты — сводка по визитам, источники трафика, география, устройства, популярные страницы и поисковые фразы. Последний, `get-report`, принимает произвольные метрики и измерения Метрики.

Для работы нужен OAuth-токен в переменной `YANDEX_METRIKA_TOKEN`. Чтения хватает скоупа `metrika:read`, но `create-counter` и `delete-counter` без `metrika:write` получат 403 — причём в момент вызова, а не при настройке. Токен можно получить интерактивно: `node packages/yandex-metrika-mcp/src/index.mjs auth` открывает браузер и возвращает токен. Если нужен доступ только на чтение, скоуп задаётся через `YANDEX_METRIKA_SCOPE="metrika:read"`.

\`delete-counter` необратим, поэтому требует `confirm: true` в аргументах — без него инструмент возвращает ошибку и ничего не отправляет в API. Строка `"true"`, число 1 и `"yes"` не считаются. Пакет опубликован как `@stufently/yandex-metrika-mcp`; имя без скоупа принадлежит другому издателю, поэтому берите именно это. Отчёты по умолчанию охватывают последние 30 дней.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `YANDEX_METRIKA_TOKEN` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add yandex-metrika-mcp -e YANDEX_METRIKA_TOKEN=<YANDEX_METRIKA_TOKEN> -- npx -y @stufently/yandex-metrika-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add yandex-metrika-mcp --env YANDEX_METRIKA_TOKEN=<YANDEX_METRIKA_TOKEN> -- npx -y @stufently/yandex-metrika-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "yandex-metrika-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@stufently/yandex-metrika-mcp"
            ],
            "env": {
                "YANDEX_METRIKA_TOKEN": "<YANDEX_METRIKA_TOKEN>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "yandex-metrika-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@stufently/yandex-metrika-mcp"
            ],
            "env": {
                "YANDEX_METRIKA_TOKEN": "<YANDEX_METRIKA_TOKEN>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e YANDEX_METRIKA_TOKEN=<YANDEX_METRIKA_TOKEN> yandex-metrika-mcp npx -y @stufently/yandex-metrika-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- спросить у агента, сколько визитов было на сайте за месяц
- разобрать источники трафика и найти просевшие каналы
- посмотреть, из каких городов приходят пользователи
- выгрузить топ поисковых фраз без захода в веб-интерфейс
- собрать свой отчёт по метрикам и измерениям Метрики

## Примеры запросов агенту
- Покажи сводку по трафику счётчика 12345 за последние 30 дней
- Какие источники дали больше всего визитов на прошлой неделе?
- Выполни `get-report` по счётчику 12345 с метрикой `ym:s:visits` и измерением `ym:s:trafficSource`

## Похожие
- [labelhead-artist-momentum](https://affpapa.org/nevibecode/mcp/labelhead-artist-momentum.md) — MCP-сервер · ★ 107423
- [openshorts](https://affpapa.org/nevibecode/mcp/openshorts.md) — MCP-сервер · ★ 7049
- [OpenScreen](https://affpapa.org/nevibecode/mcp/openscreen.md) — MCP-сервер · ★ 4863
- [Usertour MCP Server](https://affpapa.org/nevibecode/mcp/usertour-mcp-server.md) — MCP-сервер · ★ 2326
- [Appllama](https://affpapa.org/nevibecode/mcp/appllama.md) — MCP-сервер · ★ 3046
- [obsei](https://affpapa.org/nevibecode/mcp/obsei.md) — MCP-сервер · ★ 1441

Из того же набора: [stufently/yandex-mcp](https://affpapa.org/nevibecode/by/stufently/yandex-mcp.md) — 5 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md