baoyu-post-to-x

🐦 真实浏览器驱动的X自动化发布

个人开发者开源的X/Twitter自动化发布工具,基于真实Chrome浏览器绕过反爬虫,支持图文、视频、长文章一键发布,适合技术用户提升社媒运营效率。

收藏
3.4k
安装
1k
版本
v0.1.0
CLS 安全性认证2026-05-08
点击查看完整报告 >

使用说明

核心用法

baoyu-post-to-x 是一款面向 X(原 Twitter)平台的自动化内容发布工具,通过操控真实 Chrome 浏览器实现绕过反自动化检测。该 Skill 提供四种核心发布模式:常规推文(支持最多4张图片)、视频推文(最长140秒,Premium用户可达60分钟)、引用推文(带评论转发)以及 X Articles 长文章(需 Premium 订阅,支持 Markdown 格式)。所有操作均通过 CDP(Chrome DevTools Protocol)与浏览器通信,首次使用需手动登录 X 账户以保存会话 Cookie,后续即可自动化执行。

使用方法简洁直观:通过 npx -y bun 调用对应脚本,默认进入预览模式,确认无误后追加 --submit 参数完成发布。长文章支持 YAML frontmatter 定义标题和封面图,系统会自动将 Markdown 转换为 HTML 并处理远程图片下载。配置文件 EXTEND.md 支持项目级和用户级自定义,可设置默认 Chrome 配置路径和自动提交偏好。

显著优点

该 Skill 的最大优势在于反检测能力——使用真实 Chrome 而非 headless 浏览器,配合 CDP 协议模拟人工操作,有效规避 X 平台的反爬虫机制。预览-提交的双阶段设计提供了充足的内容检查窗口,避免误发。跨平台支持完善(macOS/Linux/Windows),通过 osascript、PowerShell、xdotool 等原生工具实现系统级剪贴板和键盘事件控制。

功能覆盖全面,从短图文到长文章、从原创到引用转发形成完整工作流。Markdown 原生支持降低了内容创作门槛,适合技术写作者和自媒体运营者。代码结构清晰,参数解析和错误处理较为规范,用户输入通过 JSON.stringify 转义后注入,基本杜绝了注入攻击风险。

潜在缺点与局限性

环境依赖较重是首要门槛:必须安装 Chrome/Chromium 和 bun 运行时,且首次配置需要图形界面交互登录,无法在纯 CI/CD 环境或服务器端部署。权限要求宽泛可能引发安全顾虑——macOS 需授予终端"辅助功能"权限以发送键盘事件,Windows/Linux 同样需要系统级自动化权限,但 SKILL.md 未充分声明这些需求。

依赖管理松散构成稳定性风险:无 package.json 锁定版本,,npx -y bun 动态获取可能导致运行时行为不一致。部分操作缺乏二次确认(如文章发布),虽然默认预览模式缓解了风险,但 --submit 一旦执行即不可撤销。远程图片下载缺乏来源验证,若 Markdown 包含恶意 URL 可能带来安全隐患。

适合的目标群体

该 Skill 最适合技术背景的内容创作者社交媒体运营者——熟悉命令行操作、需要批量或自动化发布 X 内容,且拥有 Premium 订阅以解锁长文章功能。个人博主、独立开发者、技术写作者可将其集成到内容发布工作流中,实现从 Markdown 写作到一键分发的闭环。

不适用场景包括:多用户共享设备(Chrome profile 包含登录态)、无图形界面的服务器环境、对权限敏感的企业安全策略环境,以及完全非技术用户(配置门槛较高)。

使用风险

账户安全风险:自动化操作违反 X 平台服务条款,存在账号受限或封禁可能,建议控制发布频率。数据隐私风险:Cookie 和登录态保存在本地 ~/.local/share/x-browser-profile,设备共享可能导致账户泄露。系统稳定性风险:Chrome 进程异常终止可能留下僵尸进程,需手动清理。供应链风险:bun 运行时动态获取,若上游被篡改可能影响执行安全。

安全解读

功能概览

baoyu-post-to-x 是一款针对 X (Twitter) 的自动化发布工具,核心特点是使用真实 Chrome 浏览器通过 Chrome DevTools Protocol (CDP) 进行操作,而非传统的 API 调用方式。这种设计使其能够绕过 X 平台的反机器人检测,支持完整的功能包括图文推文、视频上传、引用转发以及 X Articles 长文发布。

核心用法

Skill 提供四种主要发布模式,均通过 Bun 运行时执行 TypeScript 脚本:

1. 常规图文推文x-browser.ts 支持最多 4 张图片,默认预览模式,需加 --submit 才会正式发布
2. 视频推文x-video.ts 处理 140 秒(普通用户)或 60 分钟(Premium)以内的视频文件

3. 引用转发x-quote.ts 对指定推文添加评论转发

4. 长文文章x-article.ts 将 Markdown 转换为 X Articles 格式发布(需 X Premium 订阅)

首次使用需手动登录 X 账号,会话状态会持久保存在本地 Chrome 配置文件中。

显著优点

  • 反检测能力强:真实浏览器环境 + CDP 协议,避免被识别为自动化脚本
  • 功能覆盖完整:支持 X 平台的几乎所有内容形式,包括需要 Premium 的长文功能
  • 零第三方依赖:仅使用 Node.js 内置模块,供应链攻击风险极低
  • 跨平台支持:macOS、Linux、Windows 均可使用,适配各平台的剪贴板工具
  • 配置灵活:通过 EXTEND.md 支持项目级和用户级的自定义配置

潜在局限与风险

  • 系统权限要求:需要终端应用的"辅助功能"权限(macOS)或剪贴板工具(Linux),涉及中等风险的系统级交互
  • Chrome 配置管理:登录会话存储在本地目录,需用户自行管理安全性和清理
  • 无原生 API 保障:依赖浏览器 DOM 操作,若 X 前端改版可能导致脚本失效
  • 首次配置门槛:需要安装 Chrome、Bun 运行时,并完成手动登录流程

适合人群

  • 内容创作者:需要批量发布或定时发布推文、文章的博主、自媒体运营者
  • 社交媒体运营:管理多个账号或需要自动化内容分发的营销团队
  • 开发者/技术用户:熟悉命令行操作,希望在 CI/CD 流程中集成社交媒体发布的工程师
  • Premium 订阅用户:特别需要 X Articles 长文功能的重度用户

常规风险提醒

1. 账号安全:虽然工具本身不存储密码,但 Chrome 配置文件包含登录会话,建议在共享环境使用后清理配置目录
2. 平台政策:自动化发布可能违反 X 的服务条款,建议控制发布频率,避免触发平台限制

3. 剪贴板内容:工具会临时使用系统剪贴板传输图片数据,敏感期间避免在剪贴板存放机密信息

4. 远程图片:Markdown 文章中的远程图片会被下载到本地,建议确认图片来源可信

技术可信度

由 GitHub 组织账号 clawdbot 维护(T2 级别来源),代码经过静态分析和动态行为审计,未发现恶意模式或硬编码密钥。整体安全评级为 A 级(70 分),属于标准安全级别的生产可用工具。

baoyu-post-to-x 内容

references文件夹
scripts文件夹
手动下载zip · 33.9 kB
articles.mdtext/markdown
请选择文件