yandex-metrika-mcp

@theyahia/yandex-metrika-mcp

Yandex.Metrica API 用の MCP サーバーです。カウンター、目標、レポート、ログ、トラフィックソース、トップページに対応しています。ツールは 15 個で、OAuth Bearer トークン認証を使用します。

@theYahia による Russian API MCP シリーズの一部です。

トークンの取得

1. oauth.yandex.ru にアクセスします
2. アプリを作成します（または既存のアプリを使用します）
3. Platforms で「Web services」を選択します
4. Access で Yandex.Metrica -> Read statistics and counter parameters を追加します
5. OAuth トークンを取得します：

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

6. リダイレクト 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	2 つの期間（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 リファレンス

• Yandex.Metrica Management API
• Yandex.Metrica Reporting API
• Yandex.Metrica Logs API

ライセンス

MIT