发布到 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>。推文边界自动检测:- 每条推文带有
**N/M**标记(build-in-public 风格的x-thread.md格式),否则 - 推文之间由仅包含
---的行分隔,否则 - 无分隔符 → 整个文件为一条推文。
- 每条推文带有
- 图片——每条推文内,添加一行
_image: 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)发布到那些平台,而非爬取。