# Wechat Mp Draft > 代写微信公众号文章并保存到公众号草稿箱。使用场景：用户需要撰写公众号文章并直接发布到微信公众号后台草稿箱；或排查公众号草稿箱里的「标题在文章顶部重复显示两次」「标题行既出现在 title 字段又出现在 body」等 markdown-renderer 标题重复问题。触发词："写公众号文章"、"保存到公众号草稿"、"微信文章"、"公众号发文"、"标题重复"、"草稿标题显示两次"。 - Skill: `mebusw/wechat-mp-draft` (Agent Skill, multi-file: 3 files) - Install (CLI): `npx skillmds@latest add mebusw/wechat-mp-draft` - Raw SKILL.md: https://api.skillmd.com/api/skills/mebusw/wechat-mp-draft/raw - Safety review: pending (external: skill-scanner PASS, skillspector CAUTION) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Docs & Writing - Author: mebusw (https://skillmd.com/u/mebusw) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/mebusw/wechat-mp-draft --- # 微信公众号草稿 Skill 编写微信公众号文章并保存到草稿箱，流程如下： 1. 基于用户输入，调用SKILL `/jackyshen-write-wechat-article` 或其他类似的技能，改写为微信公众号风格的文章，md格式（首行为 `# 标题`） 2. **从 markdown 中删除首行 `# 标题`**，避免标题在 body 里重复显示（详见「问题 5」） 3. 调用SKILL `/wechat-markdown-html-render` 来分别渲染文本和代码样式，得到html格式的输出文件。 4. 调用SKILL `/huny-img` 或其他任何可用的文生图片(image generation)SKILL来配**1张封面图**（ar 2.35:1） 5. 调用SKILL `/huny-img` 或其他任何可用的文生图片(image generation)SKILL来生成 **2 张新生成的内容图片**，然后插入渲染后的正文 HTML 中。位置一般在头部一张（为了尽早吸引读者兴趣），中部一张（让读者保持兴趣继续读），具体位置和图片主题由 AI 根据文章内容来建议。 6. 继续调用本SKILL的工作流程来访问微信公众号文章草稿箱，标题作为 `title` 参数传入，body 只包含正文（`add_draft.sh` 也会自动剥离 body 开头 H1 作为最后一道防线） ## 前置条件 需要以下凭证（需自行配置）： - AppID: `wxYOUR_APPID_HERE` - AppSecret: `YOUR_SECRET_HERE` **获取方式：** 微信公众平台 → 设置与开发 → 基本配置 **重要：** 服务器 IP 必须添加到公众号后台的 IP 白名单中。 ## 工作流程 ### 1. 获取 Access Token ```bash ./scripts/get_access_token.sh ``` ### 2. 上传封面图片（获取 thumb_media_id） **封面图片是必填项！** ```bash ./scripts/upload_image.sh <图片路径> ``` 返回示例： ```json {"media_id":"xxx","url":"http://mmbiz.qpic.cn/..."} ``` ### 3. 将撰写的文章HTML保存到草稿箱 **⚠️ 标题分离规则（防止标题在 body 里重复显示）：** - 微信公众号后台从 `title` 字段渲染文章标题，并自动显示在文章顶部 - 如果 markdown 源文件以 `# 标题` 开头（来自 `/jackyshen-write-wechat-article` 的标准输出），`/wechat-markdown-html-render` 会把它渲染成 body 里的 `

