1. Conduid
  2. Blockchain
  3. io.github.dontsovcmc/yandex-metrika
MCP server · Blockchain

io.github.dontsovcmc/yandex-metrika

· github.com/dontsovcmc/mcp-server-yandex-metrika

MCP server for Yandex Metrika API — counters, goals, reports, segments, logs

Unclaimed blockchain
InstallView source
37Low

Scored 5 months ago · breakdown

About io.github.dontsovcmc/yandex-metrika

io.github.dontsovcmc/yandex-metrika is an MCP server in the Blockchain category: mCP server for Yandex Metrika API — counters, goals, reports, segments, logs.

Install

uvx
uvx mcp-server-yandex-metrika
pip
pip install mcp-server-yandex-metrika

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about io.github.dontsovcmc/yandex-metrika

Powered by Claude · Grounded in docs

I know everything about io.github.dontsovcmc/yandex-metrika. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

mcp-server-yandex-metrika

Version

MCP-сервер для работы с API Яндекс Метрики через Claude Code, Claude Desktop и другие MCP-совместимые клиенты.

Все данные остаются на вашем компьютере — токен никуда не передаётся.

Возможности

Отчёты (Reporting API)

Инструмент CLI Описание
ym_stat_data stat-data Табличный отчёт по метрикам и измерениям
ym_stat_data_bytime stat-bytime Отчёт по времени (группировка: час/день/неделя/месяц)
ym_stat_data_drilldown stat-drilldown Drill down отчёт с раскрытием уровней
ym_stat_data_comparison stat-comparison Сравнение сегментов/периодов
ym_stat_data_comparison_drilldown — Сравнение с drill down

Счётчики

Инструмент CLI Описание
ym_counters counters Список счётчиков (поиск, фильтрация)
ym_counter counter Информация о счётчике
ym_counter_create counter-create Создать счётчик
ym_counter_update counter-update Изменить счётчик
ym_counter_delete counter-delete Удалить счётчик
ym_counter_undelete counter-undelete Восстановить удалённый

Цели

Инструмент CLI Описание
ym_goals goals Список целей счётчика
ym_goal goal Информация о цели
ym_goal_create goal-create Создать цель (url/number/step/action/...)
ym_goal_update — Изменить цель
ym_goal_delete goal-delete Удалить цель

Фильтры

Инструмент CLI Описание
ym_filters filters Список фильтров
ym_filter — Информация о фильтре
ym_filter_create filter-create Создать фильтр (IP, URL, реферер)
ym_filter_update — Изменить фильтр
ym_filter_delete filter-delete Удалить фильтр

Доступ (Grants)

Инструмент CLI Описание
ym_grants grants Список разрешений
ym_grant_create grant-create Выдать разрешение
ym_grant_update — Изменить разрешение
ym_grant_delete grant-delete Удалить разрешение

Операции

Инструмент CLI Описание
ym_operations operations Список операций
ym_operation — Информация об операции
ym_operation_create operation-create Создать операцию (cut_parameter, to_lower, ...)
ym_operation_update — Изменить операцию
ym_operation_delete operation-delete Удалить операцию

Сегменты

Инструмент CLI Описание
ym_segments segments Список сегментов
ym_segment — Информация о сегменте
ym_segment_create segment-create Создать сегмент
ym_segment_update — Изменить сегмент
ym_segment_delete segment-delete Удалить сегмент

Метки

Инструмент CLI Описание
ym_labels labels Список меток
ym_label_create label-create Создать метку
ym_label_update — Изменить метку
ym_label_delete label-delete Удалить метку
ym_counter_label_set — Привязать метку к счётчику
ym_counter_label_unset — Отвязать метку

Аккаунты и представители

Инструмент CLI Описание
ym_accounts accounts Список аккаунтов
ym_account_delete — Удалить аккаунт
ym_delegates delegates Список представителей
ym_delegate_add delegate-add Добавить представителя
ym_delegate_delete delegate-delete Удалить представителя

Примечания на графике

Инструмент CLI Описание
ym_chart_annotations chart-annotations Список примечаний
ym_chart_annotation_create chart-annotation-create Создать примечание
ym_chart_annotation_update — Изменить примечание
ym_chart_annotation_delete — Удалить примечание

