1-1. システム概要

1-2. 毎日の使い方

削除ツール（売れた商品を削除する）

再出品ツール（期限切れ商品を再出品する）

終了の仕方

ランチャーウィンドウ右上の × で閉じるだけでOKです。実行中に閉じたい場合は先に「⏹ 中断」ボタンを押してください。

1-3. ランチャー画面の説明

ログの色の意味

1-4. アカウント一覧

1-5. よくあるトラブルと対処法

2-1. システムアーキテクチャ

全体構成図

┌─────────────────────────────────────────────┐
│         スーパーマシン（Google Sheets）         │
│  B列: 管理番号 / F列: アカウント / M列: フラグ  │
└──────────────────┬──────────────────────────┘
                   │ Google Sheets API
┌──────────────────▼──────────────────────────┐
│              delete_tool.py                  │
│  Phase1: F=H/M → オークタウン(A/T/V)削除      │
│  Phase2: F=A/T/V → メルカリ(H/M)削除         │
│  W=WANG → スキップ                           │
└──────┬──────────────────────┬───────────────┘
       │                      │
       │ Playwright            │ Playwright
  ┌────▼──────┐          ┌────▼──────────┐
  │ オークタウン │          │   メルカリ     │
  │  A/T/V   │          │    H/M/P     │
  │ Firefox  │          │   Firefox    │
  └──────────┘          └──────────────┘

┌─────────────────────────────────────────────┐
│              relist_tool.py                  │
│  settings.csv の条件 → /myCloseList/ 再出品   │
│  アカウント A / T / V を順に処理               │
└──────┬──────────────────────────────────────┘
       │ Playwright
  ┌────▼──────┐
  │ オークタウン │
  │  A/T/V   │
  │ Firefox  │
  └──────────┘

     ロック: C:\tool-lock\browser.lock（排他制御）
     通知:   Chatwork API（ルーム427400103）

ファイル一覧と役割

2-2. スプレッドシート仕様

M列フラグ値

2-3. delete_tool.py 仕様

起動オプション

Phase1 フロー（メルカリ売れ → オークタウン削除）

Phase2 フロー（ヤフオク売れ → メルカリ削除）

メルカリ削除の3ステップ

スキップ対象アカウント

• W（WANG）：ヤフオク未出品のためスキップ（ℹ️ Wアカウント（WANG）はスキップとログ出力）
• P（pua_boutique）：メルカリのみ・ヤフオク紐づけなし。Phase2では検索対象になるがProfluの存在によりスキップされる場合あり

管理番号マッチング（完全一致）

# MD34 が MD348 にマッチしないよう前後に英数字境界チェック
pattern = re.compile(r'(?<![A-Za-z0-9])' + re.escape(mgmt_num) + r'(?![A-Za-z0-9])')

ランダム遅延

BAN対策として各操作の間に random.uniform(2, 10) 秒のランダム待機を挿入しています。

2-4. relist_tool.py 仕様

起動オプション

再出品フロー

settings.csv の列

日時設定のJS強制セット

オークタウンの終了日時セレクトボックスはhiddenのため、page.evaluate() でJSを経由してvalueをセットし、dispatchEvent(new Event('change')) で変更を反映させています。

表示件数設定

select[name="pageSize"] で300件表示に設定してから処理（再出品ツール）、または250件表示に設定してから処理（削除ツール）。

2-5. launcher.py 仕様

タブ構成

中断処理

def stop_tool(self):
    if self.process and self.process.poll() is None:
        self.process.kill()    # プロセス強制終了
        self.process.wait()    # 完全終了を待つ
    release_lock()             # ロックファイル削除
    # → これで再実行可能になる

ロック強制解除ボタン（上部バー）

LOCK_FILE = r'C:\tool-lock\browser.lock'

def release_lock():
    if os.path.exists(LOCK_FILE):
        os.remove(LOCK_FILE)

2-6. ロックファイル制御

排他制御の仕組み

削除ツールと再出品ツールが同時に動くと同一Firefoxプロファイルを取り合ってクラッシュする問題を防ぐため、実行開始時にロックファイルを作成し、終了時に削除します。

# ロック取得（O_CREAT | O_EXCL = アトミックな排他作成）
fd = os.open(LOCK_FILE, os.O_CREAT | os.O_EXCL | os.O_WRONLY)
os.write(fd, str(os.getpid()).encode())  # PIDを書き込み
os.close(fd)

ロックが既に存在する場合は FileExistsError が発生し、10秒ごとに再試行（最大30分待機）します。

詰まり時の手動対処

1. ランチャーの「🔓 ロック強制解除」ボタンを押す
2. ランチャーが開いていない場合：エクスプローラーで C:\tool-lock\ を開き browser.lock を削除
3. Pythonで削除する場合：import os; os.remove(r'C:\tool-lock\browser.lock')

2-7. Chatwork 通知仕様

通知タイミングと内容

2-8. Windows 環境

フォルダ構成

C:\
├── mercari-delete-tool\
│   ├── delete_tool.py
│   ├── launcher.py
│   ├── login_tool.py
│   ├── token.json
│   ├── profiles\
│   │   ├── auctown_A\    ← Firefoxプロファイル（ログイン維持）
│   │   ├── auctown_T\
│   │   ├── auctown_V\
│   │   ├── mercari_H\
│   │   ├── mercari_M\
│   │   └── mercari_P\
│   ├── screenshots\
│   └── logs\
├── auctown-relist-tool\
│   ├── relist_tool.py
│   ├── settings.csv
│   └── logs\
└── tool-lock\
    └── browser.lock      ← 実行中のみ存在

ランチャー起動ショートカット

デスクトップの ランチャー.bat をダブルクリックで起動。
内容は python C:\mercari-delete-tool\launcher.py を呼び出すバッチファイル。

Task Scheduler（タスクスケジューラ）

現在は手動実行。将来的にタスクスケジューラで自動化予定。設定時は以下を参考に：

タスク名: SUSH_DeleteTool
実行: python C:\mercari-delete-tool\delete_tool.py --bulk
実行間隔: 毎日（希望する時間に設定）
実行ユーザー: Windows管理者アカウント

SSH 接続情報

Mac から Windows をリモート操作する場合は既存のリモートデスクトップ設定を使用。
SSH / ファイル転送が必要な場合は小口さんに確認してください。

2-9. 設計上の判断と経緯

2-10. 残課題・今後の実装予定