Xに投稿する
x.com の実際のブラウザを操作して、X/Twitterにツイートまたはスレッドを公開します。 APIは使いません。Xは2026年2月に無料APIを廃止しました (従量課金: 1投稿あたり$0.015、リンク付きは$0.20)。 そのため、一度だけ手動でログインしたブラウザセッションを再利用し、サイト自体を通じて投稿します。 実際のChromeバイナリを使用し、自動化フラグを除去してXの「ブラウザが信頼されない」チェックを回避します。
1回ログイン (手動) → テキスト/スレッドを解析 → ヘッドモードでドライラン作成 → [ユーザーOK] → 実際に投稿
利用規約 + リスク。 自動投稿はXの利用規約に違反し、アカウントがフラグされる可能性があります。 これは低頻度で人間らしいペースの自己投稿 — リリーススレッド、ビルド公開の更新 — を目的としており、大量ボットではありません。 必ず最初にドライランを実行し、人間的な遅延を保ち、明確な許可なくユーザーに代わって投稿しないでください。
0. 初期設定
スクリプトには Playwright と Google Chrome のインストールが必要です (Chromeは信頼されたバイナリです。Playwrightはドライバーのみを提供し、ブラウザはダウンロードしません)。
cd <スキルディレクトリ> && npm install # スキル内にplaywrightをインストール
次に、一度だけ認証します — 実際のChromeが開き、ユーザーが手動でログインします (パスワード + 2FA)。
セッションは ~/.config/post-to-x/x-profile に保存されます。
node scripts/post-x.mjs login
channel: "chrome" でエラーが出た場合、Chromeが見つかっていません — Google Chromeをインストールしてください (Chromiumだけではありません)。
ログインウィンドウは、ログイン状態になるまで最大5分間待機します。
1. コンテンツの準備
インラインテキストまたはファイルのどちらかを受け付けます。
- 単一ツイート —
--text "…" - スレッドファイル —
--file <パス>。ツイートの境界は自動検出されます。- ツイートごとの
**N/M**マーカー (build-in-public のx-thread.mdスタイル)、または ---のみの行で区切られたツイート、または- 区切りなし → ファイル全体が1つのツイートになります。
- ツイートごとの
- 画像 — ツイートごとに、そのツイート内に
_image: パス_またはの行を追加します。 または、繰り返し使用可能な--image <パス>で最初のツイートに添付します。 Xはツイートごとに最大4枚まで受け付けます。パスはファイルからの相対パスです。 - 自動的に削除されるもの:
> …引用ブロック (DRAFTバナー)、# …見出し、_(…文字…)_メモ。
各ツイートは280文字以下にしてください — スクリプトが文字数を表示し、超過したものを通知します。
2. ドライラン (必須のゲート)
まず、送信せずに可視状態で作成し、ユーザーがXの作成画面で実際のスレッドを確認できるようにします。
node scripts/post-x.mjs post --file thread.md --headed --dry-run
すべてのツイートを作成モーダルに入力し (「+」ボタンでスレッド投稿を追加)、画像を添付し、30秒間保持してから閉じます — 何も投稿されません。 ユーザーに見せ、明示的な承認を得てください。
3. 実際に投稿する
ユーザーが承認した後でのみ、--dry-run を外します。
node scripts/post-x.mjs post --file thread.md # または --text "…"
node scripts/post-x.mjs post --file thread.md --image shot.png --headed
--headed はブラウザを表示します。デフォルトはヘッドレスです。
スクリプトはXの「すべて投稿」(スレッド) / 「投稿」(単一) ボタンをクリックし、作成画面が閉じたことを確認します。
4. 検証
- 解析ゲート —
--parse-onlyは解析されたツイート、文字数、画像パスを表示して終了します。 ファイル形式が不明瞭な場合に実行してください。 - ドライランゲート — 上記のヘッドモード作成が正しく投稿されることの実際の証明です。 これをスキップすると、壊れたスレッドを出荷したことがあります (あいまいなセレクター、誤ったツイート分割)。
- セッションゲート — 作成画面が読み込まれない場合、セッションが期限切れです →
loginを再実行してください。
5. 報告
ユーザーに次の情報を伝えてください: 投稿されたツイート数 (またはドライランの場合は作成数)、280文字を超えるツイート、添付された画像、使用されたプロファイルディレクトリ。
セレクターが失敗した場合は、どのステップで、XのUIが変更された可能性があること (post-x.mjs 内の data-testid が脆弱な部分です) を伝えてください。
注意事項
- 使用されるセレクター:
tweetTextarea_<i>、addButton、fileInput、tweetButton— 作成画面の[role="dialog"]内にスコープされています。Xが作成画面を変更した場合は、scripts/post-x.mjs内のこれらを更新してください。 - セッションは
~/.config/post-to-x/x-profileに保存されます (--profileで上書き可能)。 リポジトリの外にあるため、絶対にコミットしないでください。 - Xのみ対応。LinkedIn / Mastodon / Bluesky には無料APIがあります — それらについては、スクレイピングではなくスケジューラー (Postiz、Buffer、Typefully) を使用してください。