1. はじめに（準備）
すべて必須です。
- ✅ ちいかわマーケットにログイン済み（ヘッダーに「こんにちはッ！○○さん」が出ていればOK）
- ✅ Shop Pay に住所とクレジットカードを登録済み（決済は Shop Pay で行われます。カード情報を拡張機能が扱うことはありません）
- ✅ 安い商品で1回テスト購入済み（強く推奨。自動入力が効くことを事前に確認できます）
- ✅ 拡張機能が
chrome://extensionsで有効になっている
インストール
- 配布 zip を解凍します（フォルダはこの後も移動・削除しないでください）
- Chrome で
chrome://extensionsを開き、右上の デベロッパーモード を ON - 「パッケージ化されていない拡張機能を読み込む」 → 解凍したフォルダを選択
- ツールバーのパズルアイコンから Chiikawa Auto Buy を ピン留め しておくと便利です
2. ライセンス認証
ライセンスはメールアドレス単位です。認証が終わるまで「監視」「自動購入」のトグルは押せません（画面の確認はできます）。
- 拡張アイコンをクリックしてポップアップを開く
- 「購入時のメールアドレス」を入力して 認証 を押す（設定画面のライセンス欄からも可）
- ヘッダー右上が ✔ ライセンス有効 になれば完了。トグルが押せるようになります
| 表示 | 意味・対処 |
|---|---|
| ✔ ライセンス有効 | 無期限、または期限日が表示されます |
| 🔒 未認証 | メールアドレスで認証してください |
| ⚠ 期限切れ | 1年ライセンスの期限が過ぎています。更新後に再認証してください |
| ⚠ 要再確認 | 7日以上サーバーに接続できていません。オンラインの状態で設定画面の「再確認」または再認証を |
有効性は6時間ごとに自動で再確認します。オフラインでも最後の確認から7日間は動作します。
3. ターゲットの登録
ポップアップの ⚙️ または「編集」から設定画面を開き、狙う商品を登録して 保存 します。複数登録できます。
| 項目 | 判定 |
|---|---|
| 商品名 | 類似度 80%以上（最も似た1件だけを選ぶのでシリーズ違いは掴みません）。公式の商品名をコピーするのが確実 |
| 価格 | 完全一致（円・税込） |
| バリアント | 色・サイズ・単品/BOX などを部分一致。空欄＝どれでも。カンマ区切りで複数候補（例：オフホワイト,ホワイト） |
| 数量 | 1〜99。購入制限に抵触したら自動で減量し、買える最大数で投入 |
| 有効 | OFF の行は監視対象から外れます（削除せず一時的に外したいときに） |
まとめ買い：在庫のあるターゲットが同時に見つかれば 1カート・1決済 にまとめます（同じ商品の色違い・サイズ違いを別行にした場合も同様）。ターゲットに優先順位はなく、同時に見つかったものは全て購入します。発売時間がずれた場合は自動で個別決済になります。
重複登録の防止：商品名・価格・バリアントが完全に同一の行を誤って複数登録した場合は、数量が多い方を1回だけ購入します。
重複登録の防止：商品名・価格・バリアントが完全に同一の行を誤って複数登録した場合は、数量が多い方を1回だけ購入します。
初めての方は、設定画面の テストプリセット（自動購入 OFF・在庫ありの安い商品）で一連の流れを確認することをおすすめします。
4. 発売当日の使い方
- ポップアップでターゲット（商品名・バリアント・価格・数量）を確認
- 「監視」を ON。商品検出 → カート投入 → チェックアウトまで自動で進みます
- 「自動購入」：ON＝「今すぐ支払う」まで自動。OFF＝支払い直前で赤枠表示して停止（手動で押す）
- 「店舗タブを開く」 を押して、ちいかわマーケットのタブを1枚開いておく。右下に
CAB 監視中 #Nバッジが出れば約0.8秒ごとに監視しています - あとは待つだけ。購入が完了するとデスクトップ通知が届き、ポップアップが「購入完了」になります
店舗タブは前面（別ウィンドウ可）に出しておいてください。 Chrome は非表示タブのタイマーを1秒に1回（5分経過後は1分に1回）に制限するため、裏に回すと監視間隔が大幅に伸びます。遅延を検知するとイベントログに警告が出ます。
タブを開けない時間帯は、バックグラウンドで30秒ごとに監視し、商品が出たら自動でタブを開いて高速モードに切り替えます。
5. ポップアップの見方
| 表示 | 意味 |
|---|---|
| ⏸ 停止中 | 監視 OFF・未購入 |
| 🔍 監視中… | ポーリング稼働中。残りターゲット数を表示 |
| 🛒 カート投入中… / 💳 決済処理中… | ターゲット発見 → 購入処理が進行中 |
| ✅ 購入完了 | 商品名・バリアント・数量・時刻を表示（制限で減量された場合は実際の数量）。監視は停止します |
| ⚠️ エラー | 「状態をリセット」で監視に戻せます |
| ターゲット | ⏳ 未購入 / ✅ 購入済 / ⚠️ エラー / ⛔ 無効 |
| チェック履歴 | ポーリング結果（直近30件・ミリ秒時刻・所要ms）。流れ続けていれば監視は生きています |
| イベントログ | 発見・購入・数量調整・エラーなどの節目の記録（200件保持） |
| 📋 ログをコピー | 設定・状態・チェック履歴・イベントログをまとめてクリップボードへ（不具合報告用） |
| 🔄 状態をリセット | 全ターゲットを未購入に戻し、購入済み状態から次の監視を始めます |
6. 安全設計（誤購入・多重購入の防止）
- 1回しか買わない：購入済ターゲットは二度と買いません。全ターゲット購入済で監視停止。リセットしない限り再購入は走りません
- 複数タブでも1枚だけ監視（リーダー選出）＋購入直前ロックで二重購入を防止
- 条件不一致は絶対に買わない：名前80%未満・価格違い・バリアント違い・在庫なしはスキップ
- カートは空にしてから投入：残留商品の誤決済を防止。投入後は実際のカート内容を検証し、減量・除外された場合は実数量で記録
- ターゲット未設定なら何もしない：監視 ON でも登録がなければ購入は走りません
- カート投入だけ失敗した場合は監視に自動復帰（購入成功時だけ停止）
7. Shop Pay の本人確認
- チェックアウト中に「本人であることを確認」モーダルが出ることがあります（新しいブラウザ・リスク判定時など）
- OK・続行・コード送信などのボタンは 拡張が自動で押します
- SMS/メールに届く 確認コードの入力だけは手動 です。入力後の最終支払いボタンは自動で押します
- 同じブラウザで一度認証を済ませておくと、次回以降スキップされることがあります（Shop Pay の仕様）
8. トラブルシューティング
| 症状 | 対処 |
|---|---|
| トグルが押せない | ライセンス未認証です。ポップアップでメールアドレスを認証してください |
| バッジが出ない | 店舗タブを F5。別タブがリーダーの場合バッジは1枚だけ（正常）。灰色「ターゲット未設定」なら設定画面で商品を登録 |
| チェック履歴が止まる・間隔が伸びる | 店舗タブを前面（別ウィンドウ可）に出す。Chrome の非表示タブ制限が原因です |
| バッジがオレンジ「減速中」 | レート制限を検知し自動減速中（最大10秒間隔）。解除されれば自動復帰 |
| バッジが赤「Cloudflare チャレンジ」 | 発売の瞬間だけ人間確認が出ることがあります。自動で店舗タブを再読み込みするので、チェックボックス等が表示されたら手動で通過してください。通過後は自動再開。自動再読み込みは3回まで、それでも続く場合は F5 |
| バッジがオレンジ「応答待ちタイムアウト」 | 混雑で応答が8秒以上返らない状態。監視は継続します（1チェック最大20秒で打ち切り） |
| 支払いボタンが押されない | Shop Pay が信頼クリックを要求。赤枠のボタンを手動で1回押せば完了 |
| 次の商品を監視したい | 設定で商品を変更 → ポップアップで「状態をリセット」 |
| 「要再確認」と出る | オンラインで設定画面の「再確認」。改善しなければ再認証 |
9. 監視設定の知見
「新着」は複数コレクションに分散し、商品は時間経過でコレクション間を移動します（2026年9月時点の実測）。
| コレクション | 内容 |
|---|---|
newitems | ショップ全体の新着 |
chiikawamovie-newitems / chiikawamovie | 映画ちいかわ 新着 / 傘コレクション（既定の監視対象） |
chiikawapark-newitems | ちいかわパーク 新着 |
chiikawamovie-2026MMDD など | 日付別の発売・予約・再入荷 |
- コレクション移動による取りこぼし対策として、ショップ検索でも探します（全店舗から名前検索 → 価格・在庫を本確認。設定で OFF 可）
- コレクション URL は カンマ区切りで複数指定 可。監視本数を増やすとリクエストも増えます（既定2本＝実測の安全圏）
- ポーリング間隔：既定0.8秒はレート制限に掛からないことを実測済み。恒常運用は2〜3秒、発売直前だけ0.5〜0.8秒に短くする運用が安全です
検出フロー（1チェックあたり）
- ショップ検索：全ターゲット名で検索し、8割以上似た候補を抽出（同名ターゲットは1リクエストに集約）
- 本確認：候補の正式データで価格・バリアント・在庫を検証
- コレクション走査：監視コレクションの全商品も同条件で走査
- 最終選定：ターゲットごとに最も類似度の高い1件だけを選定
- 全条件を満たしたらカート投入 → チェックアウトへ
10. 不具合報告
- ポップアップの 📋 ログをコピー を押す（設定・状態・チェック履歴・イベントログがコピーされます）
- 不具合報告フォーム を開き、件名・状況と一緒にログを貼り付けて送信
ログにはカード情報・パスワードは含まれません（設定値・商品名・ライセンスのメールアドレス・時刻のみ）。
11. アップデート
ストア外の拡張機能は Chrome が自動更新しないため、代わりに拡張が新バージョンを検知してお知らせします。
- 6時間ごとに配布サーバーを確認し、新版があると アイコンに赤い「!」バッジ、デスクトップ通知、ポップアップ上部の案内が出ます
- 設定やライセンス、購入済みの記録は更新しても引き継がれます
更新手順（約1分）
- ポップアップの案内にある ⬇ ダウンロード で新しい zip を取得
- zip を解凍し、中の
chiikawa-auto-buyフォルダの中身を、今使っているフォルダに上書きコピー（フォルダの場所は変えないでください） - 拡張アイコンをクリックしてポップアップを開くと、拡張が自動で再読み込みされ、バージョン表示が新しくなります（開いた瞬間に一度閉じることがあります。もう一度開けばOK）
別の場所に解凍して読み込み直すと、拡張の ID が変わって設定とライセンス認証がリセットされます。必ず 同じフォルダに上書き してください。