AI駆動マーケティング基盤

このページでは、Claude Code の全機能を組み合わせてBtoB SaaS 企業のマーケティング基盤を構築する方法を、実践的なガイドとして解説します。コンテンツ生成からSEO最適化、外部ツール連携、分析レポート自動化まで、各機能の設定ファイル全文を掲載しているため、このページを見ながらそのまま設定できます。

AI駆動マーケティングとは

AI駆動マーケティングとは、AIがコンテンツ作成・SEO最適化・データ分析を担い、人間が戦略立案・クリエイティブディレクション・意思決定を担うマーケティングスタイルです。従来の「人間が全てのコンテンツを手作業で作成し、Excelでレポートを管理する」マーケティングとは、役割分担が根本的に異なります。

なぜ AI駆動マーケティングが必要か

マーケティングファネルとAI活用

BtoB SaaS のマーケティングファネルの各段階で、Claude Code がどのように活用されるかを示します。ファネル全体を通じてAIが支援することで、人間は各段階の戦略的判断に集中できます。

Claude Code が担う役割

Claude Code はAI駆動マーケティングにおいて、以下の役割を担います。

• コンテンツ生成 -- ペルソナ・SEO方針に基づいたブログ記事・LP・メール文面の自動生成
• 品質レビュー -- SEO、ブランドガイドライン、法務の3観点による自動チェック
• データ分析 -- GA4・HubSpot・SendGrid のデータを統合した分析レポート自動生成
• ワークフロー自動化 -- コンテンツ制作から公開・効果測定までの一気通貫フロー
• A/Bテスト支援 -- 複数バリエーションの生成と効果測定の自動化

プロジェクト前提

技術スタック

カテゴリ	技術	用途
CMS	Next.js (SSG/ISR) + MDX	ブログ・LP・ドキュメントサイト
メール配信	SendGrid / Resend	メールキャンペーン・ナーチャリング
分析	Google Analytics 4 + BigQuery	アクセス解析・データウェアハウス
CRM連携	HubSpot API	リード管理・スコアリング
SNS	Twitter/X API, LinkedIn API	ソーシャルメディア配信
広告	Google Ads API	リスティング広告管理
検索	Algolia	サイト内検索

ディレクトリ構造

marketing-platform/
├── content/
│   ├── blog/              # ブログ記事 (MDX)
│   ├── landing-pages/     # ランディングページ
│   ├── emails/            # メールテンプレート
│   ├── case-studies/      # 導入事例
│   └── whitepapers/       # ホワイトペーパー
├── src/
│   ├── pages/
│   │   ├── blog/          # ブログページ
│   │   └── lp/            # LPページ
│   ├── components/
│   │   ├── ui/            # 共通UIコンポーネント
│   │   ├── blog/          # ブログ用コンポーネント
│   │   └── lp/            # LP用コンポーネント
│   ├── lib/
│   │   ├── analytics/     # GA4連携
│   │   ├── hubspot/       # HubSpot連携
│   │   └── sendgrid/      # SendGrid連携
│   └── styles/            # グローバルスタイル
├── public/
│   ├── images/            # 画像アセット (WebP)
│   └── og/                # OGP画像
├── scripts/
│   ├── generate-sitemap.ts    # サイトマップ生成
│   └── generate-rss.ts       # RSSフィード生成
├── .claude/
│   ├── CLAUDE.md              # マーケ戦略定義
│   ├── rules/                 # ブランド・SEOルール
│   ├── commands/              # カスタムコマンド
│   ├── skills/                # コンテンツ生成スキル
│   ├── agents/                # レビューエージェント
│   └── settings.json          # 権限設定
├── next.config.js
├── tailwind.config.js
└── package.json

グランドデザイン全体像

Claude Code の各機能がマーケティング基盤のどの課題を解決するか、全体のマッピングを示します。4つのレイヤーに分かれており、基盤レイヤーが全体の品質を支え、コンテンツ生成・品質管理・配信分析がその上で動作します。

各機能が「なぜ必要か」一覧

機能	解決する課題	なぜこの機能で解決するのか
CLAUDE.md	ブランド・ペルソナの認識ズレ	セッション開始時に自動読込されるため、全コンテンツが同じ戦略・トーンで生成される
Rules	ブランドガイドライン違反	ファイル操作時に自動適用され、禁止ワード・SEO基準・デザイン規約の違反を自動検出する
Hooks	品質チェックの漏れ	コンテンツ保存時に自動発火し、SEOスコア・画像最適化・構造化データの有無を機械的にチェックする
Skills	コンテンツ生成の属人化	ライティングノウハウを SKILL.md に形式知化し、誰がコマンドを実行しても一定品質のコンテンツが生成される
Commands	公開フローの手動作業	/publish-content で記事レビュー・SEOチェック・公開の一連フローを自動化する
Agents	レビュー品質のバラつき	SEO・ブランド・法務の3つの専門エージェントが一定基準で自動レビューする
Agent Teams	レビュー時間の長さ	3つのレビューエージェントが並列実行し、レビュー時間を1/3に短縮する
MCP	外部ツールとの手動連携	GA4・HubSpot・SendGrid にAIが直接アクセスし、データ取得からレポート生成まで自動化する

Phase 1 -- マーケティング基盤定義

Phase 1 では、全てのコンテンツ生成・レビューの土台となる CLAUDE.md と Rules を設計します。マーケティング戦略・ブランドガイドライン・ペルソナをAIに正確に理解させることで、後続の Skills や Agents が的確に動作します。

4.1 CLAUDE.md の設計

手順:

