概要
AI で Yandex Metrica のアクセス解析データを分析します。カウンター、目標、フィルター、セグメント、訪問・流入元・ページ・コンバージョンに関する表形式、時系列、ドリルダウン、比較のレポート、そして Logs API による訪問とヒットの生データを扱います。
ガイド付きセットアップ
Yandex Metrica を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Yandex Metrica を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Yandex Metrica のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Yandex Metrica をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Yandex Metrica
AI で Yandex Metrica のアクセス解析データを分析します。カウンター、目標、フィルター、セグメント、訪問・流入元・ページ・コンバージョンに関する表形式、時系列、ドリルダウン、比較のレポート、そして Logs API による訪問とヒットの生データを扱います。
セットアップ
セットアップは約 5 分です。Metrica のカウンターを所有している、またはカウンターにアクセスできる Yandex アカウントと、oauth.yandex.com に登録した自分のアプリが必要です。
- oauth.yandex.com で種類 For API access or debugging のアプリを作成し、アクセス権 metrika:read（Metrica の統計、カウンターの設定、カウンターの一覧）を付けます。アプリの ClientID を控えておきます。
- カウンターを所有している、またはカウンターを閲覧できる Yandex アカウントでサインインした状態で、自分の ClientID を入れた
https://oauth.yandex.com/authorize?response_type=token&client_id=<ClientID>を開き、表示されたトークン（y0_で始まります）を OAuth や Bearer を付けずにYANDEX_METRICA_TOKENにコピーします。 - コネクターをインストールし、
yandex_metrica_list_countersを実行します。トークンを確認し、ほかのツールで使うカウンター ID を一覧にします。
Cloud とセルフホストは同じ手順です: トークンを貼り付けるだけで、コネクターはすべての呼び出しでそれを Authorization: OAuth ... として送ります。AnythingMCP で Redirect URL を設定する必要はありません。
トークンの有効期間は約 1 年です: 使われている間は延長されます。ここでの操作はすべて読み取り権限で足ります。metrika:read でレポート、カウンターの設定、Logs API のリクエストを扱えます。
最初にカウンターと目標: カウンター ID は、レポートでは ids、それ以外では counterId に入れます。yandex_metrica_list_goals で得られる目標 ID は、ym:s:goal123reaches や ym:s:goal123conversionRate のように目標の指標名に埋め込みます。
指標、日付、フィルター: 指標とディメンションは、セッション（訪問）なら ym:s:、ページビューなら ym:pv: で始まります。例: ym:s:visits、ym:s:bounceRate、ym:s:lastTrafficSource。日付には YYYY-MM-DD、today、yesterday、30daysAgo を使えます。フィルターは ==、!=、=@（含む）、=~（正規表現）を AND と OR で組み合わせます。yandex_metrica_list_segments の保存済みセグメントもフィルターとして再利用できます。行は limit（既定 100、最大 100,000）と、1 から始まる offset でページ送りします。
サンプリングされた数値: レポートの応答には sampled と sample_share が含まれます。sampled が true の場合、数値は推定値です。短い期間なら完全な精度（accuracy full）を指定し、それ以外は Logs API を使ってください。
Logs API: サンプリングされていない訪問とヒットの生データは Yandex 側で準備されます。AI は yandex_metrica_evaluate_log_request でリクエストを作成できるか確認してから作成し、ステータスが processed になるまで待って、各パートをタブ区切りテキストとしてダウンロードします。1 行目はフィールド名です。期間に今日を含めることはできず、準備されたログはカウンターのログ保存容量にカウントされます。
制限: ユーザーごとに 1 日 5,000 リクエスト、5 分あたり 200 件のレポートリクエスト、同時 3 リクエストまで、IP アドレスごとに毎秒 30 リクエスト（Logs API は 10）です。超えると Yandex は 429 を返します。少し待ってから再試行してください。
よくあるエラー: 401 はトークンが誤っている、期限切れ、または取り消されていることを示します。手順 2 のとおり、アプリの ClientID で新しいトークンを取得してください。403 はトークンは有効でも、そのアカウントにそのカウンターへのアクセス権がないか、アプリに metrika:read がないことを示します。400 は指標、ディメンション、フィルターのいずれかが無効であることを示し、メッセージに該当するものが示されます。
読み取れるデータ: サイト、ミラー、ステータス、タイムゾーン、コードの状態、所有者、あなたの権限を含むカウンターと、カウンターを分類するラベル（フォルダー）、種類、条件、ステップ、価格を含む目標、データフィルター、URL の処理ルール、保存済みセグメント、カウンターにアクセスできるユーザー、訪問、ユーザー、直帰率、流入元、ページ、国、デバイス、目標コンバージョンに関する表形式・時系列・ドリルダウン・比較のレポート、そして Logs API によるサンプリングなしの訪問とヒットの生データです。
インストール時はオフ: yandex_metrica_clean_log_request。処理済みの Logs API リクエストで準備されたファイルを削除してカウンターのログ保存容量を空けるツールで、削除後はファイルをダウンロードできなくなります。必要な場合だけコネクターのページで有効にしてください。AI は変更のたびに事前にあなたの確認を取ります。yandex_metrica_create_log_request と yandex_metrica_cancel_log_request はオンです。Yandex 側で生データのエクスポート準備を開始または停止するだけで、カウンター、目標、設定は変更しません。
対象外: カウンター、目標、フィルター、アクセス権の作成と編集、オフラインコンバージョン、通話、費用、ユーザーパラメーター、CRM データのアップロード。
前提条件: YANDEX_METRICA_TOKEN
ローカルでコネクタをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
http://localhost:3000/connectors/store を開き、 Yandex Metrica を選択し、前提条件に記載された環境変数を入力します。
利用可能なツール
| Tool | What it does |
|---|---|
yandex_metrica_list_counters | List the Metrica counters (tags) the token can read: id, name, site, status, owner_login, permission (own, view, edit), time zone, creation… |
yandex_metrica_get_counter | Get one counter's settings: name, site and mirrors, status, time zone, code status, webvisor and e-commerce options, owner and, with field… |
yandex_metrica_list_goals | List the goals of a counter: id, name, type (url, action, number, step, phone, email, form, messenger ...), conditions, is_retargeting and… |
yandex_metrica_get_goal | Get one goal of a counter by id: name, type, conditions, steps of a composite goal and price |
yandex_metrica_list_filters | List the data filters of a counter (include or exclude traffic by IP, URL, title, referrer ...): id, attr, type, value, action, status |
yandex_metrica_list_operations | List the URL operations of a counter (cut query parameters or fragments, merge to lowercase, replace domain): id, action, attr, value… |
yandex_metrica_list_segments | List the saved segments of a counter: segment_id, name, expression (a filter you can pass as filters in reports), status, segment_source… |
yandex_metrica_list_grants | List who has access to a counter: user_login, perm (view or edit), created_at and comment |
yandex_metrica_list_labels | List the user's counter labels (folders): id and name |
yandex_metrica_get_report | Build a table report from the Reporting API: metrics grouped by dimensions over a date range, with filters, sorting and paging |
yandex_metrica_get_report_by_time | Build a time series: the metrics per day, week, month, hour or other interval for the top rows of the dimensions |
yandex_metrica_get_drilldown | Build a tree report: the first dimension's values with their metrics, then expand one row into the next dimension with parent_id |
yandex_metrica_compare_segments | Compare two segments or periods side by side: the same metrics and dimensions for segment A (date1_a, date2_a, filters_a) and segment B… |
yandex_metrica_evaluate_log_request | Check whether a Logs API request for raw visits or hits can be created: possible (true or false) and max_possible_day_quantity |
yandex_metrica_create_log_request | Create a Logs API request that prepares raw, unsampled visits or hits for a date range on Yandex's side |
yandex_metrica_list_log_requests | List the Logs API requests of a counter: request_id, source, fields, attribution, status (created, processed, canceled, processing_failed… |
yandex_metrica_get_log_request | Get one Logs API request: status and, once processed, the parts (part_number and size) to download |
yandex_metrica_download_log_part | Download one part of a processed Logs API request as tab-separated text, the first line holding the field names |
yandex_metrica_cancel_log_request | Cancel a Logs API request that is still being prepared (status created) |
yandex_metrica_clean_log_request | Delete the prepared files of a processed Logs API request to free the counter's log storage quota |
プロンプトの例
- 「先月、訪問数が最も多かった流入元はどれですか。それぞれの直帰率も教えてください。」
- 「過去 3 か月で、注文の目標のコンバージョン率は週ごとにどう変わりましたか。」
- 「10 月と 9 月の訪問数と目標達成数を、流入元別に比較してください。」
- 「昨日ページビューが最も多かったページはどれですか。どのデバイスからでしたか。」
- 「先週のサンプリングなしの訪問データを Logs API で取得し、地域別に数えてください。」
次のステップ
このガイドは役に立ちましたか?