Skip to content
Back to search

mcp-yandex-metrica

MCP server for Yandex Metrica — counters, goals, statistics (Svedum OAuth)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/svedum--mcp-yandex-metrica/badge.svg)](/listings/svedum--mcp-yandex-metrica)

HTML

<a href="/listings/svedum--mcp-yandex-metrica"><img src="/api/listings/svedum--mcp-yandex-metrica/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx -y @svedum/mcp-yandex-metrica@0.1.1

Внешний MCP-клиент

{
  "mcpServers": {
    "yandex-metrica": {
      "command": "npx",
      "args": ["-y", "@svedum/mcp-yandex-metrica@0.1.1"],
      "env": {
        "YANDEX_METRIKA_TOKEN": "<OAuth access token, scope metrika:read>"
      }
    }
  }
}

Токен: [OAuth Яндекс ID](https://yandex.ru/dev/id/doc/ru/) с доступом к Метрике (`metrika:read` или шире). Без токена сервер стартует, но инструменты данных вернут ошибку подключения.

Сведум

Плагин каталога подключает Яндекс через **Персонализация → Подключения**. Платформа хранит refresh-токен и перед каждым вызовом MCP записывает во временный файл только `access_token` (и `expiry_date`). Путь передаётся в `PLUGIN_OAUTH_CREDENTIALS_PATH`. Переподключение — в интерфейсе Сведума, не через инструменты MCP.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 82 lines
  1. # `@svedum/mcp-yandex-metrica`
  2. MCP-сервер для [Яндекс Метрики](https://metrika.yandex.ru): счётчики, цели, отчёты по
  3. визитам, источникам и конверсиям. Работает по stdio — в [Сведуме](https://svedum.ru),
  4. Cursor, Claude Desktop и любом MCP-клиенте.
  5. Форк [askads/mcp-yandex-metrica](https://github.com/askads/mcp-yandex-metrica) под схему
  6. OAuth Сведума (файл `PLUGIN_OAUTH_CREDENTIALS_PATH`, без in-chat login и без телеметрии
  7. Ask Ads).
  8. ## Установка
  9. ```bash
  10. npx -y @svedum/mcp-yandex-metrica@0.1.1
  11. ```
  12. ### Внешний MCP-клиент
  13. ```json
  14. {
  15. "mcpServers": {
  16. "yandex-metrica": {
  17. "command": "npx",
  18. "args": ["-y", "@svedum/mcp-yandex-metrica@0.1.1"],
  19. "env": {
  20. "YANDEX_METRIKA_TOKEN": "<OAuth access token, scope metrika:read>"
  21. }
  22. }
  23. }
  24. }
  25. ```
  26. Токен: [OAuth Яндекс ID](https://yandex.ru/dev/id/doc/ru/) с доступом к Метрике
  27. (`metrika:read` или шире). Без токена сервер стартует, но инструменты данных вернут
  28. ошибку подключения.
  29. ### Сведум
  30. Плагин каталога подключает Яндекс через **Персонализация → Подключения**. Платформа
  31. хранит refresh-токен и перед каждым вызовом MCP записывает во временный файл только
  32. `access_token` (и `expiry_date`). Путь передаётся в `PLUGIN_OAUTH_CREDENTIALS_PATH`.
  33. Переподключение — в интерфейсе Сведума, не через инструменты MCP.
  34. ## Инструменты
  35. | Инструмент | Назначение |
  36. |------------|------------|
  37. | `auth_status` | Статус токена (без сети) |
  38. | `list_counters` | Список счётчиков |
  39. | `list_goals` | Цели счётчика |
  40. | `get_statistics` | Отчёт Stat API |
  41. | `raw_request` | Произвольный запрос к API Метрики (POST/DELETE — с `confirmWrite`) |
  42. Инструменты `start_login`, `finish_login` и `logout` из upstream **удалены** — вход только
  43. через Сведум или `YANDEX_METRIKA_TOKEN`.
  44. Специализированные инструменты — только чтение; запись возможна только через
  45. `raw_request` с явным подтверждением.
  46. ## Переменные окружения
  47. | Переменная | Описание |
  48. |------------|----------|
  49. | `YANDEX_METRIKA_TOKEN` | OAuth access token (внешние клиенты) |
  50. | `PLUGIN_OAUTH_CREDENTIALS_PATH` | JSON с `access_token` / `expiry_date` (Сведум) |
  51. | `YANDEX_METRIKA_COUNTER_ID` | Счётчик по умолчанию |
  52. | `YANDEX_METRIKA_LANG` | Язык подписей (`ru` по умолчанию) |
  53. ## Разработка
  54. ```bash
  55. npm install
  56. npm run build
  57. npm start
  58. ```
  59. ## Происхождение и лицензия
  60. Исходный код и идея инструментов — [askads/mcp-yandex-metrica](https://github.com/askads/mcp-yandex-metrica),
  61. автор Aleksandr Kovalko, лицензия **MIT** (см. [LICENSE](./LICENSE)).
  62. Доработка OAuth и публикация `@svedum/*` — [Svedum](https://svedum.ru), MIT.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.