🎁 Mellojoy Sniper · ちゃみさん専用ガイド 拡張 v…

🎁 ちゃみさん、いつもありがとうございます

Mellojoy Sniper の Chrome 拡張で 代理購入 していただくための説明ページです。 12時の補充に合わせて Chrome 拡張を開いておくだけで、stock_change が来た商品をすべて各1個ずつ自動でカート投入し、Shopifyの結果で判定します。ちゃみさんは Shop Pay で決済するだけでOKです。

✅ こうなってれば 全部 OK

拡張アイコンを開いて 「準備OK」と出ていれば大丈夫

🟢 通常時 (1日中ほぼこれ)
popup に 「準備OK」と緑バッジで表示。これだけ確認できれば 12 時補充に向けて自動で待機している状態です。
⚡ 12 時前後 (11:55〜12:15)
popup が自動で 「⚡ 補充モード」に切替わり、ピンク/オレンジで脈動。検知・投入カウントが 0.5 秒ごとに更新されます。
⚠ 異常 (Kosuke に連絡)
「⚠ サーバー応答なし」が 5 分以上続く場合のみ問題。それ以外 (「🟡 接続中…」「🟢 準備OK」「⚡ 補充モード」) は全部正常です。

💡 拡張アイコンを ピン留めしておくと、popup を開かなくてもバッジで状態がわかります。
💡 12 時前は popup を 開きっぱなしにしておくと、補充の瞬間に検知・カート投入の様子がリアルタイムで見えます。
💡 12 時の決済 (Shop Pay) 以外、ちゃみさんは 何もしなくて OK。すべて自動です。

📚 補足情報

🆕 v0.5.6 (2026-05-13): 困った時の「🆘 動かない時は」 折りたたみ section を popup 最下部に追加しました。
※ 「サーバー応答なし」 のまま固まる、 12時にカート入らない、 何もしてないのに動かない、 等の よくある症状と対処 をワンタップで参照できます。
※ ボタン 2 個: 🔄 拡張を再読込 (95% これで解決) / 🔥 全部初期化 (最後の手段、 個人情報は入っていません)。
※ それでも解決しない時の Kosuke さんへの連絡方法 (スクショ + 表示文字を LINE で送る) も明記。
🛠 v0.5.5 修正 (2026-05-10): 🎁 バンドル投入を押した時に「race condition」 でエラーで処理が止まる不具合を修正済 (v0.5.5 以降は出ません)。
🟢 認証撤廃 (v0.5.0〜): Basic Auth は廃止しました。拡張をインストールしたら何も入力せず自動接続します。
※ MellojoyJapan のショップ側ログインはちゃみさんのアカウントを使用します。
📌 ピン留め必須: Chrome 仕様上、拡張は最初パズル🧩 内に隠れます。パズル🧩 → Mellojoy Sniper の右の📌 で常時表示に。
🌏 マレーシアからアクセス時: Mellojoyjapan.com は マレーシア IP を anti-bot で弾くことがあり (Access Denied)、カート投入失敗。ちゃみさん (日本) は影響なし。Kosuke がマレーシアから検証する時は VPN で日本 IP に切替が必要。
🔁 SSE 切断は正常: Cloudflare Tunnel の制約で SSE は数分で切れます。拡張は 15 秒後に自動再接続。popup の状態が「準備OK」⇄「接続中…」を行き来するのは普通の挙動です。在庫検知は popup 閉じてても動きます。

📥 拡張をインストール / 更新する

📥 最新版の拡張 zip をダウンロード v…
💡 完全自動更新ではありません: 厳密に言うと、Chrome 拡張は 「最新版あり」と通知が来る ところまでは自動。実際の入れ替えは 3 ステップの手作業 が必要です。 開発者 (Kosuke) が手元で改修するたびに、popup の上部に 緑枠の「🔄 更新あり」カードが出ます。v0.6.3 では、既定をaggressive全商品モードにし、stock_change の全variantを各1個ずつ投入試行する設定にしました。
📐 popup の構成 (v0.6.3 現在): 12 時前後 (11:55-12:15): popup が 脈動アニメに変わり、 0.5 秒ごとに自動更新。検知/投入カウントが 1 秒以下で追えます。

🔰 初回セットアップ (1 度だけ)

  1. 上の 📥 ダウンロード ボタンで extension.zip を保存
  2. Finder で zip を解凍 (例: ~/Downloads/extension/)。解凍したフォルダの場所は 変えないでください (更新時もここに上書きするため)
  3. Chrome を開いて URL 欄に chrome://extensions/ と入力
  4. 右上の 「デベロッパーモード」を ON
  5. 左上の 「パッケージ化されていない拡張機能を読み込む」 をクリック → 解凍したフォルダを選択
  6. 拡張カードの青いトグルが ON (有効) になっているか確認。灰色なら click して ON に。
    ※ 新しい権限 (alarms 等) が追加された時、Chrome は拡張を一時 disable することがあります
  7. 拡張アイコンをツールバーに必ずピン留め: ブラウザ右上の パズル🧩 アイコン → ドロップダウンの中に Mellojoy Sniper がある → 右の 📌 (Pin) ボタンを click
    ※ Chrome 仕様上「最初からピン留め」は強制できません。手動でピン留めしてください
  8. 拡張アイコンをクリック → popup を開く
  9. 3〜5 秒待つ → ステータスが 「接続中 (SSE)」 (緑色) になれば完了 ✅
    ※ v0.5.0 から認証撤廃済 → 何も入力不要で自動接続します
    ⚠ もし黄色の 「⚠ 診断」パネル が出たら、その文を Kosuke に共有してください (一発で原因特定できます)

