yandex-direct-metrica-mcp
MCP-сервер для аналитики Директа, Метрики, Wordstat и Аудиторий: сырые отчеты, сопоставление данных и HTML-дашборд
Установка
python3 scripts/setup.pyИнтерактивный мастер в клоне репозитория.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту два уровня инструментов. Низкоуровневые вызовы отдают почти необработанные данные API Директа, Метрики, Wordstat, Аудиторий и выдачи Поиска. Высокоуровневые помогают с типовыми отчетами, сопоставляют расходы Директа с визитами Метрики по UTM и yclid, подсказывают ключевые фразы и собирают автономный дашборд в HTML и JSON, в том числе по нескольким аккаунтам. Публичная сборка работает только на чтение и не меняет кампании, цели и сегменты.
Для кого. Для маркетологов, аналитиков и агентств, которым нужны отчеты по нескольким рекламным аккаунтам Яндекса через агента.
Подходит, если
- Нужен дашборд расходов и конверсий по всем аккаунтам за месяц
- Нужно связать расходы Директа с визитами и целями Метрики
- Нужно выгрузить сырые данные для своего анализа без риска изменить кампании
Не подходит, если
- Нужно создавать или редактировать кампании: публичная версия только читает
- Нет Docker и нет желания собирать образ
Пример запроса к агенту
Сгенерируй дашборд по всем аккаунтам за последние 30 дней по вчерашний день и дай путь к HTMLОграничения
Нужны OAuth-токены Директа и Метрики, для Аудиторий и Wordstat отдельные учетные данные. Основной способ запуска через Docker с папкой состояния и файлом accounts.json. Синхронизация данных для BI вынесена в платный закрытый плагин. Данные за текущий день обычно неполные, автор советует брать период до вчерашнего дня.
Как отключить. Удалите сервер командой claude mcp remove yandex-direct-metrica-mcp и папку состояния с .env.
MCP
- Транспорт
- stdio
- Авторизация
- OAuth
| Переменные окружения | |
|---|---|
| YANDEX_ACCESS_TOKEN обязательная, секрет | OAuth-токен Директа и Метрики, можно YANDEX_REFRESH_TOKEN |
| MCP_ACCOUNTS_FILE | Путь к accounts.json со списком аккаунтов |
| MCP_CONTENT_MODE | json для анализа сырых данных |
Проверка безопасности
- Использует OAuth-токены рекламных аккаунтов
- Публичная сборка только читает данные, но выгружает их в локальные файлы
Коротко о README
README предлагает мастер настройки для Claude Code, Claude Desktop, Cursor, Codex CLI, OpenCode и Gemini CLI и ручной путь с Docker-образом из GHCR. Подробно объяснено, что разрешено в режиме только чтения, описаны два слоя инструментов и платный плагин для BI. Отдельно перечислены переменные окружения, есть документация на русском на сайте проекта. Лицензия Apache 2.0.
Частые вопросы
Что значит режим только чтения?
Сервер не создает, не меняет и не удаляет кампании, цели и сегменты. Запросы отчетов Wordstat и выгрузки Logs API Метрики при этом разрешены.
Можно ли вести несколько клиентов?
Да, аккаунты перечисляются в accounts.json с логином Директа и счетчиками Метрики, дашборд строится по всем сразу.
Похожие
Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов
Набор скиллов Claude Code для аудита сайта под AI-поиск: цитируемость, доступ AI-краулеров, llms.txt, разметка и отчеты
Экспериментальный официальный MCP-сервер Google Analytics 4: отчеты, воронки и данные реального времени по запросу агенту
Google Search Console MCP
Google Search Console MCP Server for SEOs
MCP-сервер для Google Search Console: запросы и страницы с кликами и позициями, проверка индексации URL, сайтмапы и готовые SEO-скиллы