client-report

/digital-marketing-pro:client-report

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

目的

特定のブランド向けに、プロフェッショナルなホワイトラベルのクライアントレポートを生成します。代理店のトーン（ブランドのトーンではありません）を使用し、KPI の実績、チャネル別の内訳、戦略的な提案、次のステップを含みます。Slack、メール、Google Sheets、または Markdown での外部クライアントへの送付を想定しており、調査結果の誤開示や草稿の早すぎる送付を防ぐため、外部送信前に承認を必須とします。

必要な入力

ユーザーは以下を入力する必要があります（または、入力を求められます）。

• ブランドスラッグ：このレポートの対象ブランドです。~/.claude-marketing/brands/ に設定されているブランドと一致する必要があります
• レポートの種類：次のいずれかです。
  • 週次速報：3～5 個の主要指標と簡潔なコメントを含む、KPI の概要
  • 月次レビュー：チャネル別の内訳と提案を含む、詳細な実績分析
  • QBR：戦略的なロードマップと今後の計画を含む、四半期ごとの詳細分析
• 期間：レポート対象期間の具体的な開始日と終了日です。取得・分析するデータの範囲を定義します
• 送付チャネル：レポートの送付先です。slack、email、google-sheets、または markdown-only（外部には送信せず、成果物のみを生成）を指定します
• カスタムセクション（任意）：競合動向、クリエイティブの実績分析、オーディエンスのインサイト、アトリビューションの詳細分析、またはアドホックな調査テーマなど、クライアントから依頼された追加セクションです
• 比較期間：比較対象です。前期間、前年の同期間、計画／目標、またはそのすべてを同時に指定します
• 宛先リスト（任意）：メールまたは Slack で送付する場合にレポートを受け取るクライアント担当者です。氏名とハンドル／アドレスを指定します
• ナラティブの重点（任意）：この期間にクライアントが最も重視する項目です。成長、効率、ブランド認知、パイプラインの創出、または収益を指定します。最初に取り上げる指標とインサイトの伝え方に影響します
• 付録を含める：生データの表とキャンペーン単位の詳細を付録として添付するかどうかを指定します。月次レビューと QBR ではデフォルトで「はい」、週次速報では「いいえ」です
• ホワイトラベル設定（任意）：代理店のロゴの配置、配色、免責事項の文面です。代理店プロフィールが設定されている場合はそこから取得し、設定されていない場合はシンプルなデフォルト設定を使用します

プロセス

1. ブランドコンテキストを読み込む：~/.claude-marketing/brands/_active-brand.jsonを読み込み、アクティブなスラッグを確認してから、~/.claude-marketing/brands/{slug}/profile.jsonを読み込みます。ブランドの語調、対象市場のコンプライアンス規則（skills/context-engine/compliance-rules.md）、業界のコンテキストを適用します。また、~/.claude-marketing/brands/{slug}/guidelines/_manifest.jsonにガイドラインがあるか確認し、存在する場合は制約事項を読み込みます。~/.claude-marketing/sops/にエージェンシーのSOPがあるか確認します。ブランドが存在しない場合は、「まずブランドを設定しますか（/digital-marketing-pro:brand-setup）？」と尋ねるか、デフォルト設定で進めます。
2. ブランドのすべての指標を取得する：接続済みのMCPサーバーに問い合わせ、python "${CLAUDE_PLUGIN_ROOT}/scripts/campaign-tracker.py" --brand {slug} --action list-campaignsを実行します（次にキャンペーンごとに--action get-campaign --id {id}を実行）。すべてのアクティブなチャネルの実績データを収集し、分析時に指定された日付範囲で絞り込みます。
3. キャンペーン履歴と実行ログを収集する：python "${CLAUDE_PLUGIN_ROOT}/scripts/execution-tracker.py" --brand {slug} --action get-historyを実行し、完了したすべての成果物、開始したキャンペーン、実施した最適化、終了したテストをまとめてから、分析時にレポート対象期間で絞り込みます。
4. 目標および比較期間に対するKPIを算出する：profile.jsonに記載されたブランドのKPI目標、および選択した比較期間に対する実績を算出します。差分、変化率、トレンドの方向性、サンプルサイズが十分な場合は統計的有意性も計算します。
5. チャネル別に実績を分析する：指標をチャネル別（有料検索、有料ソーシャル、オーガニック検索、メール、ディスプレイ、動画、アフィリエイトなど）に分類し、チャネルごとのKPI、広告費、効率指標（CPC、CPA、ROAS、CTR）、全体目標への貢献率をまとめます。
6. 主な成果とその要因を特定する：対象期間で最も成果を上げたキャンペーンまたは施策を3～5件選び、実施内容、成果につながった要因、オーディエンスとクリエイティブに関する洞察、事業成果との関連を記録します。
7. 根本原因を特定して未達要因を分析する：目標未達のKPIについて、根本原因を特定します。
   • 外部要因：市場の変化、季節性、競合の動向、プラットフォームのアルゴリズム変更
   • 内部要因：予算の制約、クリエイティブの摩耗、オーディエンスの飽和、タイミングの不一致
   • 是正措置：すでに実施した対応と、次の期間に向けた推奨事項