` - 必须**只把标题传给 `title` 参数**，**不能让它留在 body 里**，否则用户会在文章顶部看到两次标题 - `add_draft.sh` 已内置**自动剥离 body 开头 H1** 的 sanitizer，作为最后一道防线：即使你没注意把 `# 标题` 留在了 markdown 里，脚本也会自动剥离并打印 ✅ `标题去重` 提示 ```bash ./scripts/add_draft.sh <标题> [AUTHOR] [摘要] ``` ### 4. 在正文 HTML 中插入 2 张新生成的内容图片 > **为什么必须用本接口**：微信规定正文里的图片 url 必须来自 `cgi-bin/media/uploadimg`，外部图片 url 会被过滤掉。本步骤会调 `/huny-img` 生图 → 下载到本地 → 上传获取永久 URL → 按 AI 建议位置插入 HTML。 #### 4.1 调用 `/huny-img` 生成图片（获取临时 URL，1 小时内有效） ```bash ~/.pyenv/versions/py312-huny-img/bin/python ~/.agents/skills/huny-img/scripts/hunyuan3-text-to-image.py \ -p "" \ -r 16:9 ``` 输出形如 `图片URL: https://...`，记录备用。 #### 4.2 下载到本地（临时 URL 1 小时后过期，必须立刻下载） ```bash curl -s -o /tmp/content_img_1.jpg "" ``` #### 4.3 调用 `upload_content_image.sh` 上传到微信（获取正文可用 URL） ```bash RESP=$(./scripts/upload_content_image.sh "$TOKEN" /tmp/content_img_1.jpg) URL_1=$(echo "$RESP" | jq -r '.url') ``` > 与 `upload_image.sh`（封面永久素材）的区别：本接口返回 `url` 字段（不是 `media_id`），且**不占公众号 10 万永久素材额度**。仅支持 JPG/PNG，文件 ≤1MB。 重复 4.1–4.3 得到第二张图的 `URL_2`。 #### 4.4 用 `insert_content_image.py` 按 AI 建议的位置插入到 HTML AI 先通读 HTML，挑选 2 个插入点（一般在文章中部、与上下文自然衔接处），可用以下任一方式指定： **单张插入（命令行）** ```bash # 在第 N 个

段落后插入 ./scripts/insert_content_image.py \ --input article.html --output article_with_imgs.html \ --url "$URL_1" --after-paragraph 3 # 或在指定 marker（HTML 子串）后插入 ./scripts/insert_content_image.py \ --input article_with_imgs.html --output article_final.html \ --url "$URL_2" --after-marker "

核心观点

" ``` **批量插入（JSON spec，一次完成多张）** ```bash cat > /tmp/img_spec.json <核心观点

"} ] EOF ./scripts/insert_content_image.py \ --input article.html --output article_final.html \ --spec /tmp/img_spec.json ``` > 生成的 `` 标签**紧凑无多余空格**：``，直接可用。 #### 4.5 将含图的最终 HTML 提交草稿 ```bash FINAL_CONTENT=$(cat article_final.html) ./scripts/add_draft.sh "$TOKEN" "标题" "$FINAL_CONTENT" "$THUMB_ID" "作者" "摘要" ``` ## 关键问题与解决方案 ### ❌ 问题 1：40007 invalid media_id **两种触发场景：** - **封面 `thumb_media_id`：** 是必填字段；封面图片必须是**永久素材**（通过 `add_material` 接口上传），不能直接用外部 URL。 - **草稿 `media_id` 已失效：** 草稿在公众号后台被打开 / 编辑 / 删除后，`media_id` 立即失效（即使是几分钟前刚返回的）。`draft/update` 和 `draft/get` 都会返回 40007。 **解决：** - 封面图：先上传永久素材： ```bash curl -F "media=@cover.jpg" "https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=TOKEN&type=image" ``` - 草稿失效：调 `cgi-bin/draft/batchget` 拿当前 id 列表（可能为空，说明被删了），再决定是 `update` 已有还是重新 `add`： ```bash curl -s -X POST "https://api.weixin.qq.com/cgi-bin/draft/batchget?access_token=$TOKEN" \ -H "Content-Type: application/json" -d '{"offset":0,"count":10,"no_content":1}' ``` ### ❌ 问题 2：IP 不在白名单（40164） **解决：** 登录微信公众平台 → 设置与开发 → **基本配置** → 公众号开发信息 → IP白名单 → 添加服务器 IP **注意：** 不要错加到「**安全中心** → 登录IP白名单」—— 那个只控制后台登录，对 `cgi-bin/token` API 无效。新加的 IP 通常立即生效，但偶尔有 1–2 分钟传播延迟，失败时先等再重试。如果 IP、AppID、白名单位置都核对过仍然失败，多半是 IP 添加到了错误的公众号账号（多账号情况），需对照 `config.sh` 里的 AppID 前缀重新检查。 ### ❌ 问题 3：HTML 内容格式错误 **解决：** - HTML 中的换行符会导致 JSON 解析失败 - 必须将换行符替换为空格 - 使用 `tr '\n' ' '` 处理 ### ❌ 问题 4：有序/无序列表在公众号编辑器里渲染异常 公众号编辑器的 HTML ingester 有两个非标准行为，会让 `
    ` / `