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.claude/skills/social/publish-x/SKILL.md
GitHubPlaywright(永続プロファイル)で 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):
x-post-writerで下書き(文面ユニーク・URL 分散・同一 URL ≤2)- status.json に
scheduled_at→npm run x-schedule-guard(近似重複<0.62・同時刻衝突・1 日上限 3 本)を緑に--dry-runでセレクタ/認証を検証(下記)npm run x-schedule-guard --queue(実キュー二重チェック)緑 →--dry-runを外して本番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 で全部組んで一括投稿(addButtontrusted click。画像プレビュー後の透明オーバーレイ時だけ Playwrightforceclick →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 が存在すれば自動添付。存在しなければテキストのみ投稿。
前提条件
- システム Chrome がインストール済み(Playwright 組み込み Chromium は X にボット判定される)
- 初回ログイン:
npm run auth:login -- --service xで手動ログイン → セッションが<auth root>/profiles/playwright-x-profile/に保存されるnpm run auth:login -- --service x # ブラウザが開くのでアカウントにログイン → x.com/home に遷移すると自動終了 - セッション切れ時: 同様に
npm run auth:login -- --service xで再ログイン(publish-x.tsが Chrome チャンネルを使うので再ログイン後も bot 検知なし) - 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