Yandex Metrika MCP

Name: Yandex Metrika MCP
Author: expremiental

远程服务

github.com/expremiental数据与分析118 周前更新

代码仓库

关于 Yandex Metrika MCP

Yandex Metrika MCP 是只读分析服务，让用户通过自然语言查询 Yandex Metrika 数据，适合需要直接在 MCP 客户端中查看网站指标的人。它提供托管连接方式，也可使用自有令牌自托管。

主要功能

01查询访问量、用户数和页面浏览量
02按来源、设备、地域和 UTM 分组
03设置日期范围、筛选、排序和行数上限
04列出令牌可访问的统计计数器
05只读访问 Metrika 数据

适用场景

01查询本周访问量和用户数
02比较指定月份的流量来源
03查看移动设备访问占比

MCP 相关

作为 MCP 服务，提供列出 Yandex Metrika 计数器及执行 Reporting API 查询的工具。只读访问，可通过托管 HTTP 服务连接，也可本地运行并配置令牌。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://mcp.getaiaiai.ru/yandex-metrika

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http expremiental-yandex-metrika https://mcp.getaiaiai.ru/yandex-metrika

Cursor.cursor/mcp.json{"mcpServers":{"expremiental-yandex-metrika":{"type":"http","url":"https://mcp.getaiaiai.ru/yandex-metrika"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"expremiental-yandex-metrika":{"type":"http","url":"https://mcp.getaiaiai.ru/yandex-metrika"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"expremiental-yandex-metrika":{"type":"http","url":"https://mcp.getaiaiai.ru/yandex-metrika"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"expremiental-yandex-metrika":{"serverUrl":"https://mcp.getaiaiai.ru/yandex-metrika"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

yandex-metrika-mcp

直接在 Claude 中用日常语言查询 Yandex Metrika 分析数据。“这周有多少次访问？”，“6 月的主要流量来源”，“今天的移动设备占比是多少？”——助手会查询 Metrika 并直接回答。无需仪表板、无需 SQL，也无需管理 API 密钥。

由 aiaiai 开源——我们打造自己教授的内容。

直接用日常语言询问Яндекс.Метрика，就在 Claude 中操作。“这周有多少次访问？”，“6 月的主要流量来源”，“移动设备占比是多少？”——助手会自动查询 Метрика 并回答。无需仪表板。

用日常语言询问受众的地理分布——Agent 自动根据实时的 Яндекс.Метрика 数据生成地图

兼容平台

Claude.ai · Claude Code · Claude Desktop · Cursor · 任何兼容 MCP 的客户端

一分钟内完成连接（托管服务）

无需安装——连接到托管服务即可。

Claude.ai（设置 → 连接器 → 添加）：

https://mcp.getaiaiai.ru/yandex-metrika

点击连接 → 使用 Yandex 登录 → 授予访问权限。

Claude Code CLI：

claude mcp add --transport http yandex-metrika https://mcp.getaiaiai.ru/yandex-metrika/
claude mcp login yandex-metrika

浏览器窗口将打开 → 使用 Yandex 登录 → 完成。在无头环境或 SSH 环境中：在 mcp login 中添加 --no-browser，并在提示时粘贴重定向 URL。

Claude Desktop / Cursor — 添加到 mcpServers：

{
  "mcpServers": {
    "yandex-metrika": {
      "type": "http",
      "url": "https://mcp.getaiaiai.ru/yandex-metrika/"
    }
  }
}

无需注册应用，也无需管理令牌。只读——服务绝不会写入你的 Metrika 账户。

Подключение на русском

Claude.ai (Настройки → Коннекторы → Добавить):

https://mcp.getaiaiai.ru/yandex-metrika

Нажмите Подключить → войдите через Яндекс → разрешите доступ.

Claude Code CLI:

claude mcp add --transport http yandex-metrika https://mcp.getaiaiai.ru/yandex-metrika/
claude mcp login yandex-metrika

Откроется браузер → войти через Яндекс → готово.

工具

工具	说明
`list_counters`	列出令牌可访问的所有 Yandex Metrika 计数器（ID、名称、网站）
`query`	运行 Reporting API 查询——访问量、用户数、页面浏览量、跳出率、流量来源、设备、地理位置、UTM 等

`query` 参数

参数	默认值	说明
`counter_id`	必填	`list_counters` 返回的计数器 ID
`metrics`	必填	逗号分隔的指标，例如 `ym:s:visits,ym:s:users`
`dimensions`	—	分组字段：`ym:s:date`、`ym:s:lastTrafficSource`、`ym:s:deviceCategory`、…
`date1` / `date2`	`7daysAgo` / `today`	日期范围：`YYYY-MM-DD` 或相对日期（`today`、`yesterday`、`NdaysAgo`）
`filters`	—	筛选表达式，例如 `ym:s:deviceCategory=='mobile'`
`sort`	—	排序字段；前缀 `-` 表示降序，例如 `-ym:s:visits`
`limit`	`100`	返回的最大行数

常用指标：ym:s:visits、ym:s:users、ym:s:pageviews、ym:s:bounceRate、ym:s:avgVisitDurationSeconds、ym:s:newUsers

常用维度：ym:s:date、ym:s:lastTrafficSource、ym:s:startURL、ym:s:deviceCategory、ym:s:regionCountry、ym:s:lastsourceUTMSource

使用自己的令牌自行托管

面向开发者 — 在本地运行引擎，全面掌控自己的数据。

需要 Python 3.10+ 和 uv。

git clone https://github.com/expremiental/yandex-metrika-mcp.git
cd yandex-metrika-mcp
uv sync

获取令牌。 前往 oauth.yandex.ru，创建应用（平台：“Web 服务”），启用 Yandex Metrika → 读取统计数据（metrika:read），然后获取 OAuth 令牌：

export YANDEX_METRIKA_TOKEN="<your-token>"

连接（Claude Desktop / Cursor — 添加到 mcpServers）：

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "uv",
      "args": ["run", "yandex-metrika-mcp"],
      "env": { "YANDEX_METRIKA_TOKEN": "<your-token>" }
    }
  }
}

通过 HTTP 运行：

MCP_TRANSPORT=http PORT=8000 uv run yandex-metrika-mcp
# endpoint: http://localhost:8000/mcp

嵌入自己的后端。 引擎接受可注入的异步令牌解析器 — 可将其包装在自己的身份验证逻辑中：

from yandex_metrika_mcp import build_server

async def my_token_resolver() -> str:
    return "<metrika:read token>"

build_server(token_resolver=my_token_resolver).run(transport="stdio")

公开 API：build_server、YandexMetrikaClient、TokenResolver、env_token_resolver、main。