publish-x

Playwright で X (Twitter) の投稿を自動実行する。content/sns/x/draft/ 配下の tweets.md を読み取り、 ## Tweet XX ブロックを1件ずつ投稿(即時 or 予約)。 Use when user says "X投稿", "X予約投稿", "ツイート投稿". **初回実行時 or セレクタ更新後は必ず --dry-run で事前検証すること*

SKILL.md

GitHub

Playwright(永続プロファイル)で X のコンポーザを自動操作し、即時投稿または予約投稿する。

既存予約・公開済み投稿を改修するとき

SNS 投稿画像ポリシー §0.1 を先に読む。新規投稿フローを既存投稿の編集代わりに再実行しない。投稿 ID・予約の実体・変更可能項目を確認し、対応する編集処理がない場合はその不足を明示する。保存後の実表示と予約日時・公開状態の再照合までを外部更新の完了条件とする。

⚠️ 予約運用は再開(ガード必須・2026-07-07〜)

アカウントSSOT: config/x-account.json。旧アカウント @dobokunotecom が「platform manipulation and spam」で凍結(異議却下)。実因は同一/類似文面の連続予約というスケジューリング失敗。運用は新アカウント @doboku373 で継続中(disable-model-invocation: true は維持=Skill 自動起動はせず、人/明示コマンドで実行する)。

現行フロー(2026-07-07 再開): 予約は再開したが、凍結実因(連続・重複)を機械的に潰すため 必ず以下のガード付きフローを通す(真実源 x-post-policy.md §11.5):

  1. x-post-writer で下書き(文面ユニーク・URL 分散・同一 URL ≤2)
  2. status.json に scheduled_at → npm run x-schedule-guard(近似重複<0.62・同時刻衝突・1 日上限 3 本)を緑に
  3. --dry-run でセレクタ/認証を検証(下記)
  4. npm run x-schedule-guard --queue(実キュー二重チェック)緑 → --dry-run を外して本番
  5. npm run x-sync-status で queued 実在を確認=偽成功検証(§9)

ガードが赤なら予約しない(280超・404 と同格のブロッキング)。一括で数十本を積まず 1 週間分ずつ(§11.2/§11.5)。自動フォロー/いいね/リプライは使わない(§11.3)。

予約後の定期確認(ローカル)

X予約の継続確認では npm run check-x-queue-health を実行する。X実予約の欠落、翌日から7日間の空白、予約終了まで7日以内、Article公開遅延・告知未予約を検出する。exit 0=実査PASS、1=対応必要、2=検査不成立。結果は .tmp/x-queue-health/latest.json。予約・台帳への書き込みは行わない。認証が必要なためCIでは実行せず、設定済みのCodex監視が毎日09:30・21:30 JSTに呼ぶ。異常時の対応と通知条件は .claude/knowledge/reference/x-post-policy.md の「実予約の定期監視」を参照する。

⚠️ 重要: 初回 / セレクタ更新後は --dry-run で事前検証

X の UI は頻繁に変わる。予約モード未確認のまま投稿ボタンを押すと即時投稿が発火する(2026-04-18 実際に発生)。

npx tsx .claude/skills/social/publish-x/publish-x.ts 004 --tweet 1 2026-05-09T08:00 --dry-run
  • 成功: .local/playwright-x-debug/ に dry-run-scheduled-mode.png が保存される
  • 失敗: schedule-mode-not-confirmed.png を確認してセレクタ修正
  • dry-run 成功後に --dry-run を外して本番実行

[!warning] dry-run のログで「予約モード」か「即時投稿モード」かを必ず読む(2026-08-12 追加) --dry-run が緑(19/19 件完了)でも、それは即時投稿モードのまま完走した緑でありうる。 見るべきは件数ではなく次の 1 行:

  • 📅 予約モード確認OK / dry-run: 予約モードまで到達 → 正
  • 即時投稿 / dry-run: 即時投稿モード、投稿はスキップ → 異常。--dry-run を外すと全件がその場で連投される

zsh の罠: 日時をシェル変数でまとめて渡すとき、zsh は展開時に単語分割をしないため ... 083 $DATES は日時 19 個が引数 1 個になり、スクリプトは「日時指定なし=即時投稿」と解釈する。 引数の数が合わないだけなのでエラーにならず、静かに即時モードへ落ちる。

npx tsx ... 083 ${=DATES}   # zsh は ${=VAR} で明示分割。$DATES のままだと即時投稿になる

2026-08-12 に 19 本の一括予約で実際に踏み、dry-run のこの 1 行だけが 19 連投を止めた。

🧵 スレッド([thread] マーカー・2026-07-14 追加)

