live-dashboard

/digital-marketing-pro:live-dashboard

スクリプトの場所。 ホストが ${CLAUDE_PLUGIN_ROOT} を設定しない場合、スクリプトはこのプラグインの scripts/ フォルダー（skills/ と同じ階層）にあります。Python 3.10 以降で実行してください。python が見つからない環境（macOS、多くの Linux システム）では python3 を使用します。

目的

ブランドのマーケティングデータソースに接続した、ライブの Google Looker Studio ダッシュボードを作成して設定します。ビジネスモデル（SaaS、eCommerce、B2B、agency）に基づいて、適切な指標、ディメンション、グラフの種類を自動選択します。手動でデータを取得しなくても、マーケティングのパフォーマンスを常に最新の状態で把握できます。ビジネスモデルにとって最も重要な指標を関係者がセルフサービスでリアルタイムに確認でき、ドリルダウン機能と日付範囲コントロールも組み込まれているため、定期的なレポート作成が不要になります。

実行前の承認（必須 — 省略不可）

このスキルは、デフォルトではレビュー用のダッシュボード仕様書を作成します。この承認手順を最初に完了しない限り、ライブデータソースを外部ダッシュボードに作成、公開、共有、接続してはなりません。

1. データソース、接続済みアカウント、共有範囲、更新頻度を含む仕様書全体を実行概要として提示します。
2. 外部ダッシュボードを作成または共有する前に、ユーザーが yes（または同等の明示的な承認）を入力する必要があります。それ以外の入力は、曖昧、暗示的、一部のみの承認、または承認なしのいずれであっても、取り消しとして扱います。仕様書は保存されますが、外部には何も作成されません。
3. 曖昧な入力があった場合は、決して続行しないでください。作成に失敗しても、自動で再試行しないでください。
4. ユーザーが yes を入力した後に限り、次のコマンドで記録します。python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action create-approval --data '{"type":"live-dashboard","platform":"<platform>","content_summary":"<実行概要からの1行>","risk_level":"<tier>"}' を実行し、続けて python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action approve --id {approval_id} を実行します。いずれかのコマンドでエラーが発生した場合は、停止してエラーを報告してください。別のツールで回避してはなりません。この記録は、この操作の承認手順が実行されたことを証明しますが、誰が yes を入力したかは証明できません。
5. 実行します。connector_executor.py を介して送信する書き込みには --approval-id が必要で、一致する未使用かつ有効期限内の記録がある場合にのみ実行されます（/digital-marketing-pro:execute-action を参照）。接続済みの MCP サーバーツールを介した書き込みは、このコードチェックの対象外です。その場合は、ユーザーが入力した yes と、ホストに表示される権限確認に依存します。実行後、python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action mark-executed --id {approval_id} --data '{"execution_result":"success"}'（または failure）を実行します。

入力が必要な項目

ユーザーが次の情報を提供します（または、入力を求められます）。

• ビジネスモデル：saas（継続収益を重視 — MRR、解約率、アクティベーション、拡大）、ecommerce（取引を重視 — 売上、AOV、コンバージョン率、商品パフォーマンス）、b2b-lead-gen（パイプラインを重視 — MQL、SQL、パイプライン価値、CPL）、またはagency（複数クライアントを重視 — クライアント健全性スコア、稼働率、クライアント間のパフォーマンス）。デフォルトの指標セット、レイアウトテンプレート、ビジュアライゼーションの優先順位が決まります
• 接続するデータソース：ダッシュボードに取り込むプラットフォーム — Google Analytics（トラフィック、行動、コンバージョン）、Google Ads（有料検索のパフォーマンス、広告費）、Meta Ads（有料ソーシャルのパフォーマンス、広告費）、CRM（パイプライン、商談データ、顧客ライフサイクル）、メールプラットフォーム（キャンペーンのパフォーマンス、リストの健全性）。複数のソースを組み合わせて、プラットフォーム横断の計算フィールドを含む統合ビューを作成できます
• 主なKPI：ダッシュボードの上部に目立つように表示する、主要な指標を3〜5個 — 例：SaaSではMRRと解約率、eCommerceでは売上とROAS、B2BではSQLとパイプライン価値。これらは、トレンド指標と目標比較を含むスコアカードウィジェットとして表示されます
• ダッシュボードの対象者：executives（トレンド矢印付きの概要スコアカード、ドリルダウンは最小限で、事業成果を重視）、marketing-team（チャネル別内訳、キャンペーンレベルのデータ、診断用のディメンションを含む詳細な運用情報）、またはclient（ブランドに合わせたプレゼンテーションビュー、明示された目標に対するパフォーマンス、競合状況、すっきりとしたビジュアルデザイン）
• 更新頻度：データの更新頻度 — real-time（対応している場合はストリーミング）、daily（ほとんどの用途で標準）、weekly（詳細度の低いデータで十分な経営幹部向けダッシュボード）。データソースのキャッシュ設定と抽出スケジュールが決まります

