Communitygithub.com

Gamma-Software/post-to-x-skill

通过真实的网页界面(Playwright,无需付费 API)发布推文或帖子到 X/Twitter——适用于 Claude Code 或 AI agent 的技能。

post-to-x-skill 是什么?

Post to X 是一款 AI agent 技能,让用户无需付费 X API 即可通过真实浏览器发布推文或帖子。X 于 2026 年 2 月取消了免费 API,本技能通过 Playwright 和 Google Chrome 驱动 x.com 网页界面,用户只需手动登录一次,后续会话可复用。该技能支持单条推文和帖子线程(自动识别线程分隔符),可附加图片,默认在无头模式下运行。它强调安全:必须先执行带 `--headed` 和 `--dry-run` 的预演,让用户确认内容无误后再实际发布。技能包含解析、预演和会话检查三个安全关卡,并使用 `data-testid` 定位器与 X 合成器交互,避免与易变的 API 耦合。适用于低频率、人类节奏的自主发布场景(如发布版本更新、构建过程分享等),但也提醒用户注意:自动化发布违反 X 服务条款,可能导致账号被封禁。

兼容平台✓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 于 2026 年 2 月取消了免费 API(按使用付费:每条 $0.015,含链接 $0.20),因此本技能复用您手动登录一次的浏览器会话,并通过网站本身发布。它使用真实的 Chrome 二进制文件并剥离自动化标志,以绕过 X 的“浏览器不可信”检查。

登录一次(手动)→ 解析文本/帖子 → 在有头的预演中编写 → [用户确认] → 实际发布

服务条款与风险。 自动化发布违反 X 的服务条款,可能导致账号被标记。本技能适用于低频率、人类节奏的自主发布——例如版本发布帖子、构建公开分享等,而非批量机器人。务必先进行预演,保持人为延迟,未经用户明确同意绝不代发。

0. 一次性设置

脚本需要安装 Playwright 和 Google Chrome(Chrome 是可信的二进制文件;Playwright 仅提供驱动——无需下载浏览器)。

cd <skill-dir> && 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 <path>。推文边界自动检测:
    1. 每条推文带有 **N/M** 标记(build-in-public 风格的 x-thread.md 格式),否则
    2. 推文之间由仅包含 --- 的行分隔,否则
    3. 无分隔符 → 整个文件为一条推文。
  • 图片——每条推文内,添加一行 _image: path_ 或 ![](path);或通过可重复的 --image <path> 附加到第一条推文。X 每条推文最多支持 4 张图片。路径相对于文件。
  • 自动删除:> … 块引用(草稿横幅)、# … 标题、_(…chars…)_ 注释。

请确保每条推文 ≤ 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 的界面可能已更改(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)发布到那些平台,而非爬取。

相关技能