yandex-direct-metrica-mcp
MCP-сервер для аналитики Директа, Метрики, Wordstat и Аудиторий: сырые отчеты, сопоставление данных и HTML-дашборд
- 9 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Использует OAuth-токены рекламных аккаунтов
- Публичная сборка только читает данные, но выгружает их в локальные файлы
Установка
- Работает в
- Сервисы
Ручная установка
python3 scripts/setup.pyИнтерактивный мастер в клоне репозитория.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Использует OAuth-токены рекламных аккаунтов
- Публичная сборка только читает данные, но выгружает их в локальные файлы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту два уровня инструментов. Низкоуровневые вызовы отдают почти необработанные данные API Директа, Метрики, Wordstat, Аудиторий и выдачи Поиска. Высокоуровневые помогают с типовыми отчетами, сопоставляют расходы Директа с визитами Метрики по UTM и yclid, подсказывают ключевые фразы и собирают автономный дашборд в HTML и JSON, в том числе по нескольким аккаунтам. Публичная сборка работает только на чтение и не меняет кампании, цели и сегменты.
Для кого. Для маркетологов, аналитиков и агентств, которым нужны отчеты по нескольким рекламным аккаунтам Яндекса через агента.
Подходит, если
- Нужен дашборд расходов и конверсий по всем аккаунтам за месяц
- Нужно связать расходы Директа с визитами и целями Метрики
- Нужно выгрузить сырые данные для своего анализа без риска изменить кампании
Не подходит, если
- Нужно создавать или редактировать кампании: публичная версия только читает
- Нет Docker и нет желания собирать образ
Пример запроса к агенту
Сгенерируй дашборд по всем аккаунтам за последние 30 дней по вчерашний день и дай путь к HTMLMCP
- Транспорт
- stdio
- Авторизация
- OAuth
Переменные окружения
YANDEX_ACCESS_TOKENобязательная, секрет- OAuth-токен Директа и Метрики, можно YANDEX_REFRESH_TOKEN
MCP_ACCOUNTS_FILE- Путь к accounts.json со списком аккаунтов
MCP_CONTENT_MODE- json для анализа сырых данных
Ограничения
Нужны OAuth-токены Директа и Метрики, для Аудиторий и Wordstat отдельные учетные данные. Основной способ запуска через Docker с папкой состояния и файлом accounts.json. Синхронизация данных для BI вынесена в платный закрытый плагин. Данные за текущий день обычно неполные, автор советует брать период до вчерашнего дня.
Как отключить. Удалите сервер командой claude mcp remove yandex-direct-metrica-mcp и папку состояния с .env.
Частые вопросы
Что значит режим только чтения?
Сервер не создает, не меняет и не удаляет кампании, цели и сегменты. Запросы отчетов Wordstat и выгрузки Logs API Метрики при этом разрешены.
Можно ли вести несколько клиентов?
Да, аккаунты перечисляются в accounts.json с логином Директа и счетчиками Метрики, дашборд строится по всем сразу.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер для Яндекс Директа, Метрики, Wordstat и Вебмастера: кампании, объявления, ставки, отчеты и подбор запросов из чата
MCP-сервер от ZAI.ONE сводит Директ, Метрику, поиск, Wordstat и Вебмастер в одном агенте, с мастером настройки и включаемыми пишущими операциями
MCP для Директа, Метрики, Wordstat и Вебмастера
yandex-marketing-mcp
MCP-сервер на 155 инструментов для Яндекс Директа, Метрики, Wordstat и Вебмастера с самонастройкой OAuth и режимами read-only и confirm
MCP для Метрики и Директа с минус-фразами
Яндекс.Метрика + Директ MCP Server
MCP-сервер на 30 инструментов для Метрики и Директа: отчеты, ставки, объявления, управление минус-фразами и Wordstat
MCP-сервер Директа, Метрики, Wordstat и Вебмастера
Yandex MCP Server
MCP-сервер со 141 инструментом: полное управление кампаниями Директа, счетчиками и целями Метрики, Wordstat и Вебмастер
MCP-сервер для Яндекс Директа, Метрики, Аудиторий и Wordstat с режимом только чтения и подтверждением изменений
Коротко о README
README предлагает мастер настройки для Claude Code, Claude Desktop, Cursor, Codex CLI, OpenCode и Gemini CLI и ручной путь с Docker-образом из GHCR. Подробно объяснено, что разрешено в режиме только чтения, описаны два слоя инструментов и платный плагин для BI. Отдельно перечислены переменные окружения, есть документация на русском на сайте проекта. Лицензия Apache 2.0.