Yandex Metrika MCP Dev Crabs
MCP-сервер только для чтения: отчеты Яндекс Метрики с точными датами, часовым поясом и признаком семплирования.
- 130 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает отчеты Яндекс Метрики вашего аккаунта и передает их в ИИ-клиент и поставщику модели.
- Хранит токен доступа к Метрике в системном хранилище учетных данных.
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/yandex-metrika-mcp-dev-crabsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает отчеты Яндекс Метрики вашего аккаунта и передает их в ИИ-клиент и поставщику модели.
- Хранит токен доступа к Метрике в системном хранилище учетных данных.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает Claude, Cursor, VS Code, Codex и другие MCP-клиенты к Яндекс Метрике и отвечает на вопросы о трафике, источниках, посадочных страницах и целях. Каждый ответ содержит точные даты, часовой пояс счетчика, признак семплирования, фильтры и происхождение данных, поэтому цифры можно проверить. Календарные периоды берутся в часовом поясе счетчика, по умолчанию учитываются только полные дни, а при строгом режиме сервер отказывается от семплированных данных. Всего 13 инструментов и три промпта (`weekly_review`, `traffic_drop`, `landing_conversion`). Среди них отчет за период, сравнение двух периодов, временные ряды и фоновая полная выгрузка в CSV или JSON с контрольными суммами и возобновлением после перезапуска. Вход выполняется через браузер, свое OAuth-приложение и вставка токена в чат не нужны.
Для кого. Маркетологам и аналитикам, которые спрашивают у ассистента про трафик сайта и хотят видеть, как посчитаны числа.
Подходит, если
- Нужно сравнить две последние полные недели по визитам и по достижению цели.
- Требуется понять, какие посадочные страницы принесли больше всего заявок за месяц.
- Трафик упал, и нужен разбор по промпту `traffic_drop` с проверяемыми цифрами.
- Нужна полная выгрузка источников трафика за октябрь в CSV для Excel.
Не подходит, если
- Нужно менять настройки счетчика или создавать цели: сервер только читает.
- Нужен свободный запрос к API Метрики: произвольного HTTP-инструмента нет.
- Нужна старая версия Node.js: требуется 22.13 или новее.
Пример запроса к агенту
Подключи Яндекс Метрику и сравни две последние полные недели по источникам трафика.MCP
- Транспорт
- stdio
- Авторизация
- OAuth
Ограничения
Сервер только читает данные: записывающих методов и произвольного HTTP-инструмента в нем нет. Нужен Node.js 22.13 или новее. Токен хранится в системном хранилище учетных данных (macOS Keychain, Windows Credential Manager, Linux Secret Service), а без него сервер откажется сохранять токен, пока вы явно не выберете незашифрованный файл с правами только для пользователя. Отчеты, которые вы запрашиваете, попадают в ваш ИИ-клиент и к поставщику модели, токены не попадают. Покрытие тестами идет на синтетических данных и имитации API, живой вход проверен на macOS, остальные клиенты и платформы описаны в `docs/release-checklist.md`.
Как отключить. Вызовите инструмент `metrika_disconnect`, он локально удаляет подключение и токен. Затем уберите сервер из конфигурации клиента, для Claude Code командой `claude mcp remove yandex-metrika`.
Частые вопросы
Как подключить Яндекс Метрику к Claude Code?
Выполните `claude mcp add --scope user yandex-metrika -- npx -y @dev-crabs/yandex-metrika-mcp`, перезапустите клиент и попросите ассистента подключить Метрику. Он вызовет `metrika_connect` и выдаст локальную ссылку для входа.
Нужен ли свой ключ API или OAuth-приложение?
Нет, после установки вход выполняется через браузер, а токен не попадает в чат. Без аккаунта сервер можно опробовать на синтетическом подключении `conn_demo`.
Как сервер работает с семплированием?
Строгий режим отказывается от семплированных данных и не выдает их за точные. Итоги берутся из ответа API, суммы по видимым строкам не используются.
Можно ли выгрузить все строки отчета?
Да, `metrika_export_report` запускает фоновую выгрузку в CSV или JSON с контрольными суммами и манифестом. Статус смотрят через `metrika_get_job`, а прерванную выгрузку можно продолжить после перезапуска.
Как установить сервер в Cursor или VS Code?
Выполните `npx -y @dev-crabs/yandex-metrika-mcp setup --client cursor` или другой клиент из списка: claude-desktop, claude-code, vscode, windsurf, codex. Есть и кнопки установки в один клик для Cursor и VS Code.
Обсуждение
Вопросов и отзывов пока нет.
Yandex Metrica MCP
yandex-metrica-mcp
MCP-сервер для Яндекс Метрики только на чтение: отчеты, сравнение периодов, цели и выгрузка сырых логов с входом через браузер
Yandex Metrika MCP
Yandex Metrika MCP Server
MCP-сервер для отчетов Яндекс Метрики: трафик, источники, поисковые фразы, цели, география, устройства и контент-аналитика
MCP Яндекс Метрики с управлением счетчиками
@theyahia/yandex-metrika-mcp
MCP-сервер Яндекс Метрики на 15 инструментов: отчеты и трафик плюс создание, изменение и удаление счетчиков и целей
Яндекс Метрика MCP: отчеты и цели в Claude, Cursor, Codex
mcp-yandex-metrica
MCP-сервер Метрики на npx с входом через Яндекс OAuth прямо в чате: счетчики, цели, отчеты по визитам и конверсиям, обычные запросы только на чтение
MCP-сервер Яндекс Метрики только для чтения
yandex-metrika-mcp
Минималистичный MCP на Python: 12 инструментов только для чтения по правильному заголовку OAuth и парный скилл с методикой сравнения периодов
MCP Яндекс Метрики со всеми 108 методами API
Yandex Metrika MCP Server
MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Yandex Metrika MCP Dev Crabs (эта карточка) | нет | OAuth | 130 | |
| Yandex Metrica MCP | нет | ключ необязателен | 15 | другой read-only MCP для Метрики с выгрузкой сырых данных; здесь вход через браузер, строгий режим семплирования и возобновляемая выгрузка |
| Яндекс Метрика MCP: отчеты и цели в Claude, Cursor, Codex | нет | OAuth | 5 | MCP на npx с входом через OAuth в чате; здесь токен не попадает в чат, а каждый ответ несет даты и признак семплирования |
Коротко о README
README объясняет, чем сервер отличается точностью данных и безопасным входом, дает команды установки для шести клиентов, примеры вопросов и таблицу инструментов. Раздел о данных и приватности говорит, где хранятся токены, а русская документация лежит в `README.ru.md` и `docs/ru`.