KOL Report Analysis
メンバーマニュアル

最終更新: 2026-06-14 / 対応バージョン: Phase 4 (本番デプロイ済)

1. このシステムについて

KOL Report Analysis は、SNSタイアップ投稿 (X / Instagram / TikTok / YouTube) のパフォーマンスを多角的に分析し、広告主向けレポートを自動生成する社内ツールです。

主な機能

投稿パフォーマンス分析 — 再生数・エンゲージメント・コメント傾向を可視化
クリエイティブスコア — クリエイターの普段の実績との比較
AIコメント分類 — Gemini API で態度変容・ネガティブ等を自動判定
動画コンテンツ分析 — タテ型ショート動画の構成・形式を AI が解析
Google検索リフト — ブランド検索の施策前後比較
ハッシュタグ波及 — キャンペーンタグの広がりを定量化
pptx自動生成 — 広告主向けレポートをワンクリックで出力

アクセス URL

https://um-kol-analysis.duckdns.org

※ ブックマーク推奨。ログインは Google アカウント不要、メアド + パスワード方式です。

役割 (ロール)

ロール	できること	できないこと
admin	全機能、メンバー管理、設定変更	—
operator	データ取得・分析・レポート生成・編集	メンバー管理
viewer	閲覧のみ (全タブの読み取り)	データ取得・編集・スクレイピング

2. 初回ログイン

管理者から メアド + 一時パスワード を受け取ったら、初回ログインを行います。

URL を開く

ブラウザで https://um-kol-analysis.duckdns.org にアクセスします。

ログイン画面で入力

メールアドレス: 管理者から伝えられた自分のメアド
パスワード: 一時パスワード (英大文字小文字数字混在の12文字)

「ログイン」ボタンをクリック

強制パスワード変更

自動的にパスワード変更画面に切り替わります。次のセクション参照。

⚠️ 一時パスワードはコピペで確実に

英大文字小文字の見間違い (I と l、O と 0 等) を避けるため、必ずコピペしてください。手打ちは推奨しません。

3. パスワード変更

初回ログイン時は自動で変更画面が出ます。任意のタイミングで再変更したい場合は管理者にリセット依頼してください (任意で自分で変える UI は今後追加予定)。

変更画面での入力

現在のパスワード: 一時PW (または現在のPW)
新しいパスワード: 8文字以上、できれば 14文字以上
新しいパスワード (確認): 上と同じものをもう一度

強いパスワードの条件

✅ 14文字以上
✅ 英大文字 / 英小文字 / 数字 / 記号を混在
❌ 他サービスとの使い回し
❌ 個人情報 (誕生日、名前) を含める
❌ 辞書にある単語そのまま

💡 おすすめ: パスワードマネージャ

1Password / Bitwarden / Apple Keychain 等で生成・保存すると忘れる心配なし。

4. パスワードを忘れたら

自分でリセットする機能はありません。管理者に依頼してください。

Slack DM で管理者に連絡

例: 「パスワードを忘れました、リセットお願いします」

管理者が新しい一時PWを発行

管理者は「⚙️ 設定」タブから 30秒で発行できます。

新しい一時PWでログイン → 強制PW変更

通常の初回ログインと同じ流れです。

🚨 パスワード漏洩 / 盗難時

すぐに管理者にリセット依頼してください。漏洩疑いがあれば、管理者が session_secret 全体のローテーション を行って既存セッションを一括無効化することもできます (全員強制ログアウト)。

5. ダッシュボードの構造

ログイン後の画面は、上から順に下記の4ブロックで構成されます。

┌──────────────────────────────────────┐
│ 5-1. ヘッダー                            │
│  📊 ロゴ  | 🔄更新 | 🌙 ダーク | ⚙ jobs | 👤 user │
├──────────────────────────────────────┤
│ 5-2. 案件バー                            │
│  📁 案件:[選択▼] [+新規] [✏編集] [🗑削除]   │
├──────────────────────────────────────┤
│ 5-3. プラットフォームフィルタ              │
│  🌐 全 | 🐦 X | 📸 IG | 🎵 TT | ▶️ YT     │
│  📊 view_mode: 広告込 | オーガニックのみ      │
├──────────────────────────────────────┤
│ 5-4. タブ群 (機能切替)                   │
│  📑 資料作成 | 📈 全体サマリー | 🎯 投稿... │
├──────────────────────────────────────┤
│ メインコンテンツ (選択したタブの中身)         │
└──────────────────────────────────────┘

