klaviyo-analyst について
klaviyo-analystは、Klaviyoのメール・SMSマーケティングを監査、改善するマーケティング運用向けスキルです。フロー、セグメント、配信到達性、データ、レポートを扱い、体系的なアカウント監査手順を備えています。
主な機能
- 01マーケティングフローの監査と改善
- 02RFM・エンゲージメントセグメントの設計
- 03メール・SMSキャンペーンの企画
- 04配信到達性とアトリビューションの確認
- 05イベント、連携、プロフィールデータの監査
活用シーン
- 01ライフサイクルフローの不足を特定
- 02エンゲージメント・予測セグメントの作成
- 03キャンペーンとフローの実績評価
- 04イベントスキーマと連携状態の確認
MCP 対応
Klaviyo公式MCPサーバーとの利用を想定し、アカウント、キャンペーン、フロー、プロフィール、レポートなど40以上のツールを利用します。OAuthまたはローカルサーバーで接続し、読み取り専用の監査にも対応します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/klaviyo-analystを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
.env.exampleEXAMPLES.mdLICENSEREFERENCE.mdrequirements.txtscripts/analyze.pyklaviyo_client.py詳細
Klaviyo マーケティングアナリスト
マーケティングオペレーションおよびアナリストの視点から、Klaviyo のメールおよび SMS マーケティングに関する専門的なガイダンスを提供します。フロー、セグメント、キャンペーン、インテグレーションの監査、構築、最適化を支援します。
API インテグレーション、SDK の使用、イベントトラッキングの実装、Webhook、開発者向けのパターンについては、klaviyo-developer スキルを参照してください。
インストール
ステップ 1 — スキルをインストールする
git clone https://github.com/thatrebeccarae/claude-marketing.git && cp -r claude-marketing/skills/klaviyo-analyst ~/.claude/skills/
ステップ 2 — Klaviyo MCP に接続する（推奨）
このスキルは、Klaviyo の公式 MCP サーバーを中心に設計されています。OAuth を通じて Claude を Klaviyo アカウントに接続できます。ローカルの API キーも Python のインストールも必要ありません。セットアップ方法は、使用する Claude の環境によって異なります。
Claude Chat または Claude Cowork の場合 — Connector Directory を使用する
Klaviyo は Claude の Connector Directory に掲載されています（2026-05-07 に発表された Klaviyo と Anthropic の連携拡大の一環です）。セットアップは約 2 分で完了します。
- Claude を開き → Settings → Connectors → Browse Connectors を選択します
- Klaviyo を検索します
- Connect をクリックして認証します
プラン要件： コネクターは Claude の Pro、Max、Team、Enterprise プランで利用できます。Free プランのユーザーは、Claude Code または以下のローカルインストール方法を使用する必要があります。
Claude Code の場合 — リモート MCP を登録する
claude mcp add klaviyo --transport http https://mcp.klaviyo.com/mcp
監査のみのセッションでは、プロトコル層ですべての書き込みツールを無効にするため、?read-only=true を追加します。
claude mcp add klaviyo --transport http "https://mcp.klaviyo.com/mcp?read-only=true"
ローカルにインストールする場合（CI コンテナ、オフライン開発）
claude mcp add klaviyo -e PRIVATE_API_KEY=pk_... -e READ_ONLY=true -- uvx klaviyo-mcp-server@latest
Klaviyo 側の要件： 接続を承認するには、Owner、Admin、または Manager のロールが必要です。
MCP は、Accounts、Campaigns、Catalogs、Events、Flows、Groups、Profiles、Reporting、Templates、Translations にわたる 40 以上のツールを公開します。ツールの一覧は、REFERENCE.md を参照してください。
ステップ 3 — フォールバック：ローカル CLI スクリプト（任意）
CI、cron、またはヘッドレスレポート用にスクリプトから CLI にアクセスする必要がある場合は、Python の要件をインストールし、KLAVIYO_API_KEY を設定してください。以下の「スクリプト（フォールバック）」セクションを参照してください。
主な機能
フローの監査と最適化
- 既存のフローをベストプラクティスに照らして監査します（ウェルカムシリーズ、カート放棄、購入後、休眠顧客の再獲得、閲覧放棄、配信停止）
- フローの不足やパフォーマンス不足による収益の取りこぼしを特定します
- 分割テスト、タイミングの調整、条件ロジックの改善を提案します
- フローのフィルターとトリガー条件の正確性を確認します
セグメンテーション戦略
- RFM（最新購入日、購入頻度、購入金額）に基づくセグメントを構築します
- エンゲージメントの段階を設計します：アクティブ（0～30 日）、ウォーム（31～90 日）、離反リスクあり（91～180 日）、休眠（180 日以上）
- Klaviyo の予測分析（CLV、解約リスク、次回注文日）を使用して予測セグメントを作成します
- エンゲージメントのない連絡先を抑制し、配信到達率を保護します
キャンペーン戦略
- プロモーションコンテンツと価値提供コンテンツのバランスを取りながら、キャンペーンカレンダーを計画します
- 件名、送信時刻、コンテンツブロックの A/B テスト用フレームワークを作成します
- プロフィールプロパティとカタログデータを使用して、動的コンテンツをパーソナライズします
- SMS キャンペーンのコンプライアンス（TCPA、配信可能時間帯、オプトイン要件）に対応します
配信到達率の管理
- 配信到達率の問題（バウンス率、迷惑メールの苦情、受信トレイへの配置）を監視し、原因を診断します
- 新しい送信ドメイン／IP のウォームアップ戦略を策定します
- 認証設定に対応します：SPF、DKIM、DMARC
- リストの衛生管理と配信停止フローの設計を行います
収益のアトリビューションとレポート
- Klaviyo のアトリビューションモデル（クリックベース、デフォルトの計測期間はメールが 5 日、SMS が 24 時間）を解釈します
- フロー収益、キャンペーン ROI、リスト増加率を把握するためのカスタムダッシュボードを作成します
- KPI を業界標準と比較します
イベントスキーマの監査
- ソース別（組み込みインテグレーション、カスタム API、Klaviyo 内部、フォーム）に、追跡対象のすべてのメトリクスを一覧化します
- 重複／冗長イベント、未使用イベント、欠落している標準イベントを特定します
- セグメンテーションやパーソナライズでイベントプロパティにアクセスできるかを評価します
- フロースプリットやセグメント条件を妨げる、ネストされたオブジェクトの制限を診断します
インテグレーションの健全性レビュー
- 有効なインテグレーション（eコマース、レビュー・プラットフォーム、ロイヤルティ、広告）を監査します
- 古くなった／停止したインテグレーションと、孤立したイベントソースを特定します
- フロートリガーのアーキテクチャを評価します：メトリクストリガーへの直接接続（堅牢）と、API同期プロパティを介したセグメント登録トリガー（脆弱）を比較します
- カタログ同期の健全性を評価します：商品カバー率、バリアントの処理、鮮度
プロフィールデータ活用分析
- プロフィールプロパティをマッピングします：収集されているデータと、セグメンテーション／パーソナライゼーションで使用されているデータを確認します
- 古くなった計算済みプロパティ（設定後に一度も更新されていないもの）を特定します
- イベントにはあるもののプロフィールに同期されていないプロパティにフラグを付けます（セグメンテーションが制限されます）
- ネストされたデータにアクセスしやすくするプロパティのフラット化戦略を推奨します
主なベンチマーク
| 指標 | 良好 | 非常に良好 | 注意 |
|---|---|---|---|
| 開封率（メール） | 20-25% | 30%+ | <15% |
| クリック率（メール） | 2-3% | 4%+ | <1.5% |
| 配信停止率 | <0.3% | <0.1% | >0.5% |
| スパム報告率 | <0.05% | <0.02% | >0.1% |
| 総売上に占めるフロー経由売上の割合 | 30-40% | 50%+ | <20% |
| SMSクリック率 | 8-12% | 15%+ | <5% |
| リスト成長率（月次） | 3-5% | 8%+ | <1% |
必須フローチェックリスト
- ウェルカムシリーズ（メール3～5通＋任意でSMS）— リスト登録時にトリガー
- カート放棄（メール2～3通＋SMS 1通）— Started Checkout 時にトリガー
- 閲覧後の離脱（メール1～2通）— Viewed Product 時にトリガーし、最近購入した顧客を除外
- 購入後（メール2～4通）— Placed Order 時にトリガーし、初回購入者とリピーターで分岐
- 休眠顧客の再獲得（メール2～3通）— 前回購入からの経過期間（60～90日）に基づいてトリガー
- 配信終了／再エンゲージメント（メール2通）— 90～180日間エンゲージメントのない顧客を対象とし、その後配信停止
- レビュー依頼 — 配達後にトリガーし、レビュー・プラットフォームと連携
- 補充案内（該当する場合）— 想定される再購入サイクルに基づいてトリガー
- 誕生日／記念日 — 日付プロパティに基づいてトリガー
- VIP／ロイヤルティ — CLV の高いセグメントへの登録時にトリガー
ワークフロー：Klaviyo の完全監査（4フェーズの詳細フレームワーク）
Cowork 対応： 4フェーズ監査は、無人での実行を想定して構築されています。Cowork で Klaviyo コネクタが有効（読み取り専用モード）になっていれば、結果を説明するだけで実行できます。 「Klaviyo のフローを監査して、不足しているものを教えて」、「先週のキャンペーンとフローの実績を取得して、月曜日用のダイジェストを書いて」、「開封率が20%未満のフローすべてにフラグを付け、優先順位を付けた修正リストを書いて」 と依頼してから、その場を離れてください。Cowork がデータを取得して分析を実行し、文書を作成して、別の会議に出席している間に適切なフォルダーに保存します。
Klaviyo アカウントの監査を依頼された場合は、次の4フェーズのフレームワークに従ってください。
フェーズ1：ステータスの棚卸し
- リスト／セグメント／フロー／キャンペーンの棚卸し — すべてのオブジェクトをステータス（稼働中、下書き、非アクティブ）別に集計・分類します
- イベントスキーマの棚卸し — すべてのメトリクスを取得し、ソース（組み込み、カスタム API、Klaviyo 内部、フォーム）別に分類して、イベント数がゼロのイベントにフラグを付けます
- インテグレーションの棚卸し — すべての有効なインテグレーションを一覧にし、古くなった接続を特定します
- カスタムプロフィールプロパティの棚卸し — すべてのカスタムプロパティについて、種類と用途を記録します
フェーズ2：設定の監査
- フローごとの設定の詳細確認 — 有効なフローごとに、以下を確認します：
- トリガーの種類と条件
- Smart Send の設定（オン／オフとその影響）
- 除外フィルター（セグメントへの所属、イベント条件）
- メッセージ間の送信間隔（ベンチマークと比較）
- 分岐ロジック（条件分岐、A/B テスト分岐）
- フロー期間（最初のメッセージから最後のメッセージまで）
- キャンペーンのターゲティング監査 — セグメントの排他性、配信頻度の上限設定、配信時刻の最適化
- A/B テスト手法の監査 — 単変量と多変量の比較、KPI との整合性、統計的有意性の実践状況
- 配信到達性の設定 — 認証（SPF/DKIM/DMARC）、専用 IP、ウォームアップ状況
フェーズ 3：データ構造の監査
- イベントスキーマの健全性 — 重複、標準イベントの欠落、セグメンテーションを妨げるネストされたオブジェクトを確認します
- プロファイルデータの活用状況 — 収集されているデータと、セグメンテーション／パーソナライズに使用されているデータを確認します
- カタログ同期の健全性 — 商品フィードの鮮度、網羅性、バリエーションの処理を確認します
フェーズ 4：戦略的な推奨事項
- 3段階の推奨事項 — 各調査結果について、以下を示します。
- 調査結果：問題点と、監査データによる根拠
- 推奨事項：実施すべきこと（クライアント向けの平易な表現）
- 実装仕様：構築方法（トリガー、フィルター、コンテンツ概要、タイミング、テスト計画を含む社内向け SOW）
- 段階的なテスト計画 — 統計的有意性のフレームワークを用いた単変量 A/B テスト
- 定量化された ROI — 予想される向上率 % × 現在の収益ベースライン
- 実装ロードマップ — 依存関係を明示した段階的なタイムライン
業界別ベンチマーク
B2B／卸売 E コマース
| 指標 | 良好 | 優秀 | 要注意 | 備考 |
|---|---|---|---|---|
| 開封率 | 25-35% | 40%+ | <20% | 専門的な関連性が高いため、DTC より高くなります |
| クリック率 | 3-5% | 6%+ | <2% | 商品に焦点を当てた CTA が効果的です |
| CTOR | 10-15% | 18%+ | <8% | 重要な診断指標で、コンテンツの関連性を示します |
| フロー収益率 % | 25-35% | 40%+ | <15% | B2B では再注文フローの価値が高くなります |
| 平均注文額 | 変動 | — | — | セグメント（業種、企業規模）別に追跡します |
| 再注文率 | 60-70% | 80%+ | <50% | 消耗品カテゴリーでは重要です |
DTC（消費者直販）
| 指標 | 良好 | 優秀 | 要注意 |
|---|---|---|---|
| 開封率 | 20-25% | 30%+ | <15% |
| クリック率 | 2-3% | 4%+ | <1.5% |
| フロー収益率 % | 30-40% | 50%+ | <20% |
| ウェルカムシリーズのコンバージョン率 | 3-5% | 8%+ | <2% |
| カート離脱回復率 | 5-10% | 15%+ | <3% |
サブスクリプション／継続収益
| 指標 | 良好 | 優秀 | 要注意 |
|---|---|---|---|
| 解約率（月次） | <5% | <3% | >8% |
| 再アクティブ化率 | 5-10% | 15%+ | <3% |
| 補充フローのコンバージョン率 | 8-12% | 15%+ | <5% |
| サブスクリプションのアップグレード率 | 3-5% | 8%+ | <1% |
SMS プラットフォーム比較フレームワーク
Klaviyo SMS と Attentive を評価する際（監査でよく見られるケース）：
| 機能 | Klaviyo SMS | Attentive |
|---|---|---|
| メールと SMS の統合 | はい（ネイティブ） | いいえ（別のプラットフォーム） |
| 共有セグメント | はい | 同期が必要 |
| 統合アトリビューション | はい | レポートは別々 |
| 会話型 SMS | 限定的 | 強力 |
| サインアップユニット | 基本（ポップアップ、フォーム） | 高度（2タップ、リンクベース） |
| AI 機能 | 予測分析、スマート送信時間 | AI ジャーニー、スマート送信 |
| コンプライアンス | TCPA、静穏時間を内蔵 | 内蔵＋コンプライアンスチーム |
| コスト | Klaviyo プランに含まれる（SMS ごと） | 別途プラットフォーム料金＋SMS ごとの料金 |
| 最適な用途 | メールと SMS の統合、シンプルさ | SMS を重視する戦略、SMS の大量配信 |
推奨フレームワーク：メールが主要チャネルで SMS が補完的な場合（B2B やミッドマーケットの DTC の多く）は、Klaviyo SMS を使用します。SMS が主要な収益チャネルである場合（配信頻度の高い DTC、モバイルファーストのブランド）は、Attentive を検討します。
繰り返し実行できる監査ワークフロー（Klaviyo MCP ツールの呼び出し順）
公式の Klaviyo MCP サーバー（https://mcp.klaviyo.com/mcp）を使用してアカウントを監査する場合は、以下の順序でツールを呼び出してください。以下のツールはすべて読み取り専用で、URL パラメーターに ?read-only=true を設定すれば、本番環境でも安全に実行できます。
| ステップ | MCP ツール | 目的 |
|---|---|---|
| 1 | get_account_details | アカウント設定、タイムゾーン、インテグレーション |
| 2 | get_metrics | イベントの全一覧（すべてのメトリクス名と ID） |
| 3 | get_metric（メトリクスごと） | 主要イベント（Placed Order、Started Checkout、Viewed Product）のプロパティ構造 |
| 4 | get_flows | ステータスを含むすべてのフロー |
| 5 | get_flow（稼働中のフローごと） | トリガーの詳細、アクション、フィルター |
| 6 | get_flow_report（フローごと） | フローごとの売上、コンバージョン、エンゲージメント |
| 7 | get_campaigns | 送信日を含む最近のキャンペーン |
| 8 | get_campaign_report（キャンペーンごと） | 開封、クリック、配信停止、売上の指標 |
| 9 | get_segments + get_segment | セグメントの一覧と条件の定義 |
| 10 | get_lists + get_list | リストの一覧 |
| 11 | get_catalog_items | カタログ同期の健全性チェック |
| 12 | query_metric_aggregates | 時系列の集計値（アプリ内の Metric Reporting と同じ）による、配信到達性と売上傾向の分析 |
| 13 | get_events（フィルター適用） | プロパティ構造とネストされたオブジェクトの使用状況を調べるための、最近のイベントペイロードのサンプル |
データ取得後は、上記の 4 フェーズの詳細フレームワークを使って分析してください。
書き込みツールについて： MCP には書き込みツール（create_campaign、create_profile、update_profile、create_email_template、subscribe_profile_to_marketing、assign_template_to_campaign_message、upload_image_from_file、upload_image_from_url、create_event、および翻訳ツール）も用意されています。監査のみを行う場合は、?read-only=true を指定して接続し、これらの使用を制限してください。ユーザーと共同で作成中のキャンペーンへのテンプレートの割り当てなど、確認済みの推奨事項を実施する場合に限り、書き込みを有効にしてください。
インテグレーションの概要
E コマースプラットフォーム
- Shopify：ネイティブインテグレーションにより、注文、商品、顧客を自動的に同期します。Shopify 固有のメトリクス（Placed Order、Started Checkout、Viewed Product）を使用してください。
- WooCommerce / BigCommerce / Magento：同様にイベントを同期できますが、プラグインの設定が必要になる場合があります。
- カスタムプラットフォーム：API のイベントトラッキングとプロフィール管理については、klaviyo-developer スキルを使って開発者と連携してください。
よくあるインテグレーション
- 購入後のレビューフローに使用するレビュー用プラットフォーム（Yotpo、Judge.me、Stamped）
- ポイントベースのセグメント化に使用するロイヤルティプログラム（Smile.io、LoyaltyLion）
- サブスクリプションのライフサイクルフローに使用するサブスクリプションプラットフォーム（Recharge、Bold）
- SMS：Klaviyo の組み込み SMS、または Attentive/Postscript とのインテグレーション
このスキルの使い方
次のような質問をしてください：
- 「Klaviyo のフローを監査して、問題点を特定してください」
- 「DTC ブランド向けのウェルカムシリーズを設計してください」
- 「開封率が下がりました。配信到達性の問題の診断を手伝ってください」
- 「RFM セグメント化戦略を作成してください」
- 「カート放棄フローでどのような A/B テストを実施すべきですか？」
- 「リストを整理するためにサンセットフローを設定するのを手伝ってください」
- 「ブラックフライデーのメール／SMS キャンペーンのカレンダーを計画してください」
- 「イベントスキーマを監査してください。必要な情報はすべてトラッキングできていますか？」
- 「クリック率を改善するための 3 段階の推奨事項を提示してください」
分析例
分析パターンの全容、出力例付きの詳細な実例、ユースケースについては、EXAMPLES.md をご覧ください。
スクリプト（代替手段：ローカル CLI）
次の場合に使用してください： CI／cron からのスクリプトによる CLI アクセス、ヘッドレスのレポートジョブ、または Klaviyo MCP に接続できない環境（
KLAVIYO_API_KEY環境変数を使う自動化パイプラインなど）。Claude Code/Chat/Cowork で対話型の分析を行う場合は、上記の MCP を使う方法を推奨します。より高速で、OAuth 認証に対応し、同じデータを取得できます。
このスキルには、データ取得と分析のためのユーティリティスクリプトが含まれています：
Klaviyo データを取得する
# List all flows
python scripts/klaviyo_client.py --resource flows
# List campaigns as table
python scripts/klaviyo_client.py --resource campaigns --format table
# Get flow performance report
python scripts/klaviyo_client.py --resource report --report-type flow --id FLOW_ID
# Export metrics to file
python scripts/klaviyo_client.py --resource metrics --output metrics.json
分析とレポートの生成
# Full account audit
python scripts/analyze.py --analysis-type full-audit
# Flow gap analysis
python scripts/analyze.py --analysis-type flow-audit
# Segment health check
python scripts/analyze.py --analysis-type segment-health
# Campaign performance comparison
python scripts/analyze.py --analysis-type campaign-comparison --days 30
# Deliverability diagnostic
python scripts/analyze.py --analysis-type deliverability
# Revenue attribution
python scripts/analyze.py --analysis-type revenue-attribution
スクリプトは、API 認証、データの取得、分析を処理します。結果を解釈し、実行可能な推奨事項を提示します。
トラブルシューティング
MCP 接続の問題
MCP が Claude に表示されない場合： クライアントで MCP が設定され、認証されていることを確認してください。Claude Code の場合は、~/.claude.json またはプロジェクトレベルの MCP 設定を確認してください。Claude Chat の場合は、「設定」→「コネクター」を確認してください。
OAuth の権限が拒否された場合： Klaviyo のユーザーロールがオーナー、管理者、またはマネージャーである必要があります。権限がこれより低いユーザーは、MCP を認証できません。
書き込みツールが失敗する場合： 接続 URL に ?read-only=true が設定されていないことを確認してください。設定されている場合、設計上、書き込みツールは無効になります。書き込み操作には読み書き可能な URL に切り替えてください。
複数アカウントで混乱が生じた場合： MCP は複数アカウントの設定に対応しています。Claude が誤ったアカウントからデータを取得する場合は、再認証するか、Klaviyo の UI でアクティブなアカウントを確認してください。
スクリプト（フォールバック）のエラー
認証エラー：以下を確認してください。
KLAVIYO_API_KEYが環境変数または.envファイルに設定されている- キーが
pk_で始まっている（公開キーではなく、プライベート API キー） - キーに読み取りスコープがある：
profiles:read、flows:read、campaigns:read、segments:read、lists:read、metrics:read
データが返されない場合：以下を確認してください。
- API キーが正しい Klaviyo アカウントに関連付けられている
- アカウントに分析対象となるアクティブなフロー、キャンペーン、またはセグメントがある
- フィルターが正しくフォーマットされている（例：
equals(status,"live")）
レート制限エラー：SDK は自動的に再試行を処理します（最大 3 回、最大遅延 60 秒）。それでも制限に達する場合は、以下を試してください。
- 同時リクエストを減らす
- 順次実行する呼び出しの間に遅延を追加する
RateLimit-Remainingヘッダーを確認する
インポートエラー：必要なパッケージをインストールしてください。
pip install klaviyo-api python-dotenv pandas
セキュリティに関する注意事項
Klaviyo MCP を使用する場合（推奨）
- MCP は OAuth を使用するため、コミット、ローテーション、漏えいする API キーはありません
- 監査のみを行う場合は、接続 URL に
?read-only=trueを設定して、すべての書き込みツールを無効にしてください - 認証範囲は Klaviyo のユーザーロール（オーナー／管理者／マネージャー）に限定され、最小権限が上流で適用されます
- ロールが変更された場合、または OAuth トークンの有効期限が切れた場合は、再認証が必要です
- 複数アカウントの設定では、書き込み操作を含むツールを実行する前に、アクティブなアカウントを確認してください
スクリプトのフォールバックを使用する場合
- API キーをコードにハードコードしたり、バージョン管理にコミットしたりしないでください
- キーは環境変数または
.envファイルに保存してください .envを.gitignoreに追加してください- アナリストの作業には読み取り専用スコープを使用してください。書き込みアクセスは不要です
- Klaviyo の「設定」で API キーを定期的にローテーションしてください
データプライバシー
このスキルは、集計されたマーケティングデータのみにアクセスします。以下のことは行いません。
- メール／プロフィールの集計データを除き、個人を特定できる情報（PII）にアクセスする
- Klaviyo のデータを永続的に保存する
- 外部サービスとデータを共有する
- Klaviyo の設定を変更する（読み取り専用操作）
すべてのデータはローカルで処理され、会話中に推奨事項を生成する目的にのみ使用されます。
Klaviyo のデータモデル、フロービルダーのリファレンス、セグメンテーション条件、到達率、SMS のリファレンスについて詳しくは、REFERENCE.md を参照してください。
API 統合、SDK の使用方法、開発者向けのパターンについては、klaviyo-developer スキルを使用してください。