8. 戦略的な提案を作成する：実績データに基づき、実行可能な提案を3～5件まとめます。拡大する施策、一時停止する施策、次にテストする内容、予算の振り分け先、新たに検討する機会を示します。
9. エージェンシーの語調でレポートを作成する：プロフェッショナルな三人称のエージェンシーの語調でレポート全体を作成します。ブランド固有の個性は使用しません。明確さ、データに裏付けられた洞察、実行可能な次のステップ、クライアントの信頼につながる自信に満ちた誠実な語調を重視します。
10. 配信先に合わせてフォーマットする：python "${CLAUDE_PLUGIN_ROOT}/scripts/report-generator.py" --brand {slug} --action format-slack（またはformat-email／format-sheets）を実行し、--data '{report_json}'でレポートJSONを渡します。整形されたMarkdown成果物を作成するには、--action generate-report --data '{report_json}'を指定します。
11. 承認チェックポイントを設ける：レポート全体のプレビューを提示して確認を求めます。リスクレベルは低です。外部への配信前に明示的な承認を必須とし、クライアントへの事前説明が必要となる可能性がある機密データ、予想外の結果、または否定的な調査結果を明示します。
12. 承認後、MCP経由で配信する：承認された場合、配信先が指定されていれば、適切なMCP連携（Slack MCP、email MCP、Google Sheets MCP）を通じて送信します。配信エラーが発生した場合、プラットフォームに到達していないことが確実な書き込み（接続拒否、DNS障害、429のレート制限による拒否）のみ再試行します。タイムアウトまたは応答の消失後は、まずプラットフォーム上でレポートがすでにチャネルまたは受信トレイにあるかを確認し、見つからない場合にのみ再送信します。
13. 配信を記録してアーカイブする：タイムスタンプ、受信者、配信確認状況、レポートのバージョン、今後の比較に使うアーカイブ済みレポートへの参照とともに、レポートの配信を実行ログに記録します。

出力

以下を含む、構造化されたクライアントレポートです。

• エグゼクティブサマリー：対象期間の概要を3～5文でまとめます。期間の主な成果、主な成功事項、重点領域、次期の見通し、およびクライアントへの推奨アクションを1つ含めます
• KPIスコアカード：実績、目標、比較期間を一覧性の高い表にまとめ、色分けされたステータス指標（目標超過、順調、要注意、未達）と、推移の方向性を示す矢印を表示します
• チャネル別パフォーマンスの内訳：チャネルごとの費用、成果、効率指標（CPC、CPA、ROAS、CTR）、全体目標への貢献率、およびチャネルの健全性評価
• アトリビューション付きキャンペーンのハイライト：特に成果の高いキャンペーン、その成功要因、クリエイティブとオーディエンスに関するインサイト、測定された効果、および今後のキャンペーンでの再現に向けた推奨事項
• パフォーマンス未達の分析：未達項目があれば率直に評価し、根本原因の分類（外部要因か内部要因か）、影響の定量化、実施した是正措置、および次期に向けた予防策を示します
• 戦略的な推奨事項（3～5件）：データに基づく次のステップについて、期待される効果、必要な投資、実施スケジュール、優先順位、およびクライアントが明示した事業目標との関連を示します
• 予算効率の分析：チャネル別の費用とリターンの概要、期間中のコスト推移、予算消化率、過去の期間との効率比較、および改善・低下を示す指標
• 今後の納品物とスケジュール：次期に代理店が納品するものについて、日付、マイルストーン、依存関係、および計画を予定どおりに進めるために必要なクライアントの対応を示します
• 付録（要望があった場合）：詳細なレビュー用の生データ表、キャンペーン単位の内訳、全指標のエクスポート、クリエイティブのパフォーマンスデータ、および裏付けとなる計算
• 納品確認：チャネル、タイムスタンプ、宛先、納品状況、レポートのバージョンを記載します。外部への納品が依頼されていない場合は、代わりにMarkdown形式の成果物を示します

使用するエージェント

• agency-operations — レポートの文体とトーン（ブランド固有の個性ではなく、代理店としてのプロフェッショナルな表現）、クライアントの状況把握、承認ワークフローの管理、ホワイトラベル形式での書式設定、および納品の調整
• analytics-analyst — 指標の分析、KPIの算出、チャネル別の内訳、傾向分析、比較計算、アトリビューションモデリング、統計的有意性の確認、および推奨事項のデータ面での裏付け
• execution-coordinator — 納品チャネルに合わせたレポートの書式設定、MCP 統合による納品、実行ログの記録、納品エラーへの対応、およびアーカイブ