項目	説明
取得日時	最後にデータ取得した時刻
🔄 更新	サーバーから最新データを再取得
🌙 ダークモード	テーマ切替 (ライト ⇄ ダーク)
⚙️ N/M	ジョブキューの状況 (実行中/待機中)。クリックで監視タブへ
ユーザバッジ	自分のロール・メアド表示、「⎋」でログアウト

5-2. 案件バー

分析対象の案件を選びます。1人のユーザーが複数案件を切り替えながら作業します。

5-3. プラットフォームフィルタ

表示するデータをプラットフォーム別に絞り込みます。「🌐 全プラットフォーム」で全表示。

view_mode トグル

広告込 (total) — 取得した再生数そのまま (デフォルト)
オーガニックのみ (organic) — 「💰 広告配信設定」タブで入力した広告分を引いた値

切替えると全レポートが連動して再計算されます。

5-4. タブ群

主要機能の切替。詳細はセクション6で各タブを説明します。

5-5. ロールによる表示差

表示要素	admin	operator	viewer
📁 案件 + 新規/編集/削除	✅	✅	表示のみ・編集不可
💰 広告配信設定タブ	✅	✅	❌
🔔 監視タブ	✅	✅	❌
🛠️ ツール / URL管理タブ	✅	✅	❌
⚙️ 設定タブ	✅	❌	❌

6. 各タブの詳細

📑

資料作成

広告主向けレポート (pptx)

→ 詳細

📈

全体サマリー

KPI 一覧と概況

→ 詳細

🎯

投稿パフォーマンス

散布図 + コンテンツ分析

→ 詳細

💬

コメント分析

AI分類 + 抜粋

→ 詳細

📊

クリエイティブスコア

普段比較ベンチマーク

→ 詳細

📝

投稿一覧

全投稿テーブル

→ 詳細

💰

広告配信設定

広告再生数の入力

→ 詳細

🔔

監視

ジョブキュー + エラー監視

→ 詳細

🛠️

ツール / URL管理

スクレイピング実行

→ 詳細

⚙️

設定 (admin)

メンバー管理

→ 詳細

6-1. 📑 資料作成

広告主提出用のレポート (pptx) を生成するメインタブ。R1〜R8 の各分析を統合します。

サブページ

サブ	内容
📋 エグゼクティブサマリー	総合評価 ★ + 認知/共感/検討ファネル + 主要KPI
🩺 ヘルスチェック診断	D1再生数 / D2訴求 / D3検討 / D4記憶 / D5ネガの5項目自動診断
🔍 Google検索リフト	ブランド指名検索の施策前後比較 (R3)
📈 ハッシュタグ波及	キャンペーンタグの広がり (R4)
💭 コメントファネル位相	4段ファネルマッピング (R5)
▶️ 動画完視聴・滞在価値	TT/YT 動画分析 (R6)
📦 pptx 自動生成	セクション選択 → ワンクリック生成 (R7)

💡 pptx 生成のコツ

Claude/Gemini APIキー設定が必要です (現状 Gemini 使用)。生成時に文章は AI が書きますが、最後は必ず人間が読んでチェック → 修正してから広告主に提出してください。

6-2. 📈 全体サマリー

案件全体の数値概況を一覧で把握するためのタブ。

表示要素

統計カード: 総再生・総エンゲ・コメント数・CPV/CPE 等
プラットフォーム別棒グラフ: X/IG/TT/YT の比較
トップ投稿 TOP3: 各KPIで上位を表示
センチメント円グラフ: ポジ/ネガ/中立の比率
日次推移: 投稿日からの累積
クリエイティブスコア概要: PRcomparison のサマリ

6-3. 🎯 投稿パフォーマンス分析

投稿1つひとつのパフォーマンスを散布図で可視化 + コンテンツ分析機能。

📍 散布図 (投稿パフォーマンスマッピング)

X軸/Y軸: 再生数 / エンゲージ数 / 態度変容率 / ネガ率 / クリエイティブスコアから選択可
1点 = 1投稿: 色はプラットフォーム別、アカウント名表示
点クリック: 選択トグル (黄色いリング)
Shift+クリック: 投稿一覧へジャンプ
クイック選択: Y軸上位3/5/10、右上象限、全YT 等

📋 コンテンツ分析 (R8)

選択した投稿群とその他を AI が比較分析し、「動画形式 / 構成 / インフルエンサー像 / 推奨秒数」をまとめた「次回オリエンシート」を出力します。

散布図上で高パフォーマンス投稿を選択
「📋 コンテンツ分析実行」ボタン
Gemini が動画を直接視聴 (3〜5分)
結果が4セクション (折畳可) で表示
「📋 全文コピー」でMarkdown化、オリエンに貼付

⚠️ 解析対象は「タテ型ショート動画」のみ

