Communitygithub.com

Gamma-Software/post-to-x-skill

透過真實網頁介面(Playwright,無需付費 API)發送推文或串文至 X/Twitter — 適用於 Claude Code 等 AI Agent。

post-to-x-skill 是什麼?

該技能讓 AI Agent 能夠透過真實瀏覽器(Playwright 控制 Chrome)在 X/Twitter 上發布推文或串文,完全繞過 X 於 2026 年 2 月實施的付費 API(每則 $0.015,含連結則 $0.20)。用戶只需手動登入一次,瀏覽器 session 會自動保存至 `~/.config/post-to-x/x-profile`,後續即可透過自動化操作發布內容。技能支援單篇推文(`--text`)或從檔案讀取串文(`--file`),並能自動偵測串文邊界(使用 `**N/M**`、`---` 分隔線或無分隔)。它還支援每則推文附加圖片(`--image`、`_image: path_` 或 `![](...)` 語法),並自動移除草稿標記(`> …`)、標題(`# …`)及備註(`_…_`)。因為 X 的服務條款禁止自動化發布,此技能設計為低頻率、人類節奏的張貼(如發布版本公告或開發進度),並強制要求透過 `--dry-run` 先進行可視化預覽,確保用戶確認後才真正發布。這是一種針對少量、有控制的發布需求的實用解決方案,避免了第三方排程服務的成本與依賴。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add Gamma-Software/post-to-x-skill

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

預覽

來自技能 README

post-to-x-skill preview

說明文件

發布到 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 <路徑>。推文邊界自動偵測:
    1. 每則推文使用 **N/M** 標記(符合 x-thread.md 的公開開發格式),否則
    2. 推文之間以只含 --- 的行分隔,否則
    3. 無分隔符 → 整個檔案視為一篇推文。
  • 圖片 — 每則推文內,加入一行 _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),而非進行爬取。

相關技能