mcpField
Z
zhy-wechat-publish

zhy-wechat-publish

github.com/zhylqMarketing & growth35109 installsUpdated 33w ago
Repository

About zhy-wechat-publish

A skill for sending articles to a WeChat Official Account draft box. It prepares HTML for WeChat, uploads body images, and can generate and upload a cover before creating the draft.

Key features

  1. 01Uploads HTML articles as drafts
  2. 02Adapts CSS and lists for WeChat
  3. 03Uploads body images and replaces URLs
  4. 04Sets author and comment options
  5. 05Generates and uploads a cover image

Use cases

  1. 01Send a prepared HTML article to drafts
  2. 02Prepare article images for WeChat display
  3. 03Create a cover and submit an article draft

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/zhylq/yuan-skills --skill zhy-wechat-publish

After installing, type/zhy-wechat-publishin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.env.example
README.md
scripts/
publish_with_cover.js
upload_image.js
wechat_draft.js

Details

From the project README

微信公众号草稿箱发布技能

本技能用于将文章发布到微信公众号草稿箱。脚本仅依赖 Node.js 内置模块；自动封面生成步骤会复用现有 bun 生图脚本。

前置条件

  1. Node.js >= 16
  2. 若要自动生成封面，还需本机可用 bun
  3. 技能目录下 .env 至少包含：
WECHAT_APP_ID=你的公众号AppID
WECHAT_APP_SECRET=你的公众号AppSecret
WECHAT_DEFAULT_THUMB_MEDIA_ID=默认封面图media_id（可选）
WECHAT_DEFAULT_AUTHOR=AI源来如此（可选）
  1. 运行机器公网 IP 已加入公众号后台 IP 白名单
  2. 自动生成封面时，需保证 zhy-article-illustrator 的生图环境可用

安装说明

本 skill 适合与 npx skills add ... --skill zhy-wechat-publish 一起安装到 OpenCode、Claude Code 等支持 SKILL.md 的 agent 工具中。

安装后请在本地 skill 目录手动创建 .env，不要将真实凭据提交回仓库。

脚本清单

脚本位于 scripts/：

脚本用途
wechat_draft.js上传正文到公众号草稿箱
upload_image.js上传本地封面图到永久素材库，获取 media_id
publish_with_cover.js读取文章、生成封面、上传封面并推送草稿

核心能力

  • 自动处理正文 CSS 变量兼容
  • 自动将正文图片上传到微信正文图片接口并替换 URL
  • 自动将 ul/ol 降级为微信公众号编辑态更稳定的段落列表
  • 支持默认作者、评论开关、仅粉丝评论设置
  • 支持从文章内容生成单张公众号封面，并自动上传为 thumb_media_id

工作流

方式一：已准备好 HTML 与封面 media_id
node scripts/wechat_draft.js --title "文章标题" --file "post.html" --author "AI源来如此" --thumb "MEDIA_ID" --need-open-comment "1" --only-fans-can-comment "1"

参数说明：

参数必填说明
--title是文章标题
--file是HTML 正文文件路径
--author否作者，不传时默认 WECHAT_DEFAULT_AUTHOR 或 AI源来如此
--digest否摘要
--thumb否封面 media_id，不传时读取 .env 默认值
--source-url否原文链接
--need-open-comment否是否开启评论，默认 1
--only-fans-can-comment否是否仅粉丝可评论，默认 1
方式二：自动生成封面并发布

当你已有文章源文件，以及最终用于上传的 HTML 文件时，可直接运行：

node scripts/publish_with_cover.js --article "article.md" --html "post.html" --author "AI源来如此" --source-url "https://example.com"

该脚本会自动完成：

  1. 读取文章内容并提取标题/摘要
  2. 调用 zhy-article-illustrator/scripts/image-gen.ts 生成单张 16:9 封面图
  3. 调用 upload_image.js --json 上传封面，获得 thumb_media_id
  4. 调用 wechat_draft.js 推送草稿，并自动带上：
    • author
    • thumb_media_id
    • need_open_comment=1
    • only_fans_can_comment=1

可选参数：

参数说明
--article原始文章文件，推荐 Markdown，也可 HTML
--html最终上传到公众号的 HTML 文件
--title显式覆盖标题
--author显式覆盖作者
--cover-output自定义封面输出路径
--cover-ar封面宽高比，默认 16:9
--source-url原文链接
--need-open-comment是否开启评论，默认 1
--only-fans-can-comment是否仅粉丝可评论，默认 1

正文兼容说明

发布前，wechat_draft.js 会自动处理：

  1. var(--xxx) CSS 变量展开
  2. 微信 section 背景样式兼容
  3. 首个 h1 去除，避免与标题重复
  4. 正文图片上传到 cgi-bin/media/uploadimg
  5. 原生列表转换为普通段落列表

错误排查

  • [40013] invalid appid：检查 .env 中 WECHAT_APP_ID
  • [40164] invalid ip... not in whitelist：将报错 IP 加入微信后台白名单
  • [40007] invalid media_id：封面素材无效，重新上传封面图
  • 缺少 Xiaomi/Gemini/OpenAI API Key：自动封面生成所需生图配置缺失
  • 正文图片不显示：检查原图路径/URL 是否可访问，以及 media/uploadimg 是否成功

快速示例

# 已有 HTML，直接发草稿
node scripts/wechat_draft.js --title "技术周报" --file "post.html"

# 自动生封面并发布
node scripts/publish_with_cover.js --article "article.md" --html "post.html"

# 上传封面图并把 media_id 回写 .env
node scripts/upload_image.js "cover.png" --write-env --json

Comments

Markdown supported