用途:把 Markdown 文件转换为 X(Twitter)Articles 草稿,通过富文本粘贴保留格式,并按固定规则插入图片。
主要能力与安全规则:仅创建草稿,绝不自动发布;自动化开始前要求用户已登录;如有图片,第一张作为封面图;图片插入具有确定性。
前提条件:需要浏览器自动化能力(如 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/evidence/x-article-draft.md 记录操作内容与链接。
使用方式:按 references/runbook.md 的步骤执行。随附脚本通常安装于 ~/.claude/skills/tool-x-article-publisher/scripts/parse_markdown.py 与 ~/.claude/skills/tool-x-article-publisher/scripts/copy_to_clipboard.py。
限制:不会自动发布,最终发布需用户手动完成;依赖浏览器自动化环境和 X 账号权限;剪贴板辅助脚本推荐 macOS。其他平台细节暂未提供。