システム概要
このシステムは楽天・Shopify・Amazon の3モールのレビューを一元管理し、自動でダッシュボードを更新します。
毎週 月曜日 を目安に、下記の手順でファイルを配置し update_reviews.bat を実行してください。
楽天
CSV形式（手動配置）
rakuten/ フォルダ
Shopify
Judge.me API（自動取得）
設定不要
Amazon
MHTML形式（手動配置）
amazon/ フォルダ
週次作業手順
楽天レビューCSVを取得する
楽天RMS① 楽天RMS（店舗管理システム）にログイン
② 「レビュー管理」 → 「レビュー一覧」 を開く
③ 期間を指定（前週月曜〜日曜）して 「CSVダウンロード」 をクリック
④ ダウンロードしたCSVファイルを review_collect/rakuten/ フォルダに配置
ファイル名: そのままで可（例: review_20260601.csv）。複数ファイルあっても一括処理されます。
Shopifyレビューは自動取得
Judge.me APIJudge.me API に接続して新着レビューを自動取得するため、手作業は不要です。
update_reviews.bat 実行時に差分のみ取得します（重複は自動スキップ）。
APIキー設定場所: config.yaml の judgeme セクション。キーを再発行した場合はここを更新してください。
Amazonレビューページを保存する
Amazon Seller Central① Amazon Seller Centralにログイン
② 「ブランド分析」 または 「カスタマーレビュー」 ページを開く
③ ブラウザのメニューから 「名前を付けてページを保存」 を選択
④ 保存形式を 「ウェブページ、1つのファイル (*.mhtml)」 に変更して保存
⑤ 保存したMHTMLファイルを review_collect/amazon/ に配置
ページが複数の場合: ページごとに別々のMHTMLで保存し、すべてamazon/フォルダに入れてください。1回の実行で全ファイルを処理します。
update_reviews.bat をダブルクリックして実行
① review_collect/ フォルダ内の update_reviews.bat をダブルクリック
② 黒いウィンドウ（コマンドプロンプト）が開き、処理が始まります
③ 「Done.」 と表示されたら成功。Enterまたはウィンドウを閉じてください
④ エラーが出た場合は errors/ フォルダを確認してください
自動処理内容: 楽天CSV取込 → Judge.me API取得 → Amazon MHTML取込 → AI分析 → ダッシュボード生成 → GitHub反映（約1〜3分）
ダッシュボードを確認する
① 数分後にダッシュボードURLをブラウザで開く（キャッシュをクリアする場合は Ctrl+Shift+R）
② 「概要」ページで最終更新日時と件数が更新されていることを確認
③ 商品マスタ未登録の商品レビューは「未分類」として表示されます（動作は正常です）
注意事項
ファイル形式を間違えない（楽天・Amazon）
楽天は CSV、Amazon は MHTML（Webページ完全保存）形式のみ対応しています。HTMLやPDFでは取り込めません。
処理済みファイルは自動的に archive/ へ移動
実行後、各モールの入力フォルダからファイルが消えます。これは正常な動作です。バックアップは archive/ フォルダに保存されています。
重複レビューは自動スキップ（データは消えません）
同じレビューを複数回取り込んでも、重複は自動検知してスキップします。毎回「全件」エクスポートでも安心して使えます。
新商品を追加する場合は product_master.csv を更新
master/product_master.csv に商品コード・正式名称・カテゴリ・ブランドを追記してください。未登録商品のレビューは「未分類」として表示されます。次回実行時に自動で紐付けを試みます。
インターネット接続が必要
Judge.me APIアクセス・AI分析（Claude API）・ダッシュボード反映（GitHub）にインターネット接続が必要です。オフライン環境では --no-ai オプションのみ利用可能です（API取得は実行されます）。
フォルダ構成
review_collect/
├── rakuten/ ← 楽天CSVを配置（処理後に archive/ へ）
├── shopify/ ← Judge.me CSV手動補完用（通常は不要）
├── amazon/ ← Amazon MHTMLを配置（処理後に archive/ へ）
├── archive/ ← 処理済みファイルのバックアップ
├── backup/ ← DBの自動バックアップ
├── db/ ← SQLiteデータベース（削除禁止）
├── errors/ ← 取込失敗ファイル・エラーログ
├── master/ ← product_master.csv（商品マスタ）
├── public/ ← 生成されるダッシュボードHTML（GitHub管理）
└── update_reviews.bat ← 実行ファイル（これをダブルクリック）
よくあるトラブルと対処法
バットファイルをダブルクリックしても何も起きない / すぐ閉じる
→ errors/ フォルダ内の最新ログファイル（error_log_YYYYMMDD.txt）を確認してください。
→ Pythonが正しくインストールされているか確認してください（Python 3.13以上）。
Amazonのレビューが一部しか取り込まれない
→ MHTMLの保存形式を確認してください。「ウェブページ、1つのファイル (*.mhtml)」でないと正しく読み込めません。
→ レビューが複数ページに分かれている場合、全ページ分のMHTMLを保存してamazon/に配置してください。
Shopifyのレビューが取得されない
→ config.yaml の judgeme.api_token と judgeme.shop_domain が正しく設定されているか確認してください。
→ インターネット接続を確認してください。
→ Judge.me管理画面でAPIトークンが有効か確認してください（再発行後はconfig.yamlを更新してください）。
ダッシュボードが更新されない
→ Done. が表示されたか確認してください（エラーではなく正常終了したか）。
→ Cloudflareのデプロイには1〜2分かかります。しばらく待ってからページを再読み込みしてください（Ctrl+Shift+R）。
→ インターネット接続を確認してください（GitHub Pushに接続が必要です）。
「未分類」のレビューが多い
→ 「未分類」は product_master.csv に未登録の商品のレビューです。表示・集計は正常に行われます。
→ 商品として管理したい場合は master/product_master.csv に追記し、再度 update_reviews.bat を実行してください。次回実行時に自動で紐付けされます。
ダッシュボードにログインできない
→ パスワードはCloudflare Pagesの環境変数 DASHBOARD_PASSWORD に設定されています。
→ パスワードを忘れた場合は、システム管理者にお問い合わせください。
問い合わせ・設定変更
商品マスタの追加・システムの設定変更・エラーが解決しない場合は、システム担当までご連絡ください。
errors/ フォルダ内のログファイルを共有いただけると、迅速に対応できます。