YouTube は /shorts/ URL、TikTok 全て、Instagram は /reels/ URL のみ対応。長尺YouTube動画は対象外で自動除外されます。

6-4. 💬 コメント分析

「🎯 投稿パフォーマンス分析」のドロップダウンから入れるサブタブ。

機能

AIコメント分類: Gemini が brand_find / purchase_intent / question / negative_influencer 等に分類
カテゴリ別投稿×件数マトリクス: どの投稿のコメントが何の傾向か可視化
コメント抜粋: 各カテゴリの代表コメントを表示
クリエイター返信検出: クリエイター本人のコメントを別表示

💡 AI分類の実行

「AIコメント分類実行」ボタンを押すと Gemini API が動きます。コメント約 200件で 5円〜10円 程度のコスト。

6-5. 📊 クリエイティブスコア分析

クリエイターの普段のオーガニック投稿との比較で、今回のタイアップが伸びたかを定量化。

クリエイティブスコアとは

クリエイティブスコア (CS) = 今回投稿の再生数 ÷ 過去N件のオーガニック平均

CS値	解釈
1.0以上	普段の平均以上 ✅ 「効いた」
0.7〜1.0	同程度
0.7未満	普段を下回る ❌ 効果薄

前提: クリエイター履歴の取得

CS算出にはクリエイターの直近10件のオーガニック投稿データが必要。「🛠️ ツール」タブで取得してください。

6-6. 📝 投稿一覧

全投稿をテーブル表示。検索・ソート可能。

機能

キーワード検索 (アカウント名・本文)
ソート: 再生数 / エンゲージ率 / 投稿日 / 等
各投稿カードに: サムネ + 再生数 + 主要KPI
カードクリック → 該当投稿の元URLを開く

6-7. 💰 広告配信設定

各投稿の広告配信による再生数を手動入力するタブ。

運用方法

テーブルに全投稿のURLが並ぶ
「広告再生数」欄に数値を入力 (案件終了後に広告主から取得)
「保存」
ヘッダー横の view_mode トグルで「オーガニックのみ」に切替えると、保存した広告分が引かれた値で全レポート再計算

⚠️ 入力対象は「今回案件の投稿」のみ

クリエイター履歴 (過去オーガニック投稿) の数値は触らないでください。CS計算が狂います。

6-8. 🔔 監視

ジョブキューの状況とエラー監視。

⚙️ ジョブキューパネル

5名同時にスクレイピングを押しても、bot検知回避のためプラットフォーム別の上限内でジョブが順次処理されます。

プラットフォーム	同時実行	1日上限
▶️ YouTube	2	500投稿
🎵 TikTok	1	100投稿
📸 Instagram	1	200投稿
🐦 X	1	150投稿

ジョブ一覧: queued / running / done / failed / cancelled で絞込可
キャンセル: queued (待機中) のみキャンセル可。running は不可
5秒毎自動更新

🔔 エラー監視 / Slack通知

スクレイパー失敗・Cookie Pool BAN等を自動記録。Slack Webhook URL を設定すれば重大エラーを即時通知。

6-9. 🛠️ ツール / URL管理

データ取得実行のタブ。最重要かつ最も注意が必要なタブ。

主な機能

URL一括追加: テキストエリアにURL貼付 → プラットフォーム自動判別 → 追加
期間設定: 1d / 7d / 30d プリセットまたはカスタム日付
「今日のスクレイプ実行」: 期間内のURLを取得
「全URL再取得」: 強制的に全URLを再取得
クリエイター履歴取得: CS算出用
Cookie Pool 管理: IGのスクレイピングアカウント管理
スナップショット: 日次の状態保存・比較

🚨 メンバーアカウントの入力時の必須ルール

IG/X認証アカウントは絶対にメインアカウントを使用しないこと。サブ/捨てアカウントのみ使用。BANリスク対策の絶対ルール。

⚠️ 期間設定の罠

URL一覧で1件削除すると、過去には残り全URLの期間が「今日」に書き換わるバグがあった (Phase 4 で修正済)。期間が予期せず変わったら必ず確認。詳細はセクション 8-4。

6-10. ⚙️ 設定 (admin専用)

メンバーの追加・削除・PWリセット。admin ロールのみ表示。

👥 メンバー管理

操作	手順
新規追加	メアド入力 → ロール選択 (operator/admin) → 「+ 追加」 → 一時PW がモーダル表示 → コピーして本人に伝達
PWリセット	該当行「🔁 PWリセット」 → 一時PW がモーダル表示 → 本人に伝達
削除	該当行「削除」 → 即座にログイン不可になる

🌐 閲覧専用ドメイン