X ネイティブ予約はスレッド非対応(実機プローブ 2026-07-14: composer に tweetTextarea_1 を追加すると scheduleOption が aria-disabled=true)。本スクリプトは次の分業で対応する(真実源 x-post-policy.md §5.2.1):

  • 書式: ## Tweet NN: タイトル [thread]、本文内を --- リプライ --- 行で区切る(1部目=ヘッド、以降=リプライ)。各部が独立に 280 weighted 判定される(check-x-length が part 別検査)。マーカーなしブロックの --- リプライ --- 以降は従来どおり投稿対象外(レガシー注記互換)。
  • 即時投稿(--immediate): composer で全部組んで一括投稿(addButton trusted click。画像プレビュー後の透明オーバーレイ時だけ Playwright force click → tweetTextarea_1..N 入力・各部の空読み戻し検証つき)。現行 UI で追加 textarea が生成されない場合は、--head-only でヘッドだけ即時投稿→node scripts/x-thread-replies.mjs --runで自己リプライをチェーンする。
  • 予約投稿: ヘッドのみネイティブ予約し、リプライ本文を status.json の thread: {parts, replies_posted_at: null} に記録。予約時刻経過後に node scripts/x-thread-replies.mjs --run --draft <NNN> で対象を限定し、ライブのヘッドを特定してリプライをチェーン投稿する(--list=pending 確認 / --dry-run=ヘッド特定まで)。cron 常駐はしない(§11.3 自動化フットプリント最小化)。

⚠️ 重要: 「予約投稿完了」ログを信用せず予約キューを実体検証(2026-05-29)

