Yandex Metrika MCP

yandex-metrika-mcp

Claude から直接、自然な言葉で Yandex Metrika の分析データを検索できます。「今週の訪問数は？」「6月の主なトラフィックソースは？」「今日のモバイルの割合は？」といった質問に、アシスタントが Metrika に問い合わせて回答します。ダッシュボードも、SQL も、管理が必要な API キーもありません。

aiaiai によるオープンソースプロジェクトです。私たちは教えている内容を自分たちで開発しています。

Yandex Metrikaについて、Claude で直接、普段使う言葉で質問できます。「1週間の訪問数は？」「6月の主なトラフィックソースは？」「モバイルの割合は？」といった質問に、アシスタントが Metrika に問い合わせて回答します。ダッシュボードは不要です。

対応クライアント

Claude.ai  ·  Claude Code  ·  Claude Desktop  ·  Cursor  ·  MCP 互換クライアント全般

1分で接続（ホスト型）

インストールは不要です。ホスト型サービスに接続してください。

Claude.ai（Settings → Connectors → Add）：

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

Connectをクリック → 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 アカウントに書き込むことはありません。

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

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

ツール

query のパラメーター

よく使われる指標：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

独自のトークンでセルフホスト

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

export YANDEX_METRIKA_TOKEN="<your-token>"

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

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")

ライセンス

MIT · aiaiai 製