AI
用 Claude Code 一键发布文章到微信公众号

用 Claude skills 一键发布文章到微信公众号

作为一个经常写技术文章的开发者,我深知发布公众号文章的痛苦:

  1. 在编辑器里用 Markdown 写好文章
  2. 找一个 Markdown 转公众号格式的工具
  3. 复制转换后的内容到公众号后台
  4. 手动上传图片,一张一张替换
  5. 调整格式,预览,发布

整个过程繁琐且容易出错。有没有办法一条命令就搞定

答案是:有!用 Claude Code 的 Skill 功能。

最终效果

配置完成后,在 Claude Code 中只需要一句话:

发布 pages/blog/my-article.md 到公众号

或者使用 Skill 命令:

/wechat-publisher pages/blog/my-article.md

Claude 就会自动:

  • 读取 Markdown 文件
  • 上传所有图片到微信素材库
  • 转换为公众号支持的 HTML 格式
  • 自动选择第一张图片作为封面
  • 发布到草稿箱

你只需要去公众号后台点一下「发布」就行了。

前置条件

  1. 已安装 Claude Code:Anthropic 官方的 CLI 工具
  2. 已认证的微信公众号:个人订阅号(未认证)没有草稿接口权限
  3. Node.js 环境:用于运行发布脚本

实现原理

这个功能基于 Claude Code 的 Skill 机制实现。

Skill 是 Claude Code 的一个强大功能,允许你定义自定义命令。当你调用一个 Skill 时,Claude 会读取对应的说明文件,然后按照说明执行任务。

我们的 Skill 包含:

  • skill.md:告诉 Claude 如何使用这个技能
  • publish-draft.js:实际执行发布的 Node.js 脚本
  • config.json:存储公众号的 AppID 和 AppSecret

配置步骤

第一步:下载工具包

首先,你需要下载我准备好的skill。

方法一:直接下载

访问 GitHub 仓库 (opens in a new tab),点击绿色的「Code」按钮,选择「Download ZIP」下载。 下载后找到 wechat-publisher 目录即可。

方法二:用命令下载(适合熟悉命令行的用户)

打开终端复制粘贴下面这行命令:

git clone https://github.com/calmound/skills.git

克隆完成后,进入 skills 目录找到 wechat-publisher 文件夹。

第二步:把工具包放到正确的位置

下载完成后,你会得到一个 wechat-publisher 文件夹。

Skill 可以放在两个位置,根据你的需求选择:

选项 A:项目级 Skill(只在当前项目可用)

把文件夹放到你项目的 .claude/skills/ 目录下:

你的项目文件夹/
  └── .claude/
      └── skills/
          └── wechat-publisher/
              ├── skill.md
              ├── config.json
              └── scripts/
                  └── publish-draft.js

选项 B:全局 Skill(所有项目都可用) 推荐

把文件夹放到用户主目录的 .claude/skills/ 下,这样在任何项目中都能使用这个技能。

Mac / Linux 系统:

~/.claude/skills/wechat-publisher/

完整路径示例:/Users/你的用户名/.claude/skills/wechat-publisher/

Windows 系统:

C:\Users\你的用户名\.claude\skills\wechat-publisher\

或者使用环境变量表示:%USERPROFILE%\.claude\skills\wechat-publisher\

如何找到用户主目录?

  • Mac:打开 Finder,按 Command + Shift + G,输入 ~ 回车
  • Windows:打开文件资源管理器,在地址栏输入 %USERPROFILE% 回车

小提示:以 . 开头的文件夹默认是隐藏的

  • Mac:在 Finder 中按 Command + Shift + . 显示隐藏文件
  • Windows:在文件资源管理器中点击「查看」→ 勾选「隐藏的项目」

第三步:获取公众号的「钥匙」

接下来,我们需要从微信公众号后台获取两个重要的信息:AppIDAppSecret

这两个就像是你公众号的「钥匙」,有了它们,脚本才能帮你发布文章。

操作步骤:

  1. 打开浏览器,访问 微信公众平台 (opens in a new tab)
  2. 用你的公众号账号登录
  3. 在左侧菜单找到「设置与开发」,点击展开
  4. 点击「开发接口管理」,进入「微信开发者平台」
  5. 选择自己的公众号
  6. 在页面上你会看到:
    • AppID(应用ID):直接复制保存
    • AppSecret(应用密钥):点击「重置」按钮获取(首次使用需要重置)

注意:AppSecret 只会显示一次!请立刻复制保存到安全的地方。如果忘记了,只能重新重置。

第四步:填写配置文件

现在,我们要把刚才获取的「钥匙」填到配置文件里。

  1. wechat-publisher 文件夹里,找到 config.json文件
  2. 用任意文本编辑器打开 config.json(记事本、VS Code 都可以)
  3. 把你的 AppID 和 AppSecret 填进去:
{
  "appId": "把你的AppID粘贴到这里",
  "appSecret": "把你的AppSecret粘贴到这里"
}

保存文件,这一步就完成了。

安全提醒:config.json 包含你的公众号密钥,不要分享给别人,也不要上传到 GitHub!

第五步:添加 IP 白名单

最后一步,我们需要告诉微信:「这台电脑是安全的,允许它发布文章」。

5.1 查看你电脑的公网 IP 查询IP的方法可以问下豆包或者任意AI工具,或者直接问你的claude让他去查询。

5.2 把 IP 添加到白名单

  1. 回到微信公众平台的「基本配置」页面
  2. 就在刚才应用密钥的下面,选择设置IP
  3. 点击「确定」保存

小提示:如果你的网络 IP 经常变化(比如用的是家庭宽带),每次 IP 变了都需要重新添加。

恭喜你,配置全部完成!

使用方法

方式一:自然语言

直接告诉 Claude:

发布 pages/blog/my-article.md 到公众号

方式二:Skill 命令

/wechat-publisher pages/blog/my-article.md

指定封面图片

默认使用文章第一张图片作为封面。如需指定:

/wechat-publisher pages/blog/my-article.md ./cover.png

发布成功

📝 读取文章内容...
📌 文章标题: 我的技术文章
📷 发现 3 张图片,正在上传到微信...
   上传: image1.png ✅
   上传: image2.png ✅
   上传: image3.png ✅
🔄 转换为微信格式...
🖼️ 使用文章第一张图片作为封面: image1.png
📤 发布到草稿箱...

✨ 发布成功!
📋 草稿 media_id: xxx

👉 请到微信公众号后台 -> 内容管理 -> 草稿箱 查看

总结

通过 Claude Code 的 Skill 功能,我们实现了:

  1. 一键发布:告别繁琐的复制粘贴
  2. 自动上传图片:不用手动处理每张图片
  3. 格式自动转换:Markdown 直接变公众号格式
  4. 智能封面:自动使用第一张图片