/digital-marketing-pro:data-import

目的

外部ソースから構造化データを任意の接続プラットフォームに取り込むための汎用データインポートツール。CSV、JSON、またはGoogle Sheetsから、CRMシステム、メールサブスクライバーリスト、オーディエンスセグメント、競合トラッカー、キャンペーンマネージャー、またはカスタムデータストアにインポートできます。インポートパイプライン全体に対応 — 自動提案機能付きフィールドマッピング、データ検証、既存レコードに対する重複排除、連絡先データのコンセント・コンプライアンス検証、プラットフォームMCPを通じたバッチ処理実行、および必要に応じてロールバック案内を含む詳細な結果報告。

必要な入力

ユーザーが提供する必要があります(またはプロンプトで求められます):

• データソース: ローカルCSVまたはJSONファイルへのファイルパス、またはGoogle Sheets URL — インポート対象の生データ。CSV の場合は、非標準の区切り文字があれば指定してください。Google Sheets の場合は、シート名と範囲を指定してください(デフォルトは最初のシート全体)。ファイルは現在の環境からアクセス可能である必要があります
• 宛先プラットフォーム: データが移動する場所 — CRM(HubSpot、Salesforce)、メールプラットフォーム(Mailchimp、ActiveCampaign、SendGrid)、オーディエンスマネージャー、競合トラッカー、またはカスタム宛先。対応するMCPサーバーが接続され、.mcp.json に設定されている必要があります
• フィールドマッピング: ソース列が宛先フィールドにどのようにマップされるか — 明示的なマッピング(例: 「Company Name」→ 「company」、「Work Email」→ 「email」)を提供するか、列名の類似性に基づいてシステムが提案するオートマッピングを要求してください。マップされていない列はレビュー用にフラグが付けられ、マップされていない必須の宛先フィールドはインポートを解決されるまでブロックします
• インポートオプション(オプション): 重複排除戦略(skip で重複をスキップ、update で既存レコードを更新、create-new で関係なく作成 — デフォルトは skip)、コンセント検証レベル(strict は明示的なオプトインフィールドが必須、standard は登録解除フラグをチェック、none は非連絡先データ用)、APIライト用のバッチサイズ(デフォルト 100)、およびドライランモード(実行せずに検証)

プロセス

1. ブランドコンテキストの読み込み: ~/.claude-marketing/brands/_active-brand.json からアクティブなスラッグを読み、~/.claude-marketing/brands/{slug}/profile.json を読み込みます。ターゲット市場のコンプライアンスルール(skills/context-engine/compliance-rules.md)を適用します — 特に連絡先データインポートのGDPR、CAN-SPAM、CCPA要件。エージェンシーSOPを ~/.claude-marketing/sops/ で確認してください。ブランドが存在しない場合は、「ブランドをまず設定してください (/digital-marketing-pro:brand-setup)?」と質問するか、デフォルトで進めます
2. ソースデータの読み込みと解析: 指定されたソースからデータを読み込みます — ヘッダー検出と区切り文字処理でCSVを解析、スキーマ推論でJSONを解析、またはGoogle Sheets MCPでGoogle Sheetsから取得します。基本的な形式の完全性を検証 — 行全体の列数の一貫性、解析可能なデータ型、完全に空の行または列がないこと。ソース統計を報告: 総レコード数、検出された列、推論されたデータ型
3. フィールドマッピングウィザード: 列名と宛先フィールド名の類似性に基づいて自動提案マッピング(「email」、「first_name」、「phone」、「company」などの一般的なパターンのファジーマッチング)。提案されたマッピングをユーザー確認用に提示します。マップされていないソース列(無視されるデータ)とマップされていない必須の宛先フィールド(インポート前に解決する必要があるブロッカー)をフラグします。ユーザーがマッピングを調整、追加、または削除できるようにします
4. データ品質の検証: すべてのレコードに対して検証チェックを実行 — メールフォーマット検証(RFC 5322)、電話番号フォーマット検出、必須フィールドが存在し空でないこと、データ型適合(日付、数値、文字列)、宛先プラットフォームごとのフィールド長制限。インポートファイル内の重複を検出します。CRMが接続されている場合は、メールまたは電話をマッチキーとして既存レコードに対する重複をチェックします。メールおよびSMSインポートの場合は、コンセントフィールドを検証 — 明示的なオプトインタイムスタンプ、登録解除フラグ、およびブランドの市場規制への準拠を確認します
5. 承認ゲートの作成: ユーザー確認のための包括的なインポートサマリーを提示 — ソース内の総レコード数、検証に合格したレコード、検証に失敗したレコード(カテゴリー別の理由付き)、検出された重複レコード(ファイル内および既存データに対して)、連絡先インポートのコンセント検証ステータス、宛先プラットフォームおよびターゲットオブジェクトタイプ、フィールドマッピングサマリー、および適用される重複排除戦略。ユーザーが明示的に承認するまで実行をブロックします
6. 宛先MCPを通じたインポートの実行: 承認されたら、適切なMCPを通じてバッチ単位で宛先プラットフォームにレコードを書き込みます — CRM MCPを通じたCRM連絡先(HubSpotまたはSalesforce)、メールMCPを通じたメールサブスクライバーリスト(Mailchimp、ActiveCampaign、またはSendGrid)、competitor-tracker.py を通じた競合ベースラインデータ、またはオーディエンスマネージャーを通じたオーディエンスセグメント。レコードごとの成功、失敗、スキップステータスを追跡します。指数バックオフを使用した一時的なAPIエラー(レート制限、タイムアウト)に対する再試行ロジックを実装します
7. 結果のレポート: 詳細なインポート結果レポートを生成 — 宛先IDで正常にインポートされたレコード、レコードごとの具体的なエラー理由で失敗したレコード、重複排除または検証によってスキップされたレコード、コンセント検証サマリー、実行されたAPI呼び出し総数、および処理時間。失敗が総レコード数の10%を超える場合、レビュー用にフラグを立て、ロールバック案内を提供します