プロセス

1. ブランドのコンテキストを読み込む：~/.claude-marketing/brands/_active-brand.jsonを読み込み、有効なスラッグを確認してから、~/.claude-marketing/brands/{slug}/profile.jsonを読み込みます。ビジネスモデル、主要指標、業界分野、ダッシュボードのテーマ設定に使うブランドカラー、接続済みプラットフォームの認証情報を抽出します。~/.claude-marketing/brands/{slug}/guidelines/_manifest.jsonにガイドラインがあるか確認します。ブランドが設定されていない場合は、「先にブランドを設定しますか（/digital-marketing-pro:brand-setup）？」と尋ねるか、デフォルト設定で進めます。
2. ビジネスモデルのテンプレートに基づいてダッシュボードのレイアウトを設計する：適切な指標の階層とページ構成を選択します。SaaSの場合：1ページ目は概要（MRRスコアカード、解約率、CAC、LTV、CAC:LTV比率）、2ページ目は獲得ファネル（チャネル別のトラフィックからトライアル、アクティベーション、有料化まで）、3ページ目はリテンション（コホート別リテンション曲線、拡大収益、純収益維持率）です。eコマースの場合：1ページ目は概要（収益、AOV、コンバージョン率、ROAS）、2ページ目は商品パフォーマンス（人気商品、カテゴリ別内訳、在庫回転率）、3ページ目はチャネル構成（チャネル別のアトリビューション収益、キャンペーン単位のROAS）です。B2Bの場合：1ページ目は概要（MQL、SQL、パイプライン価値、成約率）、2ページ目はファネル（リードからMQL、SQL、商談、成約までの各段階のコンバージョン率）、3ページ目はチャネル効率（チャネル別のCPL、SQLあたりのコスト、商談あたりのコスト）です。Agencyの場合：1ページ目はポートフォリオの概要（クライアントの健全性スコア、管理対象の総広告費、稼働率）、2ページ目はクライアント別の詳細（全KPIセットを備えた選択可能なクライアントフィルター）、3ページ目はクライアント間のベンチマークです。
3. データソースをダッシュボードのウィジェットに対応付ける：レイアウト内の各ウィジェットについて、必要なデータを提供する接続済みMCPを特定します。トラフィックと行動指標にはGoogle Analytics MCP、有料検索データにはGoogle Ads MCP、有料ソーシャルデータにはMeta MCP、パイプラインと商談指標にはCRM MCP、キャンペーンのパフォーマンスにはメールMCPを使用します。未接続のデータソースが必要なウィジェットには印を付け、接続方法を案内します。
4. Looker Studioの設定を生成する：データソースの接続パラメーター（アカウントID、プロパティID、日付範囲）、計算フィールドの数式（プラットフォーム横断の統合ROAS、加重コンバージョン率、カスタムKPI計算）、グラフの仕様（グラフの種類、ディメンション、指標、並べ替え順、条件付き書式）、フィルターコントロール（日付範囲セレクター、チャネルフィルター、キャンペーンフィルター、オーディエンスセグメントフィルター）、ウィジェットの配置とサイズを含むページレイアウトなど、ダッシュボードの完全な仕様を作成します。
5. ダッシュボードのセットアップ手順を作成する：Looker Studioでダッシュボードを実装するための手順を追って案内します。仕様に沿った各データソース接続の作成方法、各ページとウィジェットの作成方法、正確な数式を使った計算フィールドの設定方法、フィルターコントロールとその連動方法の設定、ブランドのテーマ設定（色、フォント、ロゴの配置）の適用方法を説明します。役立つ場合はスクリーンショットや視覚的な参考資料も含めます。
6. ダッシュボードのテンプレートリンクまたはエクスポート設定を提供する：このプラグインにはLooker Studio MCPサーバーが同梱されていません（レジストリにgoogle-looker-studioコネクターはありません）。デフォルトでは、各ウィジェットの詳細な定義とデータソースの対応関係を記載した、手動で実装可能な構造化仕様書として完全な設定をエクスポートします。ユーザーが独自にLooker Studio MCPサーバーを接続している場合に限り、かつ上記の実行ゲートを通過した後に限り、直接作成を試みることができます。