Фильтры доступа

Инструмент CLI Описание
ym_access_filters — Список фильтров доступа
ym_access_filter_create — Создать фильтр доступа
ym_access_filter_update — Изменить фильтр доступа
ym_access_filter_delete — Удалить фильтр доступа

Logs API

Инструмент CLI Описание
ym_log_requests log-requests Список запросов логов
ym_log_request — Информация о запросе
ym_log_request_create log-request-create Создать запрос (hits/visits)
ym_log_request_evaluate log-request-evaluate Оценить возможность запроса
ym_log_request_clean — Очистить обработанные логи
ym_log_request_cancel — Отменить запрос
ym_log_request_download log-download Скачать часть лога (TSV)

Импорт данных

Инструмент CLI Описание
ym_offline_conversions_upload upload-conversions Загрузить оффлайн-конверсии
ym_offline_conversions_uploads — Список загрузок конверсий
ym_offline_conversion_upload_info — Инфо о загрузке
ym_calls_upload upload-calls Загрузить звонки
ym_calls_uploads — Список загрузок звонков
ym_calls_upload_info — Инфо о загрузке звонков
ym_expenses_upload upload-expenses Загрузить расходы
ym_user_params_upload — Загрузить параметры пользователей

Настройка

Шаг 1. Получить OAuth-токен Яндекс Метрики

  1. Зарегистрируйте приложение на oauth.yandex.com
  2. Укажите права: metrika:read, metrika:write
  3. Получите токен: https://oauth.yandex.com/authorize?response_type=token&client_id=<ваш_client_id>

Шаг 2. Подключить MCP-сервер

Claude Code (CLI в терминале)

Способ 1: через uvx (не требует установки пакета)

Требуется uv — если не установлен:

curl -LsSf https://astral.sh/uv/install.sh | sh

claude mcp add yandex-metrika \
  -e YANDEX_METRIKA_TOKEN=ваш_токен \
  -- uvx mcp-server-yandex-metrika

Способ 2: через pip

pip install mcp-server-yandex-metrika

claude mcp add yandex-metrika \
  -e YANDEX_METRIKA_TOKEN=ваш_токен \
  -- mcp-server-yandex-metrika

Claude Desktop

Добавьте в файл конфигурации (~/Library/Application Support/Claude/claude_desktop_config.json на macOS):

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "uvx",
      "args": ["mcp-server-yandex-metrika"],
      "env": {
        "YANDEX_METRIKA_TOKEN": "ваш_токен"
      }
    }
  }
}

Для удаления:

claude mcp remove yandex-metrika

Переменные окружения

Переменная Обязательная Описание
YANDEX_METRIKA_TOKEN Да OAuth-токен Яндекс Метрики

Примеры использования

Через Claude

«Покажи статистику по визитам за последнюю неделю для счётчика 12345678»

«Создай цель "Покупка" типа url с условием contain "/thank-you" для счётчика 12345678»

«Выгрузи логи визитов за январь 2024 для счётчика 12345678»

CLI

# Статистика визитов
mcp-server-yandex-metrika stat-data --ids 12345678 --metrics ym:s:visits,ym:s:users

# Список счётчиков
mcp-server-yandex-metrika counters --search "мой сайт"

# Цели счётчика
mcp-server-yandex-metrika goals 12345678

# Создать запрос логов
mcp-server-yandex-metrika log-request-create 12345678 \
  --date1 2024-01-01 --date2 2024-01-31 \
  --fields "ym:s:date,ym:s:visitID" --source visits

Лимиты API

  • 30 запросов/секунду на IP
  • 5000 запросов/день на пользователя
  • 3 параллельных запроса на пользователя
  • 200 запросов/5 минут для /stat/v1/data/
  • HTTP 420 при превышении лимитов

Лицензия

MIT

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About io.github.dontsovcmc/yandex-metrika

How do I install io.github.dontsovcmc/yandex-metrika?

Run uvx mcp-server-yandex-metrika, then add the server to your MCP client's configuration.

Is io.github.dontsovcmc/yandex-metrika safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is io.github.dontsovcmc/yandex-metrika still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.