ドメイン (例: uuum.jp) を登録すると、そのドメインのユーザーは viewer ロールでログイン可能。※ 現在は手動で operators.json に viewer を追加する運用 (UI改修予定)。

7. よくある作業フロー

7-1. 新規案件登録〜分析

案件作成

案件バーの「+ 新規案件」 → 案件名・説明・URL一覧を入力 → 作成

期間設定

URL一覧画面で各URLの取得期間 (start_date / end_date) を設定

スクレイピング実行

「🛠️ ツール」タブから「今日のスクレイプ実行」または「全URL再取得」

取得完了待ち

「🔔 監視」タブでジョブ状況を確認 (10分〜数時間)

AIコメント分類

「💬 コメント分析」タブで「AI分類実行」

クリエイター履歴取得

「🛠️ ツール」でCS算出用に履歴取得

広告再生数入力

案件完了後、広告主から数値受領 → 「💰 広告配信設定」に入力

レポート生成

「📑 資料作成」でセクション選択 → pptx ダウンロード

7-2. 動画解析 (コンテンツ分析)

「🎯 投稿パフォーマンス分析」を開く

散布図上で高パフォーマンス投稿を選択

点を直接クリック (黄色いリング) またはクイック選択「Y軸上位3/5/10」「右上象限」

「📋 コンテンツ分析実行」ボタン押下

解析完了まで待機

1投稿 1〜2分、5投稿で 5〜10分。進捗バーで確認

結果の確認 (4セクション折畳)

動画形式 / 動画構成 / インフルエンサー像 / 特徴・ポイント

「📋 全文コピー」

Markdown形式でクリップボードにコピー → オリエンシートに貼付

7-3. レポート pptx 自動生成

「📑 資料作成」タブ

含めるセクション選択

エグゼ / ヘルスチェック / コメントファネル / 動画完視聴 / 検索リフト / ハッシュタグ波及から ON/OFF

設定の確認

キーワード (ブランド名)、ハッシュタグ、view_mode 等

「pptxを生成」

Claude/Gemini API が動く (1〜2分)

ダウンロード → 内容確認 → 修正

AI生成文章は必ず人間チェック。固有名詞・数値・文体を確認して提出

7-4. ハッシュタグ波及分析

「📑 資料作成」→ サブページ「📈 ハッシュタグ波及分析」
ハッシュタグ入力 (例: ZOZOTOWN_EDUCATION)、ソース選択 (X/TikTok)
「取得実行」 — X は数秒、TT は CAPTCHA 介入が必要な場合あり (1〜2分)
キャンペーン前後の投稿数推移グラフ表示

7-5. Google検索リフト

「📑 資料作成」→ サブページ「🔍 Google検索リフト分析」
ブランドキーワード入力、ソース選択 (Web / YouTube)、期間 (デフォルト30日)
取得 (5〜30秒) → 施策前後の平均検索数比較 + 日次グラフ

⚠️ 期間が複数の案件は要注意

施策開始日は「URL の最早 start_date」が自動採用されます。バッチが複数期間にまたがる案件では片方しか分析されないことがあります。

8. 運用上の注意

8-1. BAN対策とアカウント

🚨 メインアカウント絶対禁止

IG/X認証アカウントはサブ・捨てアカウントのみ使用。
メインアカウントを使用するとBAN/凍結リスクで業務不能になります。

並列処理の制限 (システムが自動制御)

TT/IG/X は同時 1ジョブまで
YT は同時 2ジョブまで
5人が同時に取得ボタン押しても、サーバが順番待ちで平準化
日次上限到達 → 翌日まで待機

8-2. APIコストとキャッシュ

機能	1案件あたりコスト	キャッシュ
AIコメント分類 (Gemini)	¥5〜30	1度実行すれば再実行不要
動画コンテンツ分析 (Gemini Pro)	¥60〜200	per-投稿で永続キャッシュ
pptx生成文章 (Gemini)	¥5〜10	毎回生成
Google Trends	無料	24時間キャッシュ

キャッシュは _cache_videos / _cache_analysis / _cache_briefs に保存。同じ動画を2度解析しません。コスト節約のために、解析対象投稿はよく選んでください。

8-3. データ取り扱い

プロジェクトデータ は VPS の projects/<案件名>/ に保存
毎日深夜に自動バックアップ (7日分保持) → /srv/comment-analyzer/backups/
退職者の Cookie Pool アカウントは 必ず削除依頼してください
クライアント機密情報を含むため、URL を SNS等に投稿しない

8-4. 期間設定の落とし穴

⚠️ Phase 4 で修正済の既知バグ