出力

以下を含む構造化インポート結果レポート:

• インポートサマリー: 処理されたレコード総数、正常にインポート、失敗、スキップ(重複)、スキップ(検証失敗) — パーセンテージ分析および処理時間付き
• 使用されたフィールドマッピング: ソース列と宛先フィールド間に適用された最終マッピング。オートマップされたフィールドとユーザーオーバーライドを含み、監査証跡および将来のインポート再利用のため
• 検証レポート: 検出されたデータ品質の問題のカテゴリー別リスト — 無効なメール、欠落した必須フィールド、フォーマット不一致、フィールド長違反 — 各問題タイプの影響を受けたレコード数とサンプル値付き
• コンセント検証ステータス: 連絡先データインポート用 — 検証済みオプトイン、コンセント欠落、登録解除フラグ付きのレコード数、およびブランドのターゲット市場規制(GDPR、CAN-SPAM、CCPA)に対するコンプライアンス評価
• 宛先確認: プラットフォーム名、オブジェクトタイプ、バッチ数、APIレスポンスサマリー、および正常にインポートされたレコードで利用可能な宛先レコードID
• 失敗したレコードのエラー詳細: レコードごとのエラー理由はエラータイプ別にグループ化 — API検証エラー、再試行枯渇後のレート制限失敗、権限エラー、宛先プラットフォームからのデータ形式却下
• ロールバック指示: インポートをリバースする必要がある場合 — 削除するレコードID、使用するAPIエンドポイント、宛先プラットフォーム向けのバッチ削除案内

使用されるエージェント

• execution-coordinator — ソース解析からMCP実行を通じたインポートパイプラインオーケストレーション、包括的なインポート前サマリーとリスク評価を持つ承認ワークフロー、再試行ロジックとエラーハンドリング付きバッチMCPデータライト、レコードごとのステータス追跡とともにログを実行、失敗または問題のあるインポート向けロールバック案内生成
• crm-manager — プラットフォームスキーマ認識を持つCRM固有のフィールドマッピングインテリジェンス(HubSpot プロパティ、Salesforce フィールド)、既存CRMレコードに対するメールと電話のマッチキーを使用した重複排除ロジック、連絡先データ品質スコアリング、およびブランドのターゲット市場向けコンプライアンス要件に対するコンセントフィールド検証