mcpField
U
umami

umami

github.com/martinhjartmyrデータ・データベース039 回インストール33 週間前に更新
リポジトリ

umami について

umami は、Umami インスタンスからアクセス概要や分析データを取得するスキルです。ウェブサイトの利用状況を確認するユーザー向けに、現期間と前期間の指標をまとめ、現在のアクティブ訪問者数だけを取得することもできます。

主な機能

  1. 01ウェブサイトのアクセス概要を取得
  2. 02現期間と前期間の指標を比較
  3. 03現在のアクティブ訪問者数を取得
  4. 04分析結果を表形式に整理

活用シーン

  1. 01日次のウェブサイトアクセスレポート作成
  2. 02現在のアクティブ訪問者数の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/martinhjartmyr/skills --skill umami

インストール後、Claude Code で/umamiを入力して読み込まれたか確認します。

同梱ファイルreferences/api.mdscripts/umami-summary.sh

詳細

Umami Analytics

Umami インスタンスからトラフィックの概要と分析データを取得します。

設定

実行前に、次の環境変数を設定してください。

変数必須説明
UMAMI_API_URLはいUmami インスタンスのベース URL（例：https://cloud.umami.is）
UMAMI_API_KEYいずれか一方Umami Cloud の API キー。Bearer トークンとして直接使用します。
UMAMI_USERNAMEいずれか一方/api/auth/login 経由でセルフホスト環境にログインするユーザー名。
UMAMI_PASSWORDユーザー名と併用セルフホスト環境にログインするためのパスワード。

UMAMI_API_KEY が設定されている場合、ユーザー名とパスワードより優先されます。

ワークフロー：日次トラフィックの概要

  1. スクリプトを実行します。 
    bash ~/Projects/skills/umami/scripts/umami-summary.sh
  2. JSON 出力を解析します。
  3. 次のような Markdown テーブルに整形します。
ウェブサイトドメインページビュー訪問者訪問直帰平均時間アクティブ
マイブログblog.example.com1,234 (980)567 (510)890 (801)123 (110)45s (38s)3
合計1,234 (980)567 (510)890 (801)123 (110)45s (38s)3
  • 各指標の後に、前期間の値を括弧内に表示します（例：「1,234 (980)」は、現在が1,234、前期間が980という意味です）。
  • 読みやすいように、数値にはカンマを付けます。
  • totaltime を人が読みやすい時間表記に変換します（例：「1m 23s」）。
  • 各サイトの平均時間は totaltime / visits で計算し、前期間の平均時間は prev_totaltime / prev_visits で計算します。
  • 合計行を太字にします。

ワークフロー：アクティブユーザーのみ

「今、サイトにいる人は？」という問い合わせには、軽量フラグを使用します。

bash ~/Projects/skills/umami/scripts/umami-summary.sh --active-only

これにより統計 API の呼び出しを省略し、現在アクティブな訪問者数のみを取得します。次のようなシンプルなテーブルに整形します。

ウェブサイトドメインアクティブ
マイブログblog.example.com3

エラー処理

スクリプトは失敗時にゼロ以外の終了コードを返し、JSON を stderr に出力します。

  • 環境変数の不足：{"error": "UMAMI_API_URL is not set"}
  • 認証失敗：{"error": "Authentication failed (HTTP 401)"}
  • サーバーに接続できない場合：{"error": "Could not connect to https://..."}

これらのエラーは、具体的なメッセージとともにユーザーにはっきり伝えてください。環境変数を確認するよう提案してください。

API リファレンス

日次の概要以外の問い合わせ（時系列、指標の内訳、カスタム日付範囲）については、references/api.md を参照してください。

コメント

Markdown 対応