以前 URL を1件削除した時に、残り全URLの期間が「今日〜今日+7日」に勝手に書き換わる不具合がありました。現在は修正済で発生しませんが、念のため URL 操作の前後で期間を目視確認することを推奨します。

正しい期間設定の運用

新規案件登録時に「7d / 30d プリセット」またはカスタム日付で指定
1度設定したら、URLの追加・削除をしても期間は保持される
意図的に変更したい場合は「期間プリセット適用」で明示的に変更

9. FAQ

Q. ログインできません

A. メアド・パスワードのコピペミスを確認 → 改善しなければ管理者に PWリセット依頼。

Q. スクレイピングを押したのに何も動かない

A. 「🔔 監視」タブでジョブキューを確認。queued (待機中) で順番待ち中かもしれません。プラットフォーム別の上限を超えた場合は翌日待ち。

Q. 投稿数が想定より少ない

A. 「💬 コメント分析」タブで「全投稿の AI分類済件数」を確認。IGはコメント取得失敗が稀にあるので、「🛠️ ツール」で再取得を試行。

Q. クリエイティブスコアが表示されない

A. 「🛠️ ツール」でクリエイター履歴を取得していない可能性。各クリエイターの直近10件オーガニック投稿が必要です。

Q. pptx の文章を AI に書き直してもらいたい

A. 「再生成」ボタンで再実行。ただしコストかかるので、できれば手動修正で済ませることを推奨。

Q. 過去の案件データを見たい

A. 案件バーのドロップダウンから過去案件を選択。削除していなければ全データ残っています。

Q. ブラウザを閉じたらログアウトされる?

A. 24時間は再ログイン不要。それ以降は再度ログイン。

Q. スマホで使える?

A. PC推奨ですが、スマホブラウザでも閲覧は可能。ただし散布図の操作・大きなテーブルは PC で。

10. 問い合わせ先

用件	連絡先
パスワードリセット / 操作方法	管理者 (miyazaki_y@uuum.jp) に Slack DM
機能追加要望 / バグ報告	管理者に Slack DM
本番サーバ障害 (アクセスできない)	管理者 + 開発者同時連絡
クライアントから問い合わせ	管理者経由で対応

📚 さらに詳しい情報

サーバの運用ガイド・障害対応プレイブックは社内 GitHub の docs/ ディレクトリ参照。

KOL Report Analysis メンバーマニュアル v1.0
本マニュアルへのフィードバックは管理者まで

KOL Report Analysisメンバーマニュアル

1. このシステムについて

主な機能

アクセス URL

役割 (ロール)

2. 初回ログイン

3. パスワード変更

変更画面での入力

強いパスワードの条件

4. パスワードを忘れたら

5. ダッシュボードの構造

5-1. ヘッダー

5-2. 案件バー

5-3. プラットフォームフィルタ

view_mode トグル

5-4. タブ群

5-5. ロールによる表示差

6. 各タブの詳細

6-1. 📑 資料作成

サブページ

6-2. 📈 全体サマリー

表示要素

6-3. 🎯 投稿パフォーマンス分析

📍 散布図 (投稿パフォーマンス マッピング)

📋 コンテンツ分析 (R8)

6-4. 💬 コメント分析

機能

6-5. 📊 クリエイティブスコア分析

クリエイティブスコアとは

6-6. 📝 投稿一覧

機能

6-7. 💰 広告配信設定

運用方法

6-8. 🔔 監視

⚙️ ジョブキューパネル

🔔 エラー監視 / Slack通知

6-9. 🛠️ ツール / URL管理

主な機能

6-10. ⚙️ 設定 (admin専用)

👥 メンバー管理

🌐 閲覧専用ドメイン

7. よくある作業フロー

7-1. 新規案件 登録〜分析

7-2. 動画解析 (コンテンツ分析)

7-3. レポート pptx 自動生成

7-4. ハッシュタグ波及分析

7-5. Google検索リフト

8. 運用上の注意

8-1. BAN対策とアカウント

並列処理の制限 (システムが自動制御)

8-2. APIコストとキャッシュ

8-3. データ取り扱い

8-4. 期間設定の落とし穴

正しい期間設定の運用

9. FAQ

Q. ログインできません

Q. スクレイピングを押したのに何も動かない

Q. 投稿数が想定より少ない

Q. クリエイティブスコアが表示されない

Q. pptx の文章を AI に書き直してもらいたい

Q. 過去の案件データを見たい

Q. ブラウザを閉じたらログアウトされる?

Q. スマホで使える?

10. 問い合わせ先

KOL Report Analysis
メンバーマニュアル

📍 散布図 (投稿パフォーマンスマッピング)

7-1. 新規案件登録〜分析