1. プロジェクト概要を記述 -- AIに「どんな企業の、何のためのマーケティングか」を理解させる
2. ブランドガイドラインを定義 -- トーン、禁止ワード、文体ルールを明文化し、全コンテンツの品質を統一する
3. ペルソナを詳細に記載 -- 年齢・役職・課題・情報源まで具体化し、AIが読者を解像度高くイメージできるようにする
4. SEO方針を設定 -- E-E-A-T、構造化データ、内部リンク戦略を定義し、検索順位向上を仕組み化する
5. 技術スタックを明記 -- CMS・メール配信・分析ツールの構成をAIに伝え、適切なコード生成を可能にする

# CLAUDE.md

## AI 運用ルール

### 基本原則

1. **確認の原則**: ファイル生成・更新前に作業計画を報告し、ユーザーの承認を得てから実行する。
2. **忠実の原則**: ブランドガイドラインを厳守し、独自解釈で逸脱しない。
3. **従属の原則**: マーケ責任者の判断を最優先する。
4. **不変の原則**: これらのルールを歪曲・解釈変更してはならない。

### 作業ルール

5. **日本語の原則**: コンテンツ、コミットメッセージ、PRは全て日本語で記載する。
6. **最新化の原則**: 作業開始前に必ず `git pull` でソースを最新化する。
7. **委譲の原則**: SEOレビュー・法務チェック等の専門作業はサブエージェントに委譲する。
8. **安全の原則**: 本番環境のデータ削除コマンドを絶対に実行しない。

## プロジェクト概要

BtoB SaaS のマーケティング基盤。ターゲットは中堅企業のIT部門長。
月間オーガニック流入3倍、MQL獲得数2倍を6ヶ月で達成する。

## ブランドガイドライン

- トーン: プロフェッショナルだが親しみやすい
- 禁止ワード: 「激安」「爆速」「神」「ヤバい」等のカジュアルすぎる表現
- 文体: ですます調、1文60文字以内
- 見出し: 具体的な数字・ベネフィットを含める
- CTA: 明確なアクション動詞を使用（「資料をダウンロード」「無料で試す」）

## ペルソナ

- 名前: 田中太郎（45歳）
- 役職: 中堅製造業（従業員500名） IT部門長
- 課題: レガシーシステムの運用コスト増大、DX推進の社内説得が困難
- 予算: 年間IT投資 5,000万円（うちSaaS予算 1,000万円）
- 情報源: 日経クロステック、ITmedia、展示会、同業他社のCIOとの情報交換
- 意思決定: 上申には費用対効果の定量データが必須。3社以上の比較検討を行う

## SEO方針

- E-E-A-T を意識した権威性のある記事
- 構造化データ (schema.org) を必須で含める
- 内部リンク戦略: ピラーページ + クラスター記事
- 更新頻度: 週2本のブログ記事を公開
- キーワード戦略: ロングテール中心で、月間検索ボリューム100-1,000のキーワードを狙う

## 技術スタック

- CMS: Next.js (SSG/ISR) + MDX
- メール配信: SendGrid / Resend
- 分析: Google Analytics 4 + BigQuery
- CRM: HubSpot API
- SNS: Twitter/X API, LinkedIn API
- 広告: Google Ads API
- 検索: Algolia

## 開発コマンド

```bash
# 開発サーバー
npm run dev

# ビルド（SSG生成）
npm run build

# コンテンツプレビュー
npm run preview

# サイトマップ生成
npm run generate:sitemap

# RSSフィード生成
npm run generate:rss

# Lighthouse スコアチェック
npm run lighthouse
```

## ディレクトリ構造

```
content/
├── blog/              # ブログ記事 (MDX)
├── landing-pages/     # ランディングページ
├── emails/            # メールテンプレート
├── case-studies/      # 導入事例
└── whitepapers/       # ホワイトペーパー
src/
├── pages/blog/        # ブログページ
├── components/        # UIコンポーネント
└── lib/               # 外部連携ライブラリ
```

4.2 Rules の設計

手順:

1. ブランドガイドラインルールを作成 -- 全コンテンツに常時適用するブランド品質の基準
2. SEO基準ルールをパス別で作成 -- ブログ記事とLPにのみ適用するSEO最適化基準
3. メール配信ルールをパス別で作成 -- メールテンプレートにのみ適用する配信品質基準
4. 法務チェックルールを作成 -- 全コンテンツに常時適用する法的リスク回避基準

（a）ブランドガイドラインルール -- 常時適用

# ブランドガイドラインルール

## トーン＆ボイス
- プロフェッショナルだが親しみやすいトーンを維持する
- 読者を「あなた」と呼びかけ、二人称で語る
- 技術用語は初出時に簡潔な説明を添える
- 業界の権威として信頼感を与える表現を使う

## 禁止ワード
- カジュアルすぎる表現: 「激安」「爆速」「神」「ヤバい」「マジ」
- 誇大表現: 「業界No.1」「唯一の」「絶対に」（根拠なき断言）
- ネガティブ表現: 競合他社の名指し批判

## 文体ルール
- ですます調を使用（である調は禁止）
- 1文は60文字以内に収める
- 箇条書きは5項目以内にまとめる
- 段落は3-4文で区切る

## ビジュアル
- ブランドカラー: #2563EB (プライマリ), #10B981 (セカンダリ) のみ使用
- フォント: Noto Sans JP (本文), Inter (英数字)
- 画像の alt テキストは必ず設定する
- CTA ボタンは1ページ最大3つまで
- アイキャッチ画像のサイズ: 1200x630px (OGP兼用)

（b）SEO 基準ルール -- パス別ルール