🔄 更新する (popup に「更新あり」が出たとき)

  1. popup の 緑枠「🔄 更新あり」カードを確認 (現バージョンと最新バージョンが表示されます)
  2. このページに来て 📥 ダウンロード ボタンで 新しい zip を保存
  3. Finder で zip を解凍 → 初回と同じフォルダに上書き (~/Downloads/extension/ など)
  4. Chrome の chrome://extensions/ を開く
  5. Mellojoy Sniper のカードにある 🔁 更新アイコン をクリック
  6. popup を開いて バージョン表示が新しくなっていれば完了
💡 急がなくて大丈夫: 更新を放置しても旧版は引き続き動きます。緊急修正の時だけ Kosuke から連絡しますので、それ以外は気が向いた時に更新でOK。
⚠ v0.4.3 で「Service worker registration failed. Status code: 15」が出た方へ

v0.4.3 の background.js に SyntaxError が含まれていたため、Chrome が Service Worker を登録できずインストール時にエラーが出る不具合がありました。
v0.4.4 で修正済みです。下の 「🧹 壊れた拡張を削除して入れ直す手順」 を実行してください。

🧹 壊れた拡張を削除して入れ直す手順 (v0.4.3 を入れた方)

  1. chrome://extensions/ を開く
  2. 赤い「エラー」表示が出ている Mellojoy Sniper の拡張カードで 「削除」ボタンを押す → dialog で「削除」確定
    ※ 完全削除して OK。chrome.storage の設定も一緒に消えますが、再保存は数秒で可能
  3. 上の 📥 ダウンロード ボタンで最新 extension.zip (v0.4.4 以降) を保存
  4. 古い解凍フォルダに 上書き解凍 (もしくは古いフォルダを削除して新規解凍)
  5. chrome://extensions/ 右上の 「デベロッパーモード」が ON になっているか確認
  6. 左上の 「パッケージ化されていない拡張機能を読み込む」 → 解凍フォルダを選択
  7. 赤いエラーが出ずに拡張カードが追加されれば成功 ✅
  8. popup を開いて 「📋 既定値をフォームに入れる」 → 「設定保存」 → 3-5 秒で「接続中 (SSE)」緑色になれば完了

🚨 「未接続」が続く時の復旧手順 (最強の方法)

状況: 「保存完了」と出るのに、ステータスが 「未接続」 のまま緑色にならない。

これは古い壊れた設定が拡張内に残っているか、Chrome が拡張を disable にしている可能性が高いです。下の 5 ステップで強制復旧できます。
  1. 新版 zip (v0.4.3 以降) を 📥 ダウンロードボタンで再 DL → 同じフォルダに上書き解凍
  2. chrome://extensions/ を開く → Mellojoy Sniper の 🔁 更新アイコンを click
  3. 拡張カードの 青いトグルが ON になっているか確認 (灰色なら ON に)
  4. 拡張 popup を開く → 🗑 設定リセットボタンを押す
    → 古い壊れた config / bundle 設定が消える (統計はリセットされます)
  5. 3-5 秒待つ → 「接続中 (SSE)」になれば成功 ✅
    ※ v0.5.0 から認証なしで自動接続するため、何も入力不要
📊 popup の診断パネル: もし黄色枠で 「⚠ 診断: Failed to fetch」のような文字が出たら、それが原因の手がかりです。文章をそのまま Kosuke に共有してください。

エラー文の意味例:

🎯 バンドル限定モード (既定 ON)

✅ 既定で ON になっています: 拡張をインストールしただけで、popup の「🎯 バンドル登録商品のみカート (他商品は無視)」が 最初から ON です。何も操作しなくて OK。

これにより、12時の補充時に バンドルに登録した商品のみカート投入され、 その他の商品 (他のキャラクターやコレクション) は 通知だけ来てカートには入りません。 ちゃみさんの意図しない買い物が発生しない安全モードです。

現在の既定対象: 🍓 いちごショートケーキ Z048-8 × 1 + ✨ 贅沢スフレ Z072-5 × 1 + ☁️ ふわふわマシュマロ Z066-4 × 1 + 🍰 ムースクリーム 贅沢スフレ 中号M Z072-2 × 1 (合計 ¥9,097 / 4 個)
通常状態で、stock_change の全variantを各1個ずつ対象にします。
⚠ もし「全在庫を片っ端から買う」モードに切り替えたい場合: popup の「🎯 バンドル登録商品のみカート」のチェックを 外して「設定保存」を押す。 すると 12時に出てきた在庫復活商品が 全部自動カートに入ります (旧挙動)。
通常はこの操作は不要です。