✅ 予約投稿完了 ログは投稿成功の証拠にならない。実際に X 予約キュー(https://x.com/compose/post/unsent/scheduled)を開き、仮想スクロールで全セルをロードして本文・送信時刻の実在を確認するまで「完了」と報告しない。プロフィール(x.com/<handle>)のポスト数で即時投稿の誤爆も併せて確認する。検証パターンは [[feedback_publish_x_false_success]] / .tmp/verify-final.mjs(cellInnerDiv 末尾 scrollIntoView で全件ロード→regex マッチ+時刻ヒストグラム)。

2026-05-29 事故: 9 件を予約したつもりが 0 件しか入っていなかった。原因は予約確定の tweetButton.click() が React onClick を発火できず compose が閉じない(=保存されない)のに、その手前の 予約モード確認OK だけで success を返していたこと。下記の通り Ctrl+Enter 確定+compose 閉鎖検証に修正済み。

⚠️ 重要: 凍結回避(投稿頻度・間隔・自動化フットプリント)

2026-06-12 凍結事故: 運用 X アカウントが「platform manipulation and spam」で凍結された。Playwright 自動投稿は本質的に bot 的で、一括予約・同時刻・連投・重複文面・同一リンク反復は spam/自動化として検知されやすい。真実源は x-post-policy.md §11。本スキルは予約補助であり、全量を機械投稿に寄せない。

予約・投稿の前に必ず守る(policy §11):

  • 1 日 3〜5 本まで。新規・低フォロワー期は 2〜3 本に絞る。
  • 同時刻一括予約を避ける。日時引数は毎日同じ 08:00 で並べず、±30〜90 分ジッタを入れて分散する(例: 08:10 / 12:40 / 19:20 …)。
  • 一度に数十本積まない。1 回の予約は数本に留め、予約キューが機械的な等間隔列に見えないようにする。
  • バースト連投をしない(最低 60〜90 分間隔)。
  • 自動フォロー / 自動いいね / 自動リプライ系は使わない(規約直撃)。リプライは人が手動で(policy §10)。
  • ドラフトが near-duplicate テンプレ/同一 URL 反復になっていないか、投稿前に x-post-qa の凍結リスク・ゲート(§11)を通す。
  • 凍結・ロック時は SMS 認証など正規手順で解除し、回避目的の新規アカウント量産(ban evasion)はしない。

🛡 予約前ゲート / 予約後の実査(必須・機械検査)

x-post-qa(人/エージェント採点)に加え、予約実行の直前後に機械ゲートを必ず通す(真実源 x-post-policy.md §11.5):

# ① 予約前: 同時刻衝突・near-dup・1日上限・古い予約残存を機械 BLOCK。緑でなければ予約しない
npm run x-schedule-guard -- --queue --max-per-day 2
# ② publish-x で予約(このスキル。--tweets N-M で対象を絞る=誤って全件投稿しない)
# ③ 予約後: キュー実在を実査し scheduled→queued へ昇格(偽成功検証 §9。投稿数=queued昇格数を突合)
npm run x-sync-status
  • 状態ライフサイクル: scheduled(計画・未投入)→ queued(キュー投入済・x-sync-status が実査昇格)→ posted(送信済)。guard の --queue 二重チェックは queued を除外するので、週次小分けで次バッチを積むときも誤検出で赤にならない。
  • 週次運用: 1 週間分(2 本/日)ずつ。次バッチは未投入の scheduled のみを --tweets で対象化する。

使い方

# 1. 利用可能な draft を確認
ls content/sns/x/draft/

# 2. dry-run(初回必須)
npx tsx .claude/skills/social/publish-x/publish-x.ts 004 --tweet 1 2026-05-09T08:00 --dry-run

# 3a. 即時投稿(特定ツイート)
npx tsx .claude/skills/social/publish-x/publish-x.ts 004 --tweet 1 --immediate

# 3b. 予約投稿(全ツイート、日時をツイート数分並べる)
npx tsx .claude/skills/social/publish-x/publish-x.ts 004 \
  2026-05-09T08:00 \
  2026-05-10T08:00 \
  2026-05-11T08:00 \
  2026-05-12T08:00 \
  2026-05-13T08:00

引数

パラメータ 必須 説明
<draft> ✓ content/sns/x/draft/ 配下のディレクトリ名。先頭番号のみ(004)でも可
[<date>...] - 予約日時 JST (YYYY-MM-DDTHH:MM)。ツイート数と一致させる
--tweet N - 特定ツイートのみ投稿(1-based、省略時は全ツイート)
--immediate - 予約ではなく即時投稿(--tweet と組み合わせ推奨)
--head-only - [thread] のヘッドだけ即時投稿し、リプライを pending として status.json へ残す。続けて x-thread-replies --run を実行
--dry-run - 実投稿せず予約モード到達まで確認

tweets.md の形式

## Tweet 01: タイトル

投稿テキスト本文

#技術士 #技術士総監 #<種別タグ>

---

## Tweet 02: タイトル
...

## Tweet NN: を区切りとして各ブロックを1投稿として扱う。

投稿テンプレ・ハッシュタグ運用ルール

本文構成・ハッシュタグ個数・推奨タグセットの真実源は content/sns/x/README.md。

要点だけ抜粋:

  • 文字数上限は既定 280 weighted chars(日本語 = 2、URL = 23 固定)。X Premium 加入済のため [longform] マーカー付きツイートは 25,000 まで可(短文がデフォルト=リーチ最適・詳細は x-post-policy §2/§2.1)
  • ハッシュタグは 3-4 個(ベース 2 個 #技術士 #技術士総監 + 種別 1-2 個)
  • #総合技術監理部門 は 17 weight と重く要点投稿限定
  • 投稿前に node .tmp/count-x-chars.mjs <tweets.md> で文字数検証必須

画像

img/tweet-{NN}-{slug}.png が存在すれば自動添付。存在しなければテキストのみ投稿。

前提条件

  1. システム Chrome がインストール済み(Playwright 組み込み Chromium は X にボット判定される)
  2. 初回ログイン: npm run auth:login -- --service x で手動ログイン → セッションが <auth root>/profiles/playwright-x-profile/ に保存される
    npm run auth:login -- --service x
    # ブラウザが開くのでアカウントにログイン → x.com/home に遷移すると自動終了
    
  3. セッション切れ時: 同様に npm run auth:login -- --service x で再ログイン(publish-x.ts が Chrome チャンネルを使うので再ログイン後も bot 検知なし)
  4. SingletonLock エラー時: 前回の Playwright が残っている場合は以下でクリア
    pkill -f "playwright-x-profile" 2>/dev/null; rm -f <auth root>/profiles/playwright-x-profile/SingletonLock
    

実証済みセレクタ(2026-04-20 stats47 で検証)

操作 セレクタ
テキスト入力 page.getByRole("textbox").first()
画像アップロード input[data-testid="fileInput"]。初期 DOM に input が無い現行 UI は、button[aria-label="画像や動画を追加"](英語は Add photos or video)押下時の filechooser を待ち受けて設定
予約ボタン [role="dialog"] [data-testid="scheduleOption"](DOM .click() 必須)
日時 select [role="dialog"] select × 5(options 内容からロール自動判定)
確認ボタン [data-testid="scheduledConfirmationPrimaryAction"]
予約モード検証 [data-testid="tweetButton"]:has-text("予約設定")
予約確定 textbox focus → ControlOrMeta+Enter(tweetButton.click() は onClick 不発で保存されない)。確定後 compose クローズをループ検証し、閉じなければ中止=偽成功を出さない(2026-05-29 修正)
本文入力検証 paste 後 textbox.innerText() を読み戻し、空なら keyboard.insertText フォールバック → なお空なら中止(clipboard 不発の偽成功防止、2026-05-29 追加)

セレクタが壊れた場合は SKILL.md の表を更新すること。

スクリプト本体

.claude/skills/social/publish-x/publish-x.ts