kakakakakku blog

Weekly Tech Blog: Keep on Learning!

Google Analytics MCP Server: 自然言語でアナリティクスデータを取得しよう

Google Analytics でブログ記事の PV を確認する機会がちょこちょこある📊

たとえば「人気記事の定点観測」「AWS Community Builders のアウトプット報告」など.

今までは Google Analytics コンソールでポチポチと確認していたけど Google Analytics MCP Server を使ってみたら便利だったので試したことをまとめておく❗️現状まだ Experimental な MCP Server である点は注意する.

github.com

セットアップ

Google Analytics MCP Server の GitHub リポジトリと Google Analytics のドキュメントが充実しててセットアップで困るところはほとんどなかった.YouTube 動画もあって真似しながら進めることもできる.

developers.google.com

まずは Google Cloud でプロジェクトを作って「Google Analytics Admin API」「Google Analytics Data API」を有効化しておく.

developers.google.com

developers.google.com

次に OAuth クライアントを作って Google Cloud CLI で Application Default Credentials (ADC) をセットアップする.最終的に application_default_credentials.json ファイルが取得できていれば OK👌

$ gcloud auth application-default login \
  --scopes https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform \
  --client-id-file=./client_secret_xxx-xxx.apps.googleusercontent.com.json
Your browser has been opened to visit:

(中略)

Credentials saved to file: [/Users/kakakakakku/.config/gcloud/application_default_credentials.json]

These credentials will be used by any library that requests Application Default Credentials (ADC).

最後は MCP Client をセットアップする.MCP Client は何でも良くて,今回は Google Analytics MCP Server のドキュメントに載っている Gemini CLI を使うことにした.

cloud.google.com

~/.gemini/settings.json に以下の設定をして PATH_TO_CREDENTIALS_JSONYOUR_PROJECT_ID を置き換えれば OK👌uvx ではなくて pipx なんだ〜という気付きもあった.

{
  "mcpServers": {
    "analytics-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "analytics-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID"
      }
    }
  }
}

動作確認

自然言語で https://kakakakakku.hatenablog.com/entry/2025/10/29/192801 の直近1週間の PV は? という質問を投げると結果が返ってきた👏

$ gemini
Loaded cached credentials.

 ███            █████████  ██████████ ██████   ██████ █████ ██████   █████ █████
░░░███         ███░░░░░███░░███░░░░░█░░██████ ██████ ░░███ ░░██████ ░░███ ░░███
  ░░░███      ███     ░░░  ░███  █ ░  ░███░█████░███  ░███  ░███░███ ░███  ░███
    ░░░███   ░███          ░██████    ░███░░███ ░███  ░███  ░███░░███░███  ░███
     ███░    ░███    █████ ░███░░█    ░███ ░░░  ░███  ░███  ░███ ░░██████  ░███
   ███░      ░░███  ░░███  ░███ ░   █ ░███      ░███  ░███  ░███  ░░█████  ░███
 ███░         ░░█████████  ██████████ █████     █████ █████ █████  ░░█████ █████
░░░            ░░░░░░░░░  ░░░░░░░░░░ ░░░░░     ░░░░░ ░░░░░ ░░░░░    ░░░░░ ░░░░░

╭────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ > https://kakakakakku.hatenablog.com/entry/2025/10/29/192801 の直近1週間の PV は?
╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

✦ 直近1週間のPVは3219です。

 Using: 1 MCP server

実際に Google Analytics コンソールで確認した値と一致していた❗️

今度は自然言語で トップページを除いて直近1週間で人気記事トップ3は? という質問を投げると結果が返ってきた👏

╭────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ > トップページを除いて直近1週間で人気記事トップ3は?
╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

✦ トップページを除いた直近1週間で人気の記事トップ3は以下の通りです。

   1. /entry/2025/10/29/192801 (3219 PV)
   2. /entry/2022/07/10/140253 (67 PV)
   3. /entry/2024/11/12/083326 (66 PV)

 Using: 1 MCP server

X ポスト