🎯 12時の流れ

  1. 11:50 までに MellojoyJapan に ログイン状態にしておく (ログインページ)
  2. 11:55 ごろ拡張アイコンをクリック → popup を開く
  3. 「ステータス: 接続中 (SSE)」が緑色か確認
  4. 12:00 補充開始→ 拡張が自動で在庫検知 → 自動カート投入 (個別、単品)
  5. 本命4商品の入荷通知が出たら、必要に応じて popup の 「🎁 バンドルをカート投入」ボタンで各1個を手動投入
  6. カートタブが自動で開く
  7. 「カートに進む」→「Shop Pay で決済」を押す
  8. 決済完了画面が出れば終了

📦 現在の自動投入方針

v0.6.3 では、popup を開いて 準備OK なら、通常状態は stock_change が来た全variant が自動カート対象です。数量はいずれも 1個 です。available/type の表示は参考値に留め、Shopify cart/add.js の 200/422 で判定します。本命商品リストは手動投入・緊急絞り込み用の目安です。

いちごショートケーキ Z048-8
🍓 1. いちごショートケーキ Z048-8
variant
49695269683440
数量
1個
¥2,299 × 1個
商品ページ →
贅沢スフレ Z072-5
✨ 2. 贅沢スフレ Z072-5
variant
49695270273264
数量
1個
¥2,399 × 1個
商品ページ →
ふわふわマシュマロ Z066-4
☁️ 3. ふわふわマシュマロ Z066-4
正式名
Mellojoy ムースクリーム
メロジョイ ふわふわマシュマロ
variant
49031641366768
数量
1個
¥2,000 × 1個
商品ページ →
🍰
🍰 4. ムースクリーム 贅沢スフレ 中号M Z072-2
正式名
Mellojoy ムースクリーム
ミディアムサイズ(中号M) メロジョイ贅沢スフレ
variant
49846260728048
数量
1個
¥2,399 × 1個
商品ページ →
🍡 大福シリーズはデフォルト数量を1個にしていますが、variant ID が未確定のため、ID入力までは自動投入されません。

🧮 合計予算

商品単価数量小計
🍓 いちごショートケーキ Z048-8¥2,2991¥2,299
✨ 贅沢スフレ Z072-5¥2,3991¥2,399
☁️ ふわふわマシュマロ Z066-4¥2,0001¥2,000
🍰 ムースクリーム 贅沢スフレ 中号M Z072-2¥2,3991¥2,399
合計 (通常モード)—4個¥9,097
🌐 全商品モード: 通常状態で stock_change の全variantを各1個ずつ対象にします。もし緊急で絞った後は、popup の『🌐 全商品モードを再適用』で戻してください。

🆘 困ったとき (Q&A)

❌ 拡張インストール時に「Service worker registration failed. Status code: 15」が出る
v0.4.3 の不具合 (SyntaxError) です。v0.4.4 で修正済み。
上の 「🧹 壊れた拡張を削除して入れ直す手順」 を実行してください (古いを完全削除 → 新 zip で再 install)。
❌ 「未接続」が続く
上の 「🚨 復旧手順 (最強の方法)」セクションを実行してください (5 ステップで解決します)。
popup の 黄色「⚠ 診断」パネルに出る文字を Kosuke に共有してくれると一発で原因特定できます。
❌ 拡張が突然動かなくなった (権限警告など)
Chrome が新しい権限を検知して拡張を一時 disable した可能性。
chrome://extensions/ を開いて 青いトグルが ON になっているか確認。OFF (灰色) なら click して ON に。
❌ カートに入らない / 0 個成功
MellojoyJapan に未ログインの可能性。ログインページ で再ログインしてから再試行。
❌ 拡張が見当たらない / 削除してしまった
「🔰 初回セットアップ」をやり直してください。chrome://extensions/ で「デベロッパーモード」を ON にしてから、「パッケージ化されていない拡張機能を読み込む」で zip を解凍したフォルダを選択。
❌ popup が真っ白 / 動かない
chrome://extensions/ で Mellojoy Sniper の 🔁 更新アイコン を押してリロード。直らない場合は 「🗑 設定リセット」ボタンを押すか、Chrome を再起動。
🔄 「更新あり」通知が来た
popup の 「🔄 ダウンロードページを開く」を押す → 新 zip DL → 同じフォルダに上書き → chrome://extensions/ で 🔁 を押すだけ。

📞 連絡先

トラブルや質問は Kosuke (itochaso) まで。
拡張のロゴ → 統計カードに 「🛒 投入: N」 が増えていれば動作中です。
急ぐ時は LINE か Discord でお願いします。