用途:把 Markdown 文章转换为 X(Twitter)Articles 草稿,保留格式并确定性插入图片,最终由用户手动发布。
主要能力:解析 Markdown 生成结构化数据与可粘贴的 HTML 正文;通过富文本粘贴保留格式;按顺序插入图片,第一张图片作为封面图(如有)。
使用方式:需先登录 X 账号再启动自动化;依赖浏览器自动化(Playwright MCP 或等效工具);X 账号需可访问 Articles(Premium / Premium Plus);推荐 macOS(剪贴板辅助使用 Cocoa);需 Python 3.9+,安装依赖:pip install Pillow pyobjc-framework-Cocoa。输入为 article_md_path(Markdown 文件路径),可选 run_dir 存放产物,默认使用 /tmp/。产物包括 /tmp/x_article.json(解析结构)、/tmp/x_article.html(用于粘贴的 HTML 正文),可选 run_dir/05-final/x-article-draft.md。脚本通常位于 ~/.claude/skills/publish-x-article/scripts/parse_markdown.py 与 copy_to_clipboard.py,操作步骤见 references/runbook.md。
限制:仅生成草稿,绝不自动发布;必须用户已登录;平台与账号权限、系统环境等前提不满足时无法使用。