1. なぜ素朴な Playwright リトライは「二重投稿」と「アカウントロック」を起こすのか
X(Twitter)や note のような本番Webサイトを Playwright で自動運用するとき、最も危険な実装が **try ... except TimeoutError: retry()** のような素朴な自動リトライです。
API とは異なり、ブラウザ自動化には次の 2種類の非対称な失敗 が存在します。
- **送信クリック「前」の失敗(
LOGIN_REQUIRED/ 入力欄セレクタタイムアウト / Anti-Bot チャレンジ遷移)**
まだサーバーへ公開リクエストは飛んでいません。ただし /account/access や認証チャレンジ画面でヘッドレスリトライを繰り返すと、プラットフォーム側からボット攻撃とみなされ アカウント凍結やチャレンジ頻発 を招きます。
- 送信クリック「後」の失敗(確認ページ遷移タイムアウト / ブラウザクラッシュ / 回線瞬断)
この時点でサーバー側では すでに記事やポストの公開が完了している可能性が高い のに、手元に URL(レシート)だけが返ってきません。ここで例外を「失敗」とみなして最初からやり直すと、同じ記事・同じポストが二重・三重に本番公開される事故が確定します。
結論(無料パートで設計の核心を100%開示)
ブラウザ自動投稿を安全に無人化する唯一の方法は、公開処理を単なる成功/失敗ではなく **4状態(not_listed/in_progress/completed/unverified)の「At-Most-Once 状態機械」 として設計し、fsync+os.replaceによる原子ファイル置換 と Anti-Bot 境界での即時 Fail-Closed 停止** を組み込むことです。
2. 無料公開:4状態 At-Most-Once 状態遷移表と Go / No-Go 採否基準
実運用でそのまま設計指針として使える状態遷移契約を公開します。この表の規則を守るだけで、リトライによる二重送信とチャレンジ無限ループの両方を構造的に遮断できます。
現在状態(intent.json / confirmed.json) | 発生イベント | 遷移後状態 | 次回バッチ実行時の振る舞い |
|---|---|---|---|
| (ファイル未存在) | バッチ実行開始+SHA-256検査&品質ゲート通過 | in_progress | (ブラウザ起動へ進む) |
in_progress | 送信「前」の定型エラー(要素未検出等)+未クリック | not_listed | 安全に自動再試行を許可 |
in_progress | /account/access・CAPTCHA・LOGIN_REQUIRED 検知 | not_listed+即停止 | 手動認証まで無人実行を停止(人間ゲート突破を試みない) |
in_progress | 公開成功&公開URL確認完了 | completed(.confirmed.json確定) | 以後はキャッシュ済みレシートを即返却(再実行ゼロ) |
in_progress | 送信「後」タイムアウト・ランナークラッシュ・例外終了 | **unverified(自動ロック)** | **DuplicatePostRiskError で即停止し人間・監査がライブ一覧を確認するまで再実行を物理遮断** |
採用すべき現場・見送るべき現場(Go / No-Go 判断基準)
- 採用すべき条件(Go):
systemd・cron・ジョブキューから Playwright / Puppeteer / Chrome DevTools 経由で 外部Webサービスの書き込み操作(記事公開・SNS投稿・フォーム確定・決済画面操作)を1日1回以上自動実行している場合。1度の二重投稿やアカウントロック復旧にかかる手戻りを考えれば必須の安全装置です。 - 見送るべき条件(No-Go): 読み取り専用のスクレイピングのみを行っている場合、またはサーバー側が公式に
Idempotency-KeyHTTPヘッダーをサポートする純粋な REST API のみを叩いている場合は、本設計を導入する必要はありません(無料パートの上記状態表の知識のみで十分です)。