用途:把 Markdown 文件或内容发布到 X(Twitter)Articles 编辑器,自动完成格式转换与草稿创建,适合需要将长文同步到 X 的用户。
前提条件:需要 X Premium Plus 订阅;Python 3.9+,依赖安装命令为 pip install Pillow pyobjc-framework-Cocoa patchright。
认证:首次使用需运行 python auth_manager.py setup,手动登录并完成 2FA,认证状态保存 7 天。管理命令包括 status、validate、clear、reauth。认证数据存于 ~/.claude/skills/x-article-publisher/data/browser_state/。
主要脚本:publish_article.py 为一键发布主脚本,支持 --file、--headless、--title 参数;parse_markdown.py 解析 Markdown 并输出 JSON 或 HTML,含 title、cover_image、content_images、html、total_blocks 等字段;copy_to_clipboard.py 可将图片或 HTML 复制到系统剪贴板。
工作流:运行 publish_article.py 后自动检查认证、解析 Markdown、启动浏览器、导航到 X Articles、点击 create、上传封面图(如有)、填写标题、粘贴 HTML 内容并保存草稿。
智能增强:无 H1 标题时返回 needs_title_generation,可由 Claude 生成标题;无封面图时返回 needs_cover_generation,可调用生图技能生成,但封面图上传目前需在浏览器中手动操作。
支持格式:H2 标题、引用、代码块(转为引用)、粗体、超链接、有序/无序列表、段落。
限制:绝不自动发布,仅保存草稿;不自动设置封面图;H1 仅作标题不进入正文;需手动检查并发布。其他细节暂未提供。