MCP аналитики Яндекс Метрики на 31 инструмент

Установка

npx skillfoxx add mcp/ya-metrics-mcp

claude mcp add --transport stdio --env 'YANDEX_API_KEY=<ваш YANDEX_API_KEY>' ya-metrics -- uvx ya-metrics-mcp

{
  "mcpServers": {
    "ya-metrics": {
      "command": "uvx",
      "args": [
        "ya-metrics-mcp"
      ],
      "env": {
        "YANDEX_API_KEY": "<ваш YANDEX_API_KEY>"
      }
    }
  }
}

{
  "mcpServers": {
    "ya-metrics": {
      "command": "uvx",
      "args": [
        "ya-metrics-mcp"
      ],
      "env": {
        "YANDEX_API_KEY": "<ваш YANDEX_API_KEY>"
      }
    }
  }
}

code --add-mcp '{"name":"ya-metrics","type":"stdio","command":"uvx","args":["ya-metrics-mcp"],"env":{"YANDEX_API_KEY":"<ваш YANDEX_API_KEY>"}}'

{
  "servers": {
    "ya-metrics": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ya-metrics-mcp"
      ],
      "env": {
        "YANDEX_API_KEY": "<ваш YANDEX_API_KEY>"
      }
    }
  }
}

codex mcp add ya-metrics --env 'YANDEX_API_KEY=<ваш YANDEX_API_KEY>' -- uvx ya-metrics-mcp

[mcp_servers.ya-metrics]
command = "uvx"
args = ["ya-metrics-mcp"]
env = { YANDEX_API_KEY = "<ваш YANDEX_API_KEY>" }

gemini mcp add -s user -e 'YANDEX_API_KEY=<ваш YANDEX_API_KEY>' ya-metrics uvx ya-metrics-mcp

{
  "mcpServers": {
    "ya-metrics": {
      "command": "uvx",
      "args": [
        "ya-metrics-mcp"
      ],
      "env": {
        "YANDEX_API_KEY": "<ваш YANDEX_API_KEY>"
      }
    }
  }
}

{
  "mcpServers": {
    "ya-metrics": {
      "command": "uvx",
      "args": [
        "ya-metrics-mcp"
      ],
      "env": {
        "YANDEX_API_KEY": "<ваш YANDEX_API_KEY>"
      }
    }
  }
}

{
  "mcpServers": {
    "ya-metrics": {
      "command": "uvx",
      "args": [
        "ya-metrics-mcp"
      ],
      "env": {
        "YANDEX_API_KEY": "<ваш YANDEX_API_KEY>"
      }
    }
  }
}

{
  "mcpServers": {
    "ya-metrics": {
      "command": "uvx",
      "args": [
        "ya-metrics-mcp"
      ],
      "env": {
        "YANDEX_API_KEY": "<ваш YANDEX_API_KEY>"
      }
    }
  }
}

{
  "mcp": {
    "ya-metrics": {
      "type": "local",
      "command": [
        "uvx",
        "ya-metrics-mcp"
      ],
      "environment": {
        "YANDEX_API_KEY": "<ваш YANDEX_API_KEY>"
      }
    }
  }
}

{
  "context_servers": {
    "ya-metrics": {
      "command": "uvx",
      "args": [
        "ya-metrics-mcp"
      ],
      "env": {
        "YANDEX_API_KEY": "<ваш YANDEX_API_KEY>"
      }
    }
  }
}

{
  "mcpServers": {
    "ya-metrics": {
      "command": "uvx",
      "args": [
        "ya-metrics-mcp"
      ],
      "env": {
        "YANDEX_API_KEY": "<ваш YANDEX_API_KEY>"
      }
    }
  }
}

{
  "mcpServers": {
    "ya-metrics": {
      "command": "uvx",
      "args": ["ya-metrics-mcp"],
      "env": {
        "YANDEX_API_KEY": "your_oauth_token"
      }
    }
  }
}

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер дает 31 инструмент по семи направлениям аналитики Яндекс Метрики. Счетчики и аккаунт: список счетчиков и целей, метаданные счетчика. Трафик и источники: визиты, сводка по источникам, поисковые фразы, типы источников, данные по поисковым системам, новые пользователи по источнику. Контент-аналитика для интеграции с Дзен и Турбо: источники, категории, авторы, темы, статьи. Демография и устройства: возраст, пол, устройство, браузер и ОС, глубина просмотра. География: трафик по городам и странам. Производительность и конверсии: отказы и длительность по странице входа, конверсия по целям, SEO-эффективность, конверсия по источнику и посадочной странице. Продвинутые и drill-down отчеты: e-commerce покупки, временные ряды, A/B эксперименты Директа, browser-отчет, иерархический drill-down и сравнение сегментов. Все инструменты read-only и требуют только права metrika:read, многие принимают параметр limit, чтобы не переполнять контекст агента большими выгрузками.

Для кого. Для маркетологов и аналитиков, которым нужна широкая read-only аналитика Яндекс Метрики без риска что-то изменить в счетчике.

Пример запроса к агенту

Сравни мобильных и десктопных пользователей за этот месяц для счетчика 12345678

Ограничения

Нужен OAuth-токен только с правом metrika:read, но управление счетчиком через сервер недоступно вообще. Контент-аналитика работает только при интеграции Яндекс Дзен или Турбо на счетчике, e-commerce отчет требует включенного отслеживания покупок. Пакет распространяется через uvx или запуск из исходников, отдельного релиза для pip README не упоминает.

Как отключить. Удалите сервер из конфигурации MCP клиента и отзовите OAuth-токен на oauth.yandex.ru.

MCP

Транспорт

stdio

Авторизация

API-ключ

Проверка безопасности

• Читает коммерчески чувствительные данные о трафике, конверсиях и продажах
• Токен OAuth дает доступ ко всем счетчикам аккаунта в рамках права metrika:read

Коротко о README

README на английском с версией на русском в отдельном файле описывает сервер как экспонирующий 31 инструмент по семи доменам аналитики. Даны шаги получения OAuth-токена с единственным правом metrika:read, конфигурация для Claude Desktop и Cursor через uvx или запуск из исходников через uv run. Инструменты сгруппированы по таблицам: аккаунт и счетчики, трафик и источники, контент-аналитика с пометкой о требовании интеграции Дзен и Турбо, демография и устройства, география, производительность и конверсия, продвинутые и drill-down отчеты. Отдельно описан параметр limit для контроля размера ответа и таблица переменных окружения для таймаутов и повторов запросов.

Похожие