X Engagement Analyzer

X(Twitter)の投稿を解析し、バイラル(バズる)可能性を予測するChrome拡張機能です。17種類のエンゲージメント指標を分析して0-100点のスコアを算出します。

主な機能

リアルタイム分析

• タイムライン上の全投稿にバズスコアバッジを自動表示
• 無限スクロール対応（MutationObserver）
• SPA遷移の自動検知

エンゲージメント予測

いいね、リプライ、リポスト、引用、共有、クリック、滞在時間、フォローの8種類のポジティブアクションを重み付け予測します。

サイドパネル分析

• バッジクリックで詳細分析を表示
• バイラルスコア、インプレッション予測、成長カーブグラフ
• テキスト・画像・動画・ハッシュタグの個別分析
• エンゲージメント改善提案

投稿前プレビュー分析

• 投稿作成画面でリアルタイムにスコアを表示
• 投稿前に改善ポイントを確認可能
• プライバシー同意後に有効化

ダッシュボード

• 分析履歴の一覧表示
• 投稿タイミングヒートマップ（時間帯 x 曜日）
• エンゲージメント統計
• CSV/JSONエクスポート

その他

• ダークモード / ライトモード切り替え（自動保存）
• 予測精度の自動検証（24-48時間後に実績値と比較）
• IndexedDBによる大容量データ保存

インストール

1. ダウンロード

方法A: ZIPファイル

1. このページ右上の緑色「Code」ボタンをクリック
2. 「Download ZIP」を選択
3. ダウンロードしたZIPを解凍

方法B: git clone

git clone https://github.com/TKojima85th/X-buzz-analyzer.git

2. Chrome拡張機能として読み込む

1. Chromeで chrome://extensions/ を開く
2. 右上の「デベロッパーモード」をONにする
3. 「パッケージ化されていない拡張機能を読み込む」をクリック
4. ダウンロードしたフォルダ内の x-engagement-analyzer/dist を選択
5. x.com にアクセスすると自動的にスコアが表示されます

使い方

スコアの見方

スコア	色	意味
80-100	ピンク	超バズる可能性大
60-79	青	バズる可能性高
40-59	緑	中程度
0-39	オレンジ	バズりにくい

基本操作

1. X.comのタイムラインを閲覧 -> 各投稿にスコアバッジが表示
2. バッジにホバー -> 簡易情報のツールチップ
3. バッジをクリック -> サイドパネルで詳細分析・改善提案

サイドパネル

• 分析タブ: 投稿の詳細分析、スコア内訳、改善提案
• ダッシュボードタブ: 分析履歴、統計、ヒートマップ
• エクスポートタブ: CSV/JSONでデータ書き出し

テーマ切り替え

サイドパネル右上のボタンでダークモード/ライトモードを切り替え。設定は自動保存されます。

トラブルシューティング

マニフェストファイルがありませんエラー

x-engagement-analyzer/dist フォルダを選択してください（プロジェクトルートではありません）。

スコアが表示されない

• X.comにログインしているか確認してください
• 拡張機能が有効になっているか chrome://extensions/ で確認
• ページを再読み込み（F5）してください

サイドパネルが開かない

• 拡張機能アイコンをクリックしてサイドパネルを開きます
• Chrome 114以降が必要です

スコアが急に表示されなくなった

X(Twitter)はDOM構造を定期的に変更します。Issueで報告いただければ対応します。

プライバシー

この拡張機能はプライバシーを最優先に設計しています。

• 完全ローカル処理: 全ての分析はブラウザ内で完結します
• 外部通信なし: 外部サーバーへのデータ送信は一切ありません
• 最小権限: 必要最小限のChrome権限のみ要求
  • storage / unlimitedStorage: 分析データのローカル保存
  • sidePanel: 詳細分析パネルの表示
  • alarms: 予測精度の定期検証
  • host_permissions: x.com / twitter.com のみ
• 投稿前分析: プライバシー同意を得てから有効化（いつでもOFF可能）
• データ管理: エクスポートタブからいつでもデータの確認・削除が可能
• 情報提供の要求なし: この拡張機能がユーザーに対して個人情報やアカウント情報の入力・提供を求めることは一切ありません。外部接続による情報収集も行いません

技術仕様

項目	内容
プラットフォーム	Chrome Extension Manifest V3
言語	TypeScript
ビルド	Webpack 5
NLP	compromise.js
センチメント分析	sentiment.js
データ保存	IndexedDB (フォールバック: chrome.storage.local)
対応ブラウザ	Chrome 114以降

コントリビューション

バグ報告や機能リクエストは Issues からお願いします。

ライセンス

MIT License

謝辞

• compromise - 軽量NLPライブラリ
• sentiment - センチメント分析

免責事項

• この拡張機能は教育・研究目的で開発されており、「現状有姿（AS IS）」で提供されます。
• 本ソフトウェアの使用により生じたいかなる損害（データの損失、アカウントへの影響、X(Twitter)の利用規約違反を含むがこれに限らない）についても、開発者は一切の責任を負いません。
• スコアや予測値はヒューリスティック分析に基づく参考値であり、正確性を保証するものではありません。
• X(Twitter)の利用規約を遵守した上で、自己責任でご使用ください。