mcpField
P
publish-x-article

publish-x-article

github.com/heyvhuang营销与增长33849 次安装30 周前更新
代码仓库

关于 publish-x-article

publish-x-article 是将 Markdown 转为 X Articles 草稿的技能，可保留格式并按确定顺序插入图片，适合准备手动发布文章的用户。它不会自动发布，文章需由用户自行发布。

主要功能

  1. 01将 Markdown 转换为文章内容
  2. 02通过富文本粘贴保留格式
  3. 03按确定顺序插入图片
  4. 04将首张图片设为封面
  5. 05保存解析结果和 HTML 文件

适用场景

  1. 01将 Markdown 文章整理为 X 草稿
  2. 02制作带封面图片的文章草稿
  3. 03发布前检查生成的文章内容

MCP 相关

该工作流需要浏览器自动化，例如 Playwright MCP 或同类工具，以操作 X Articles。它只创建草稿，文章由用户手动发布。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/heyvhuang/ship-faster --skill publish-x-article

安装后在 Claude Code 中输入/publish-x-article确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
runbook.md
scripts/
copy_to_clipboard.py
parse_markdown.py

详细介绍

X 文章发布工具

将 Markdown 内容发布为 X（Twitter）文章草稿，通过粘贴富文本保留格式，并确定性地插入图片。

安全硬性规则

  1. 绝不自动发布（仅创建草稿；由用户手动发布）。
  2. 自动化开始前，用户必须已登录。
  3. 第一张图片 = 封面图片（如果有）。

前置条件

  • 可用的浏览器自动化工具（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
  • ~/.claude/skills/publish-x-article/scripts/copy_to_clipboard.py

操作指南（分步说明）

请遵循：references/runbook.md

评论

支持 Markdown