出力

以下を含む、構造化されたダッシュボードの納品物です。

• ダッシュボード設計仕様書：ページ構成、ウィジェットの配置、グラフの種類、指標、サイズ、ウィジェットごとのデータソース、条件付き書式ルールを網羅したレイアウト文書。ページごとに視覚的なレイアウトの説明をまとめます
• Looker Studio セットアップガイド：空のダッシュボードから完全に設定されたライブビューを作成するまでの、手順ごとの実装手順。データソースの作成、ページの構築、ウィジェットの設定、計算フィールドの数式、フィルターの設定を含みます
• プラットフォームごとのデータソース接続手順：各データソースの接続に関するプラットフォーム固有のガイダンス。Google Analytics のプロパティ ID とビューの選択、Google Ads アカウントのリンク、Meta 広告アカウントの認証、CRM API の接続、メールプラットフォームの統合を、必要な権限とスコープとともに説明します
• 計算フィールドの数式：すべてのカスタム計算フィールドについて、Looker Studio の正確な数式構文を記載します。プラットフォーム横断のブレンド指標、カスタム KPI、期間比較計算、目標比較フィールド、条件付き書式のロジックを含みます
• フィルターとドリルダウンの設定：すべてのインタラクティブコントロールの仕様。プリセット付きの日付範囲セレクター、チャネルとキャンペーンのフィルター、オーディエンスセグメントセレクター、パラメーターを受け渡すページ横断のドリルダウンリンクを含みます
• ダッシュボードの保守チェックリスト：継続的な保守作業。データソースの認証情報を更新するスケジュール、新しいキャンペーンやチャネルの追加、KPI の定義変更に伴う計算フィールドの更新、ビジネスモデルの変化に応じた指標の関連性の四半期ごとのレビューを含みます

使用したエージェント

• analytics-analyst — ビジネスモデルと業界ベンチマークに基づく指標の選定、対象ユーザーに合わせて情報の階層を最適化したダッシュボードレイアウトの設計、どの接続済み MCP がどのウィジェットにデータを提供するかを特定するデータソースのマッピング、グラフの種類の選定、ディメンションと指標の組み合わせ、条件付き書式のしきい値、ドリルダウン経路の設計を含む、可視化のベストプラクティス
• execution-coordinator — Looker Studio の設定生成（google-looker-studio MCP は同梱されていません。デフォルトでは仕様をエクスポートし、ユーザー自身が Looker Studio MCP を接続している場合に限り直接作成します）。データソースの設定、計算フィールドの作成、ウィジェットの仕様、フィルターコントロールの設定に加え、ブランドカラーを使ったダッシュボードのテーマ設定、セットアップ手順またはライブダッシュボードリンクのエクスポートを行います