SuperAPI AI 工具集

baoyu-post-to-x

办公与效率

查看项目

更新于 10-16 09:17

技能介绍

用途

baoyu-post-to-x 用于把内容发布到 X(Twitter)。它通过真实 Chrome 浏览器(配合 CDP)来绕过反机器人检测,支持发布普通帖子、视频帖子、引用推文以及 X Articles 长文。

主要能力

该技能提供以下脚本:

  • scripts/x-browser.ts:普通帖子(文本 + 图片)
  • scripts/x-video.ts:视频帖子(文本 + 视频)
  • scripts/x-quote.ts:带评论的引用推文
  • scripts/x-article.ts:长文发布(Markdown)
  • scripts/md-to-html.ts:Markdown → HTML 转换
  • scripts/copy-to-clipboard.ts:复制内容到剪贴板
  • scripts/paste-from-clipboard.ts:发送真实粘贴按键
  • scripts/check-paste-permissions.ts:验证环境与权限

所有脚本均位于技能的 scripts/ 子目录中。文档中出现的 ${SKILL_DIR} 应替换为该 SKILL.md 文件所在目录的实际路径。

使用方式

依赖前提

  • Google Chrome 或 Chromium
  • bun 运行时
  • 首次运行:手动登录 X(会话会被保存)

环境预检(可选)

首次使用前可运行环境检查,用户可自行跳过:

npx -y bun ${SKILL_DIR}/scripts/check-paste-permissions.ts

检查项包括:Chrome、profile 隔离、Bun、辅助功能(Accessibility)、剪贴板、粘贴按键、Chrome 冲突。若某项检查失败,可按对应方式修复:

  • Chrome:安装 Chrome,或设置 X_BROWSER_CHROME_PATH 环境变量
  • Profile 目录:确保 ~/.local/share/x-browser-profile 可写
  • Bun 运行时:curl -fsSL https://bun.sh/install | bash
  • 辅助功能(macOS):系统设置 → 隐私与安全性 → 辅助功能 → 启用终端应用
  • 剪贴板复制:确保 Swift/AppKit 可用(macOS Xcode 命令行工具:xcode-select --install)
  • 粘贴按键(macOS):同上辅助功能修复
  • 粘贴按键(Linux):安装 xdotool(X11)或 ydotool(Wayland)

普通帖子

文本 + 最多 4 张图片。

npx -y bun ${SKILL_DIR}/scripts/x-browser.ts "Hello!" --image ./photo.png

参数:<text> 帖子内容(位置参数);--image <path> 图片文件(可重复,最多 4 张);--profile <dir> 自定义 Chrome profile。

注意:脚本会打开浏览器并填入内容,用户需审阅并手动发布。

视频帖子

文本 + 视频文件。

npx -y bun ${SKILL_DIR}/scripts/x-video.ts "Check this out!" --video ./clip.mp4

参数:<text> 帖子内容(位置参数);--video <path> 视频文件(MP4、MOV、WebM);--profile <dir> 自定义 Chrome profile。

注意:脚本会打开浏览器并填入内容,用户需审阅并手动发布。限制:普通账号最长 140 秒,Premium 账号最长 60 分钟。处理耗时:30-60 秒。

引用推文

引用已有推文并附评论。

npx -y bun ${SKILL_DIR}/scripts/x-quote.ts https://x.com/user/status/123 "Great insight!"

参数:<tweet-url> 要引用的推文 URL(位置参数);<comment> 评论文本(位置参数,可选);--profile <dir> 自定义 Chrome profile。

注意:脚本会打开浏览器并填入内容,用户需审阅并手动发布。

X Articles(长文)

长文 Markdown 文章(需要 X Premium)。

npx -y bun ${SKILL_DIR}/scripts/x-article.ts article.md
npx -y bun ${SKILL_DIR}/scripts/x-article.ts article.md --cover ./cover.jpg

参数:<markdown> Markdown 文件(位置参数);--cover <path> 封面图;--title <text> 覆盖标题。

Frontmatter 支持 title、cover_image(在 YAML front matter 中)。

注意:脚本会打开浏览器并填入文章内容,用户需审阅并手动发布。

组合后检查:脚本在所有图片插入后会自动验证编辑器内容中是否残留 XIMGPH_ 占位符,以及预期与实际的图片数量是否一致。若检查失败(输出中出现警告),会在用户发布前提醒具体问题。

偏好设置(EXTEND.md)

使用 Bash 检查 EXTEND.md 是否存在(优先级顺序):

# 先检查项目级
test -f .baoyu-skills/baoyu-post-to-x/EXTEND.md && echo "project"

# 再检查用户级(跨平台:$HOME 适用于 macOS/Linux/WSL)
test -f "$HOME/.baoyu-skills/baoyu-post-to-x/EXTEND.md" && echo "user"

路径位置:.baoyu-skills/baoyu-post-to-x/EXTEND.md 为项目目录;$HOME/.baoyu-skills/baoyu-post-to-x/EXTEND.md 为用户主目录。

结果处理:找到则读取、解析并应用设置;未找到则使用默认值。

EXTEND.md 支持:默认 Chrome profile。

适用场景与限制

适用场景:需要向 X(Twitter)发布文本、图片、视频、引用推文或长文文章。

限制与注意事项:

  • 首次运行需手动登录(会话会持久保存)。
  • 所有脚本仅把内容填入浏览器,用户必须自行审阅并手动发布。
  • 跨平台支持:macOS、Linux、Windows。
  • 排除故障:若脚本报错 Chrome debug port not ready 或 Unable to connect,先杀掉已存在的 Chrome CDP 实例再重试:
pkill -f "Chrome.*remote-debugging-port" 2>/dev/null; pkill -f "Chromium.*remote-debugging-port" 2>/dev/null; sleep 2

遇到此错误时应自动杀掉 Chrome CDP 实例并重试,无需询问用户。

更多参考:普通帖子见 references/regular-posts.md(含手动工作流、排错与技术细节);X Articles 见 references/articles.md(长文发布指南)。

关于收费、价格、平台具体效果等信息,资料中暂未提供。