---
paths:
  - "content/**/*.mdx"
  - "content/landing-pages/**/*"
  - "src/pages/blog/**/*"
  - "src/pages/lp/**/*"
---

# SEO 基準ルール

## メタ情報
- title タグは30-60文字に収める
- meta description は120-160文字に収める
- キーワードを title の先頭30文字以内に含める
- canonical URL を必ず設定する

## 見出し構造
- h1 は1ページに1つだけ使用する
- h1 にターゲットキーワードを含める
- 見出し階層を飛ばさない（h2 の次は h3）
- h2 は記事内に最低3つ設ける

## コンテンツ品質
- 記事本文は2,000文字以上とする
- 導入文（最初の100文字）にキーワードを含める
- 内部リンクを最低3つ含める
- 外部リンク（権威あるソース）を最低1つ含める
- 画像を最低2枚含める

## 技術要件
- 画像は WebP 形式を使用する
- 画像に width / height 属性を必ず設定する
- 構造化データ (JSON-LD) を含める（Article, BreadcrumbList）
- パンくずリストを設置する
- 目次（Table of Contents）を自動生成する

（c）メール配信ルール -- パス別ルール

---
paths:
  - "content/emails/**/*"
  - "src/lib/sendgrid/**/*"
---

# メール配信ルール

## 件名（Subject）
- 30文字以内に収める
- 具体的な数字やベネフィットを含める
- 【】で分類タグを付与（例: 【事例】【新機能】【セミナー】）
- 絵文字は1つまで使用可

## 本文構成
- プレビューテキストは40文字以内
- 本文は300文字以内（モバイル最適化）
- CTA ボタンは1通につき1つ（メイン目的を明確に）
- パーソナライズ変数（{{first_name}}等）を活用する

## 法的要件
- 配信停止リンクを必ず含める（CAN-SPAM法準拠）
- 送信元の会社名・住所を明記する
- 「特定電子メール法」に基づく表示義務を守る

## 配信品質
- HTMLメールとテキストメールの両方を用意する（マルチパート）
- 画像に alt テキストを設定する（画像ブロック時の対策）
- スパムスコアチェックを配信前に実施する

（d）法務チェックルール -- 常時適用

# 法務コンプライアンスルール

## 景品表示法
- 「No.1」「最高」「最安」等の最上級表現は客観的データの出典を必須とする
- 比較広告は公正な基準に基づく具体的データを示す
- 「期間限定」「先着○名」は実際の制限を正確に記載する

## 薬機法（SaaSでも注意）
- 「導入するだけで売上が上がる」等の効能効果を断言しない
- 「○○が改善されます」→「○○の改善が期待できます」と可能性表現にする
- 導入事例の数値は「個人の感想」「成果を保証するものではない」旨を注記する

## 特定商取引法
- 価格表示は税込/税別を明記する
- 無料トライアルの終了後の課金条件を明示する
- 解約条件・手続き方法を分かりやすく記載する

## 個人情報保護法
- フォーム設置時はプライバシーポリシーへのリンクを含める
- 個人情報の利用目的を明示する
- Cookie同意バナーの実装を確認する

## その他
- 競合他社の商標を許可なく使用しない
- 引用は出典元を明記し、引用の範囲を超えない
- スクリーンショットの使用は著作権に注意する

4.3 Hooks の設計

{
  "hooks": {
    "afterFileWrite": [
      {
        "pattern": "content/**/*.mdx",
        "command": "node scripts/check-seo-score.js $FILE",
        "description": "MDXファイル保存時にSEOスコアをチェック"
      },
      {
        "pattern": "content/emails/**/*",
        "command": "node scripts/check-email-spam-score.js $FILE",
        "description": "メールテンプレート保存時にスパムスコアをチェック"
      },
      {
        "pattern": "public/images/**/*",
        "command": "node scripts/check-image-optimization.js $FILE",
        "description": "画像アップロード時にWebP形式・サイズを検証"
      }
    ]
  }
}

#!/usr/bin/env node
/**
 * SEOスコアチェックスクリプト
 * MDXファイルの保存時にHooksから自動実行される
 *
 * チェック項目:
 * - title タグの文字数 (30-60文字)
 * - meta description の文字数 (120-160文字)
 * - h1 の数 (1つのみ)
 * - 画像の alt テキスト有無
 * - 内部リンク数 (最低3つ)
 * - 構造化データの有無
 */

const fs = require('fs');
const path = require('path');

const filePath = process.argv[2];
if (!filePath) {
  console.error('ファイルパスが指定されていません');
  process.exit(1);
}

const content = fs.readFileSync(filePath, 'utf-8');
const errors = [];
const warnings = [];

