yandex-metrika-mcp

Name: yandex-metrika-mcp
Author: theYahia

本地服务

github.com数据与分析18 周前更新

代码仓库访问官网

关于 yandex-metrika-mcp

yandex-metrika-mcp 为需要管理网站分析的用户提供 Yandex.Metrica API 工具，涵盖计数器、目标、报告、日志和流量分析。它支持 OAuth Bearer 令牌，并可通过 stdio 或 HTTP 使用。

主要功能

01管理计数器和目标
02生成并比较分析报告
03按维度逐层查看报告
04导出访问与点击原始日志
05查看流量来源和热门页面

适用场景

01列出网站的 Yandex.Metrica 计数器
02比较两个日期区间的流量
03查看网站热门页面及页面浏览量
04导出访问或点击日志

MCP 相关

该 MCP 服务向客户端提供 15 个 Yandex.Metrica API 工具，用于管理计数器和目标、报告分析及日志导出。支持 stdio 和 Streamable HTTP。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "theyahia-yandex-metrika": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/yandex-metrika-mcp"
      ]
    }
  }
}

启动命令npx -y @theyahia/yandex-metrika-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@theyahia/yandex-metrika-mcp2.1.1stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
field	string	否	要返回的字段，以逗号分隔（例如 'name,site,status'）
per_page	number	否	每页结果数（默认 100，最大 10000）
search_string	string	否	按名称或网站 URL 子字符串筛选计数器

详细介绍

@theyahia/yandex-metrika-mcp

适用于 Yandex.Metrica API 的 MCP 服务——统计代码、目标、报告、日志、流量来源和热门页面。包含 15 个工具，使用 OAuth Bearer 令牌进行身份验证。

这是 @theYahia 推出的 Russian API MCP 系列的一部分。

获取令牌

前往 oauth.yandex.ru
创建应用（或使用现有应用）
在 Platforms 下，选择“Web services”
在 Access 下，添加：Yandex.Metrica -> Read statistics and counter parameters

获取 OAuth 令牌：

https://oauth.yandex.ru/authorize?response_type=token&client_id=YOUR_CLIENT_ID

从重定向 URL 中复制令牌（access_token=...）

安装

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "npx",
      "args": ["-y", "@theyahia/yandex-metrika-mcp"],
      "env": {
        "YANDEX_METRIKA_TOKEN": "your_token"
      }
    }
  }
}

Claude Code

claude mcp add yandex-metrika -e YANDEX_METRIKA_TOKEN=your_token -- npx -y @theyahia/yandex-metrika-mcp

Streamable HTTP（远程／多客户端）

YANDEX_METRIKA_TOKEN=your_token npx @theyahia/yandex-metrika-mcp --http --port=3000

端点：POST http://localhost:3000/mcp 健康检查：GET http://localhost:3000/health

Smithery

使用代码仓库中的 smithery.yaml。需要 YANDEX_METRIKA_TOKEN。

环境变量

变量	必需	描述
`YANDEX_METRIKA_TOKEN`	是	来自 Yandex OAuth 的 OAuth 2.0 Bearer 令牌

工具（15 个）

管理——统计代码

工具	描述
`list_counters`	列出所有统计代码。使用 `search_string` 按名称／URL 筛选。
`get_counter`	按 ID 获取单个统计代码的完整详情。
`create_counter`	为网站创建统计代码。
`update_counter`	更新统计代码名称或网站 URL。
`delete_counter`	永久删除统计代码（不可撤销）。

管理——目标

工具	描述
`list_goals`	列出统计代码的所有目标。
`create_goal`	创建目标（url、number、step、action 类型）。
`delete_goal`	从统计代码中删除目标。

管理——日志

工具	描述
`export_logs`	通过 Logs API 导出原始访问／点击日志。

Reporting API

工具	描述
`get_report`	灵活生成报告——支持任意指标、维度、筛选条件和排序。
`get_report_comparison`	比较两个日期区间（A 与 B）。
`get_report_drilldown`	按报告维度进行分层下钻分析。

便捷封装

工具	描述
`get_traffic_summary`	快速概览：访问量、页面浏览量、用户数、跳出率、平均时长。
`get_traffic_sources`	按渠道细分流量来源。
`get_top_pages`	按页面浏览量列出热门页面，并提供性能指标。

演示提示词

Show me all my Yandex.Metrica counters

Compare last week's traffic to the previous week for counter 12345678

What are the top 10 pages on my site this month, sorted by pageviews?

开发

npm install
npm run build
npm test
npm run dev           # stdio mode
npm run start:http    # HTTP mode on port 3000

API 参考

许可证

MIT

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。