Communitygithub.com

Gamma-Software/post-to-x-skill

実際のWeb UI(Playwright、有料API不要)を使ってX/Twitterにツイートまたはスレッドを投稿する — Claude Code / エージェントスキル

post-to-x-skill とは?

このスキルは、有料APIに頼らず、Playwrightを使用して実際のブラウザでX.comにツイートやスレッドを投稿します。2026年2月にXが無料APIを廃止したため、一度手動でログインしたブラウザセッションを再利用し、サイト自体を通じて投稿します。公式Chromeバイナリを使用し、自動化フラグを除去することでXの「信頼されないブラウザ」チェックを回避します。Claude CodeやCursorなどのAIエージェント向けに設計されており、ドライラン機能で実際に投稿する前に内容を確認でき、画像添付、スレッド解析、文字数カウントなどに対応しています。Xの利用規約により自動投稿は禁止されているため、低頻度で人間らしいペースでの自己投稿用途に限定され、必ずドライランを実行し、ユーザーの明示的な承認なしには投稿しません。

対応✓Claude Code~Codex CLI~Cursor
npx skills add Gamma-Software/post-to-x-skill

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

プレビュー

スキル README より

post-to-x-skill preview

ドキュメント

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 <パス>。ツイートの境界は自動検出されます。
    1. ツイートごとの **N/M** マーカー (build-in-public の x-thread.md スタイル)、または
    2. --- のみの行で区切られたツイート、または
    3. 区切りなし → ファイル全体が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) を使用してください。

関連スキル