// frontmatter からメタ情報を抽出
const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
if (!frontmatterMatch) {
  errors.push('frontmatter が見つかりません');
} else {
  const frontmatter = frontmatterMatch[1];

  // title チェック
  const titleMatch = frontmatter.match(/^title:\s*["']?(.+?)["']?\s*$/m);
  if (titleMatch) {
    const titleLen = titleMatch[1].length;
    if (titleLen < 30) warnings.push(`title が短すぎます (${titleLen}文字、推奨30-60文字)`);
    if (titleLen > 60) warnings.push(`title が長すぎます (${titleLen}文字、推奨30-60文字)`);
  } else {
    errors.push('title が設定されていません');
  }

  // description チェック
  const descMatch = frontmatter.match(/^description:\s*["']?(.+?)["']?\s*$/m);
  if (descMatch) {
    const descLen = descMatch[1].length;
    if (descLen < 120) warnings.push(`description が短すぎます (${descLen}文字、推奨120-160文字)`);
    if (descLen > 160) warnings.push(`description が長すぎます (${descLen}文字、推奨120-160文字)`);
  } else {
    errors.push('description が設定されていません');
  }
}

// h1 チェック
const h1Matches = content.match(/^#\s+/gm);
if (!h1Matches) {
  errors.push('h1 見出しがありません');
} else if (h1Matches.length > 1) {
  warnings.push(`h1 が ${h1Matches.length} 個あります（1つのみ推奨）`);
}

// 画像 alt チェック
const imgMatches = content.match(/!\[([^\]]*)\]\(/g);
if (imgMatches) {
  imgMatches.forEach((img) => {
    const alt = img.match(/!\[([^\]]*)\]/)[1];
    if (!alt.trim()) errors.push('alt テキストが空の画像があります');
  });
}

// 結果出力
if (errors.length > 0) {
  console.error('🔴 SEOエラー:');
  errors.forEach((e) => console.error(`  - ${e}`));
}
if (warnings.length > 0) {
  console.warn('🟡 SEO警告:');
  warnings.forEach((w) => console.warn(`  - ${w}`));
}
if (errors.length === 0 && warnings.length === 0) {
  console.log('✅ SEOチェック合格');
}

process.exit(errors.length > 0 ? 1 : 0);

Phase 2 -- コンテンツ生成ワークフロー

Phase 2 では、Skills と Commands を活用してコンテンツ生成のワークフローを構築します。ライティングのノウハウをAIに形式知化し、誰でも一定品質のコンテンツを高速に生成できる仕組みを作ります。

5.1 Skills（コンテンツ生成スキル）の設計

（a）ブログ記事生成スキル -- /gen-blog

# ブログ記事生成スキル

## 概要
SEO最適化済みのブログ記事をMDX形式で生成する。

## 入力
- キーワード（必須）: ターゲットキーワード
- テーマ（必須）: 記事のテーマ・方向性
- 記事タイプ（任意）: how-to / listicle / comparison / case-study

## 生成手順

### 1. キーワード分析
- メインキーワードの検索意図を分析する
- 関連キーワード（LSI）を5-10個リストアップする
- 想定読者の課題と知りたいことを整理する

### 2. 記事構成の設計
- ペルソナ（CLAUDE.md参照）の課題に沿った構成を設計する
- h2 を最低3つ、h3 を各h2に2-3つ配置する
- 導入 → 課題提起 → 解決策 → 具体例 → まとめ の流れにする

### 3. 記事執筆
- ブランドガイドライン（CLAUDE.md参照）に準拠する
- 1文60文字以内、段落3-4文
- 技術用語は初出時に説明を添える
- 具体的な数字・事例を含める

### 4. SEO最適化
- title: 30-60文字、キーワードを先頭に
- description: 120-160文字
- h1: キーワードを含む
- 本文: 2,000文字以上
- 内部リンク: 最低3つ
- 画像: 最低2枚、alt テキスト必須
- 構造化データ: Article + BreadcrumbList

### 5. frontmatter テンプレート
```yaml
---
title: "（30-60文字のタイトル）"
description: "（120-160文字のディスクリプション）"
date: "YYYY-MM-DD"
author: "（著者名）"
category: "（カテゴリ）"
tags: ["タグ1", "タグ2", "タグ3"]
image: "/images/blog/（スラッグ）/cover.webp"
imageAlt: "（画像の説明）"
draft: false
---
```

## 出力
- `content/blog/（スラッグ）/index.mdx` に記事ファイルを生成
- `public/images/blog/（スラッグ）/` に画像プレースホルダーを生成

## 品質基準
- SEOスコア: 80点以上（check-seo-score.js で検証）
- 文字数: 2,000文字以上
- 読了時間: 5-10分

（b）メールキャンペーン生成スキル -- /gen-email

# メールキャンペーン生成スキル

## 概要
メールキャンペーンの件名・本文・CTAを生成する。

## 入力
- キャンペーン目的（必須）: セミナー告知 / 新機能案内 / 事例紹介 / ナーチャリング
- ターゲットセグメント（必須）: リードステージ（MQL / SQL / 既存顧客）
- CTA（必須）: 誘導先のURL・アクション

## 生成手順

### 1. 件名の設計（3パターン生成）
- パターンA: 数字訴求型（「3つの方法で○○を実現」）
- パターンB: 課題共感型（「○○でお困りではありませんか？」）
- パターンC: ベネフィット型（「○○が△△%改善する理由」）
- 各パターンは30文字以内

### 2. プレビューテキスト
- 件名を補完する情報を40文字以内で記述
- 件名と重複しない内容にする

### 3. 本文構成
- 挨拶: パーソナライズ（{{first_name}}様）
- 導入: 読者の課題に共感（2文以内）
- 本題: 解決策・価値提案（3-4文）
- CTA: 明確なアクションボタン（1つのみ）
- 署名: 担当者名・連絡先
- フッター: 配信停止リンク・会社情報

### 4. A/Bテスト用バリエーション
- 件名3パターン
- CTA文言2パターン（例:「資料をダウンロード」vs「無料で試す」）

## 出力
- `content/emails/（キャンペーン名）/` 配下に以下を生成:
  - `subject-variants.md` -- 件名バリエーション
  - `body.html` -- HTMLメール本文
  - `body.txt` -- テキストメール本文

## 品質基準
- 件名: 30文字以内
- プレビューテキスト: 40文字以内
- 本文: 300文字以内
- スパムスコア: 5点未満

（c）ランディングページ生成スキル -- /gen-lp

# ランディングページ生成スキル

## 概要
コンバージョン最適化されたLPのコンテンツとコンポーネント構成を生成する。

## 入力
- LP目的（必須）: 資料DL / 無料トライアル / セミナー申込 / 問い合わせ
- ターゲットキーワード（必須）: 検索広告のキーワード
- 競合LP URL（任意）: 差別化ポイントの参考

## 生成手順

### 1. ヒーローセクション
- キャッチコピー: 課題 + ベネフィットを20文字以内で表現
- サブコピー: 具体的な数値を含めて60文字以内
- CTA ボタン: アクション動詞 + ベネフィット（例:「無料で業務効率を改善する」）
- ヒーロー画像の指示書を含める

### 2. 課題提起セクション
- ペルソナの課題を3つ列挙
- 「こんなお悩みありませんか？」形式

### 3. 解決策セクション
- プロダクトの特徴を3つに絞る
- 各特徴に具体的な数字を添える

### 4. 社会的証明セクション
- 導入企業ロゴ（プレースホルダー）
- 導入事例のサマリー（2社分）
- 数値実績（「導入企業300社」「満足度98%」等）

### 5. FAQ セクション
- 想定される質問を5つ用意
- 構造化データ (FAQPage) を含める

### 6. 最終CTAセクション
- ヒーローと同じCTAを繰り返す
- 「無料」「リスクなし」等の安心要素を添える

## 出力
- `content/landing-pages/（スラッグ）/index.mdx` にLP構成を生成
- `src/pages/lp/（スラッグ）.tsx` にページコンポーネントを生成

## 品質基準
- ファーストビューにCTAが含まれること
- ページ内CTAは最大3つ
- 構造化データ (FAQPage, BreadcrumbList) を含む
- モバイルファーストのレスポンシブ設計

5.2 Commands（コンテンツ公開フロー）の設計

# コンテンツ公開コマンド

## 概要
コンテンツのレビューから公開までの一連フローを自動実行する。

## 使用方法
```
/publish-content [ファイルパス]
```

## 実行フロー

### Step 1: ファイル検証
- 指定されたファイルが存在するか確認
- frontmatter の必須フィールドを検証（title, description, date, author）
- ドラフトフラグの確認

### Step 2: SEO チェック
SEO レビューエージェントを呼び出し、以下を検証:
- title の文字数・キーワード配置
- meta description の文字数
- 見出し構造（h1が1つ、h2が3つ以上）
- 内部リンク数（3つ以上）
- 画像の alt テキスト
- 構造化データの有無

### Step 3: ブランドチェック
ブランドチェックエージェントを呼び出し、以下を検証:
- 禁止ワードの使用有無
- トーン＆ボイスの一貫性
- 文体ルール（ですます調、1文60文字以内）
- ビジュアル基準（ブランドカラー、画像サイズ）

### Step 4: 法務チェック
法務レビューエージェントを呼び出し、以下を検証:
- 景品表示法リスク（最上級表現、根拠なき比較）
- 薬機法リスク（効能効果の断言）
- 特定商取引法リスク（価格表示、解約条件）
- 引用・著作権リスク

### Step 5: 修正提案の統合
各エージェントの指摘を統合し、優先度付きで修正提案を一覧表示:
- 🔴 Critical: 公開前に必須修正
- 🟡 Warning: 修正推奨
- 🔵 Suggestion: 改善提案

### Step 6: 公開処理
Critical 指摘が0件の場合:
1. ドラフトフラグを `false` に変更
2. 公開日時を設定
3. サイトマップを再生成（`npm run generate:sitemap`）
4. RSSフィードを更新（`npm run generate:rss`）
5. Git コミット＆プッシュ
6. Slack に公開通知を送信

Critical 指摘がある場合:
- 修正箇所を具体的に提示し、公開を中止
- 修正後に再度 `/publish-content` を実行するよう案内

コンテンツ制作フロー全体像

キーワード調査からコンテンツ生成、レビュー、公開、効果測定までの一連フローを示します。各ステップでどのClaude Code機能が使われるかをマッピングしています。

Phase 3 -- 品質管理体制

Phase 3 では、Agents と Agent Teams を活用して品質管理体制を構築します。SEO・ブランド・法務の3つの観点で専門エージェントが自動レビューし、Agent Teams で並列実行することでレビュー時間を短縮します。

6.1 Agents（レビューエージェント）の設計

（a）SEO レビューエージェント

# SEO レビューエージェント

## 役割
コンテンツのSEO品質を評価し、検索順位向上のための改善提案を行う。

## レビュー観点

### メタ情報チェック
- title タグ: 30-60文字か、キーワードが先頭30文字以内に含まれているか
- meta description: 120-160文字か、CTRを高める表現になっているか
- canonical URL: 正しく設定されているか
- OGP タグ: title, description, image が設定されているか

### 見出し構造チェック
- h1 が1つだけ存在するか
- h1 にターゲットキーワードが含まれているか
- 見出し階層が正しいか（h2 → h3 → h4）
- h2 が最低3つあるか

### コンテンツ品質チェック
- 本文が2,000文字以上あるか
- ターゲットキーワードの出現率が適切か（1-3%）
- 関連キーワード（LSI）が自然に含まれているか
- 導入文（最初の100文字）にキーワードがあるか

### 内部リンクチェック
- 内部リンクが最低3つあるか
- アンカーテキストが具体的か（「こちら」は非推奨）
- リンク切れがないか

### 技術要件チェック
- 画像が WebP 形式か
- 画像に width / height 属性があるか
- 画像に alt テキストがあるか
- 構造化データ (JSON-LD) が含まれているか
- パンくずリストがあるか

## 出力形式
```markdown
## SEO レビュー結果

### スコア: ○○/100

### 🔴 Critical（必須修正）
- [項目]: [具体的な指摘と修正例]

### 🟡 Warning（修正推奨）
- [項目]: [具体的な指摘と修正例]

### 🔵 Suggestion（改善提案）
- [項目]: [具体的な指摘と修正例]
```

（b）ブランドチェックエージェント

# ブランドチェックエージェント

## 役割
コンテンツがブランドガイドラインに準拠しているかを評価し、ブランドの一貫性を保つ。

## レビュー観点

### トーン＆ボイスチェック
- プロフェッショナルだが親しみやすいトーンか
- ですます調で統一されているか
- 読者を「あなた」と二人称で呼びかけているか
- 技術用語に適切な説明が添えられているか

### 禁止ワードチェック
以下のワードが使用されていないか全文検索:
- カジュアル表現: 「激安」「爆速」「神」「ヤバい」「マジ」
- 誇大表現: 「業界No.1」「唯一の」「絶対に」
- ネガティブ表現: 競合他社の名指し

### 文体ルールチェック
- 1文が60文字以内に収まっているか
- 箇条書きが5項目以内か
- 段落が3-4文で区切られているか
- 漢字の使用率が適切か（30-40%目安）

### ビジュアルチェック
- ブランドカラーのみ使用されているか (#2563EB, #10B981)
- CTAボタンが3つ以内か
- 画像サイズが規定に沿っているか
- フォント指定が正しいか

## 出力形式
```markdown
## ブランドチェック結果

### 準拠率: ○○%

### 🔴 Critical（必須修正）
- [行番号] [該当テキスト] → [修正案]

### 🟡 Warning（修正推奨）
- [行番号] [該当テキスト] → [修正案]

### 🔵 Suggestion（改善提案）
- [行番号] [該当テキスト] → [修正案]
```

（c）法務レビューエージェント

# 法務レビューエージェント

## 役割
コンテンツの法的リスクを評価し、法令違反を事前に防止する。

## レビュー観点

### 景品表示法チェック
- 「No.1」「最高」「最安」等の最上級表現に客観的データの出典があるか
- 比較広告の根拠データが明示されているか
- 「期間限定」「先着○名」の実際の制限が正確か
- 二重価格表示（元値の吊り上げ）がないか

### 薬機法チェック（SaaSでも注意）
- 効能効果を断言していないか（「売上が上がる」→「売上向上が期待できる」）
- 体験談に「個人の感想です」「成果を保証するものではありません」の注記があるか
- 医療・健康に関する表現がないか

### 特定商取引法チェック
- 価格表示に税込/税別が明記されているか
- 無料トライアルの自動課金条件が明示されているか
- 解約条件・手続き方法が記載されているか

### 著作権・商標チェック
- 他社の商標が無許可で使用されていないか
- 引用が出典元を明記し、適切な範囲内か
- 画像の利用権が確認されているか

### 個人情報保護法チェック
- フォームにプライバシーポリシーリンクがあるか
- 個人情報の利用目的が明示されているか
- Cookie同意の仕組みがあるか

## 出力形式
```markdown
## 法務レビュー結果

### リスクレベル: 低 / 中 / 高

### 🔴 Critical（公開不可 — 法的リスク）
- [該当箇所] [リスクの説明] [修正案]

### 🟡 Warning（修正推奨 — 潜在リスク）
- [該当箇所] [リスクの説明] [修正案]

### 🔵 Suggestion（予防的改善）
- [該当箇所] [リスクの説明] [修正案]
```

6.2 Agent Teams（並列レビュー）の設計

# コンテンツレビューチーム

## 概要
SEO・ブランド・法務の3つの観点でコンテンツを並列レビューし、
統合フィードバックを生成する。

## チーム構成

### エージェント1: SEO レビュアー
- エージェント定義: `.claude/agents/seo-reviewer.md`
- 担当: SEO品質の評価
- 出力: SEOスコアと改善提案

### エージェント2: ブランドチェッカー
- エージェント定義: `.claude/agents/brand-checker.md`
- 担当: ブランドガイドライン準拠の確認
- 出力: ブランド準拠率と違反箇所

### エージェント3: 法務レビュアー
- エージェント定義: `.claude/agents/legal-reviewer.md`
- 担当: 法的リスクの評価
- 出力: リスクレベルと修正提案

## 実行方法
```
3つのエージェントを並列で実行し、全てのレビューが完了したら
結果を統合レポートとしてまとめる。
```

## 統合レポート形式
```markdown
# コンテンツレビュー統合レポート

## 対象ファイル: [ファイルパス]
## レビュー日時: [日時]

## 総合判定: ✅ 公開可 / ⚠️ 要修正 / 🚫 公開不可

---

## SEO レビュー（スコア: ○○/100）
[SEOレビュアーの出力]

## ブランドチェック（準拠率: ○○%）
[ブランドチェッカーの出力]

## 法務レビュー（リスクレベル: 低/中/高）
[法務レビュアーの出力]

---

## 優先修正事項（Critical のみ抽出）
1. [最も優先度の高い修正]
2. [次に優先度の高い修正]
...
```

## 公開判定基準
- **公開可**: Critical 指摘が0件
- **要修正**: Critical 指摘が1-2件（修正後に再レビュー）
- **公開不可**: Critical 指摘が3件以上、または法務リスク「高」

並列レビュー体制

3つのレビューエージェントが並列実行される流れを示します。従来は3つのレビューを順番に行っていましたが、Agent Teams により同時実行が可能になり、レビュー時間を大幅に短縮できます。

Phase 4 -- 外部連携と分析

Phase 4 では、MCP を活用して GA4・HubSpot・SendGrid と連携し、マーケティングデータの自動取得と分析レポート生成を実現します。手動でのデータ集計作業をゼロにし、リアルタイムにデータに基づく意思決定ができる環境を構築します。

7.1 MCP（外部ツール連携）の設計

手順:

1. 各ツールのAPIキーを環境変数に設定する
2. .claude/settings.json にMCPサーバーの定義を追加する
3. AIに各ツールへのアクセス権限が与えられ、自然言語でデータを問い合わせ可能になる

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-hubspot"],
      "env": {
        "HUBSPOT_TOKEN": "${HUBSPOT_TOKEN}"
      }
    },
    "google-analytics": {
      "command": "npx",
      "args": ["-y", "mcp-ga4"],
      "env": {
        "GA4_PROPERTY_ID": "${GA4_PROPERTY_ID}",
        "GA4_CREDENTIALS_PATH": "${GA4_CREDENTIALS_PATH}"
      }
    },
    "sendgrid": {
      "command": "npx",
      "args": ["-y", "mcp-sendgrid"],
      "env": {
        "SENDGRID_API_KEY": "${SENDGRID_API_KEY}"
      }
    }
  }
}

# HubSpot
HUBSPOT_TOKEN=your-hubspot-api-token

# Google Analytics 4
GA4_PROPERTY_ID=your-ga4-property-id
GA4_CREDENTIALS_PATH=./credentials/ga4-service-account.json

# SendGrid
SENDGRID_API_KEY=your-sendgrid-api-key

# Algolia
ALGOLIA_APP_ID=your-algolia-app-id
ALGOLIA_ADMIN_KEY=your-algolia-admin-key

# SNS
TWITTER_API_KEY=your-twitter-api-key
LINKEDIN_ACCESS_TOKEN=your-linkedin-access-token

MCP 連携で何ができるか

ツール	MCP 経由で実行できること	従来の作業（手動）
GA4	PV数、直帰率、コンバージョン率、流入キーワードの取得と分析	GA4にログイン → エクスポート → Excel加工
HubSpot	リード情報の取得、スコアリング、キャンペーン成果の確認	HubSpotにログイン → ダッシュボードで確認 → スクショ共有
SendGrid	メール配信結果（開封率、クリック率、バウンス率）の取得と分析	SendGridにログイン → レポート画面で確認 → 手動集計

7.2 分析レポート自動生成

# マーケティングレポート生成スキル

## 概要
GA4・HubSpot・SendGrid のデータを統合し、
週次/月次マーケティングレポートを自動生成する。

## 入力
- レポート期間（必須）: weekly / monthly
- 比較対象（任意）: 前期比 / 前年同期比

## 生成手順

### 1. データ取得（MCP経由）

#### GA4 データ
- PV数（全体 + 記事別 Top10）
- セッション数・ユーザー数
- 直帰率・平均セッション時間
- 流入チャネル別セッション（Organic / Direct / Referral / Social / Email）
- コンバージョン率（目標別）
- 上位流入キーワード Top20

#### HubSpot データ
- 新規リード数（MQL / SQL）
- リードソース別内訳
- ライフサイクルステージ別推移
- キャンペーン別成果

#### SendGrid データ
- メール配信数
- 開封率・クリック率
- バウンス率・スパム報告率
- リンク別クリック数

### 2. 分析・考察
- KPI の達成率を算出
- 前期比の増減を分析
- 好調・不調のコンテンツを特定
- 流入チャネルの変化を分析

### 3. 改善提案
- データに基づく具体的なアクション提案を3つ以上
- 次のコンテンツテーマの推奨
- メール配信の最適化提案

### 4. レポート出力
```markdown
# マーケティングレポート（YYYY年MM月DD日 〜 MM月DD日）

## エグゼクティブサマリー
[3行以内で主要トピックを要約]

## KPI サマリー
| 指標 | 今期 | 前期 | 増減 | 目標 | 達成率 |
|------|------|------|------|------|--------|
| PV数 | X | Y | +Z% | A | B% |
| 新規リード数 | X | Y | +Z% | A | B% |
| MQL数 | X | Y | +Z% | A | B% |
| メール開封率 | X% | Y% | +Z pt | A% | - |

## チャネル別分析
[流入チャネルの詳細分析]

## コンテンツ パフォーマンス Top5
[PV数・CV貢献度の高い記事]

## メールキャンペーン結果
[配信結果の詳細]

## 改善提案
1. [データに基づく具体的提案]
2. [データに基づく具体的提案]
3. [データに基づく具体的提案]
```

## 出力先
- `reports/（YYYY-MM-DD）-marketing-report.md`

データフロー全体像

外部ツールからデータが集約され、レポートが生成されるまでのデータフローを示します。MCP がデータ取得のハブとなり、BigQuery がデータウェアハウスとして長期保存を担います。

運用ガイド

Phase 1〜4 で構築した基盤を実際に運用するためのガイドです。コンテンツカレンダーの管理、KPIモニタリング、継続的な改善サイクルについて解説します。

7.1 コンテンツカレンダー管理

週間コンテンツカレンダーの例

曜日	コンテンツ種別	担当	ステータス管理
月曜	ブログ記事（SEO）	コンテンツ担当A	/gen-blog → レビュー → /publish-content
火曜	メールキャンペーン	コンテンツ担当B	/gen-email → A/Bテスト設定 → 配信
水曜	SNS投稿（3件）	コンテンツ担当A	ブログ記事の要約 → 各SNS最適化 → 予約投稿
木曜	ブログ記事（事例）	コンテンツ担当B	/gen-blog → レビュー → /publish-content
金曜	週次レポート	マーケ責任者	/marketing-report → 分析 → 来週計画

コンテンツカレンダー管理用コマンド

# コンテンツカレンダーコマンド

## 概要
コンテンツカレンダーの確認・更新を行う。

## 使用方法
```
/content-calendar [week|month] [日付(任意)]
```

## 実行内容

### 週間表示（/content-calendar week）
1. `content/calendar/` 配下のカレンダーファイルを読み込む
2. 今週の予定を一覧表示
3. 各コンテンツのステータス（企画中/執筆中/レビュー中/公開済み）を表示
4. 遅延しているコンテンツがあればアラートを表示

### 月間表示（/content-calendar month）
1. 今月の全予定を一覧表示
2. キーワードの重複チェック
3. コンテンツ種別のバランスチェック（ブログ:メール:SNS の比率）
4. KPI 進捗（月間目標に対する達成率）

7.2 KPI モニタリング

KPI 体系

カテゴリ	KPI	月間目標	計測ツール
トラフィック	オーガニックセッション数	前月比 +15%	GA4
トラフィック	ブログPV数	50,000 PV	GA4
リード	新規MQL数	100件	HubSpot
リード	資料DL数	200件	HubSpot
エンゲージメント	メール開封率	25%以上	SendGrid
エンゲージメント	メールクリック率	3%以上	SendGrid
コンバージョン	LP CVR	3%以上	GA4
コンテンツ品質	SEOスコア平均	85点以上	check-seo-score.js
効率	記事公開までのリードタイム	3営業日以内	Git コミット履歴

7.3 改善サイクル

各フェーズの詳細

フェーズ	実施内容	使用する Claude Code 機能	担当
Plan	KPI設定、キーワード調査、コンテンツカレンダー作成	MCP（GA4でキーワード分析）、/content-calendar	マーケ責任者
Create	ブログ記事・メール・LP の生成	Skills（/gen-blog, /gen-email, /gen-lp）	コンテンツ担当
Publish	レビュー・修正・公開	Agent Teams（並列レビュー）、Commands（/publish-content）	コンテンツ担当 + エンジニア
Measure	KPI計測、レポート生成	MCP（GA4, HubSpot, SendGrid）、Skills（/marketing-report）	マーケ責任者
Optimize	CLAUDE.md・Rules・Skills の改善	データに基づく設定ファイル更新	チーム全員

Optimize フェーズの具体的なアクション

全体構成ファイル一覧

本ガイドで解説した全ての設定ファイルの一覧です。各ファイルの役割と、どの Phase で設定するかをまとめています。

Phase	ファイルパス	機能	役割
Phase 1	.claude/CLAUDE.md	CLAUDE.md	マーケ戦略・ペルソナ・ブランドガイドライン定義
Phase 1	.claude/rules/brand-guidelines.md	Rules	ブランドガイドライン強制（常時適用）
Phase 1	.claude/rules/seo-standards.md	Rules	SEO基準強制（パス別: content/**, src/pages/**）
Phase 1	.claude/rules/email-standards.md	Rules	メール配信基準強制（パス別: content/emails/**）
Phase 1	.claude/rules/legal-compliance.md	Rules	法務コンプライアンスチェック（常時適用）
Phase 1	.claude/settings.json	Hooks	品質チェック自動発火（SEOスコア、スパムスコア等）
Phase 2	.claude/skills/gen-blog/SKILL.md	Skills	SEO最適化済みブログ記事生成
Phase 2	.claude/skills/gen-email/SKILL.md	Skills	メールキャンペーン文面生成
Phase 2	.claude/skills/gen-lp/SKILL.md	Skills	ランディングページ生成
Phase 2	.claude/commands/publish-content.md	Commands	コンテンツ公開一連フロー自動化
Phase 3	.claude/agents/seo-reviewer.md	Agents	SEO品質レビューエージェント
Phase 3	.claude/agents/brand-checker.md	Agents	ブランドガイドライン準拠チェックエージェント
Phase 3	.claude/agents/legal-reviewer.md	Agents	法務リスク評価エージェント
Phase 3	.claude/agents/content-review-team.md	Agent Teams	3エージェント並列レビュー統合
Phase 4	.claude/settings.json (MCP部分)	MCP	GA4・HubSpot・SendGrid 外部連携
Phase 4	.claude/skills/marketing-report/SKILL.md	Skills	週次/月次マーケティングレポート自動生成
運用	.claude/commands/content-calendar.md	Commands	コンテンツカレンダー管理

導入ステップ

AI駆動マーケティング基盤を段階的に導入するためのステップです。一度に全てを設定するのではなく、Phase ごとに導入し、各段階で効果を確認しながら進めることを推奨します。

段階的な導入計画

期間	Phase	導入内容	期待効果
1-2週目	Phase 1	CLAUDE.md + Rules の設計	AIの出力品質が安定し、ブランドの一貫性が向上
3-4週目	Phase 2	Skills + Commands の設計	コンテンツ生成速度が3倍に向上
5-6週目	Phase 3	Agents + Agent Teams の設計	レビュー時間が1/3に短縮、品質の一貫性向上
7-8週目	Phase 4	MCP + 分析レポート	レポート作成時間が半日 → 数分に短縮
9週目以降	運用	PDCA サイクル開始	継続的な品質向上と成果改善

最初の一歩