發布到 X
透過驅動 x.com 的真實瀏覽器(而非 API)發布推文或串文至 X/Twitter。 X 已於 2026 年 2 月移除免費 API(改為按次計費:每則 $0.015,含連結則 $0.20), 因此本技能重複使用一個您手動登入一次的瀏覽器會話,直接透過網站本身發布。 它使用真實的 Chrome 二進位檔並移除自動化標記,以繞過 X 的「瀏覽器不受信任」檢查。
手動登入一次 → 解析文字/串文 → 在可視化試跑中撰寫 → [用戶確認] → 真實發布
使用條款與風險。 自動化發布違反 X 的使用條款,可能導致帳號被標記。 此技能僅用於低頻率、人類節奏的個人發布——例如發布版本公告、公開開發進度—— 而非大量機器人操作。請務必先進行試跑,保持人類般的延遲, 且未經用戶明確同意絕不代為發布。
0. 一次性設定
腳本需要安裝 Playwright 和 Google Chrome(Chrome 是受信任的二進位檔; Playwright 僅提供驅動程式——無需下載瀏覽器)。
cd <技能目錄> && npm install # 將 Playwright 安裝至技能目錄
然後手動驗證一次——將開啟真實 Chrome;用戶手動登入(密碼 + 雙重驗證),
會話將儲存至 ~/.config/post-to-x/x-profile:
node scripts/post-x.mjs login
如果 channel: "chrome" 報錯,表示未找到 Chrome——請安裝 Google Chrome(而不僅是 Chromium)。
登入視窗最多等待 5 分鐘以確認登入狀態。
1. 準備內容
可接受內嵌文字或檔案:
- 單篇推文 —
--text "…" - 串文檔案 —
--file <路徑>。推文邊界自動偵測:- 每則推文使用
**N/M**標記(符合x-thread.md的公開開發格式),否則 - 推文之間以只含
---的行分隔,否則 - 無分隔符 → 整個檔案視為一篇推文。
- 每則推文使用
- 圖片 — 每則推文內,加入一行
_image: 路徑_或; 或使用可重複的--image <路徑>附加至第一則推文。X 每則最多接受 4 張圖片。 路徑相對於檔案所在目錄。 - 自動移除:
> …引用區塊(草稿橫幅)、# …標題、_(…字元…)_備註。
確保每則推文不超過 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),而非進行爬取。