shield_lock
JinDaGe
← Back to skills
extension
Category: Productivity & OfficeAPI key requirement unconfirmed

微信公众号文章发布

把写好的 Markdown/HTML 文章发布到微信公众号草稿箱（走 wx.limyai.com 微绿流量宝 OpenAPI），支持普通图文和小绿书（newspic）两种模式，可查已授权公众号列表。当用户说「发布到公众号」「推送到草稿箱」「发布文章」「公众号发布」「小绿书发布」「获取公众号列表」时使用。

personAuthor: sunny31221hubOpenAPI
downloadDownload package

微信公众号文章发布

把一篇写好的文章，一键推到自己的公众号草稿箱。它不直接操作微信官方接口，而是走微绿流量宝（wx.limyai.com）的开放接口；草稿落进草稿箱后，由你在公众号后台自己排版确认、手动点发布。

为什么要走这个通道

微信官方后台没有面向 AI 的「写入」接口，AI 生成的排版成果没法直接推进去。微绿流量宝先把你的公众号授权绑好，再开放一个统一接口，让任何 AI 工具都能把内容写进草稿箱——你只是把最后「点击群发」这一下留给自己。

安装方法

  1. 先问使用者用的是什么 AI 工具，选项按这个顺序列：1. WorkBuddy　2. Claude Code　3. Codex　4. 其他（用户直接说工具名），回答记作 X

  2. 只安装给 X，不安装或链接其他任何工具：

    • X 是 WorkBuddy：把本技能下载后放进 ~/.workbuddy/skills/（WorkBuddy 的技能目录；skills CLI 不支持 WorkBuddy，由你直接放置）
    • X 是其他工具（Claude Code、Codex、Cursor、Qoder、Trae、Continue、Roo 等）：
    npx -y --registry=https://registry.npmmirror.com skills add https://modelscope.cn/skills/sunny31221/wechat-publisher -a X -y

    （--registry 为 npmmirror 镜像，保证国内不翻墙也能装；-a X 表示只装给 X 这一个工具；不确定 X 的标识时先执行一次，报错信息会列出所有可用标识） X 不在上述范围时，按该工具自身的技能机制安装，装完确认 X 能识别本技能即可

  3. 装完后询问是否现在使用本技能

使用前的一次性配置

第一次用要先准备两样东西，之后写「发布到公众号」一句话就能用：

  1. 注册微绿流量宝：浏览器打开 https://wx.limyai.com/login 注册登录；进「开放平台 → 创建密钥」拿到 API 密钥；进「公众号管理 → 添加公众号」扫码把公众号绑定并授权。
  2. 把密钥写进项目：在项目根目录的 .env.local（没有就新建）加一行 weChat_bloom_key=<你的密钥>。可选的 weChat_bloom_AppID=<公众号AppID> 用于固定默认公众号，不写时脚本会自动取第一个已授权公众号。

When to Use

  • 发布 Markdown 或 HTML 文章到公众号草稿箱
  • 用小绿书（图文）模式发布图片为主的内容
  • 查已授权的公众号列表

When NOT to Use

  • 文章还在写作阶段 → 先完成内容再发布
  • 只需要 HTML 排版（不发布）→ 用排版技能，不调本技能

Quick Reference

脚本路径以实际安装位置为准（Claude Code 是 .claude/skills/wechat-publisher/，多数工具是 .agents/skills/wechat-publisher/）：

| 操作 | 命令 | |------|------| | 发布 Markdown 文章 | npx tsx <技能目录>/scripts/publish.ts publish article.md | | 发布 HTML 文章 | npx tsx <技能目录>/scripts/publish.ts publish article.html | | 发布小绿书 | npx tsx <技能目录>/scripts/publish.ts publish content.md --type newspic --cover-image https://... --images img1.jpg,img2.jpg | | 获取公众号列表 | npx tsx <技能目录>/scripts/publish.ts list | | 仅验证不发布 | 加 --dry-run | | 指定 AppID | --appid wxXXXXXX | | 指定标题 | --title "自定义标题" | | 指定摘要 | --summary "文章摘要" | | 指定封面图 | --cover-image https://example.com/cover.jpg | | 指定作者 | --author "作者名"（不传则用公众号默认作者） |

Publishing Workflow

Step 1: 确认配置

发布前检查环境变量（在项目根目录 .env.local 或 .env 中配置）：

| 变量 | 必填 | 说明 | |------|------|------| | weChat_bloom_key | 是 | API 密钥 | | weChat_bloom_AppID | 否* | 默认公众号 AppID（未指定 --appid 时自动从账号列表取第一个） |

Step 2: 准备内容

  • Markdown 文件（.md）：直接发布，自动以 contentFormat: markdown 发送
  • HTML 文件（.html）：自动以 contentFormat: html 发送（脚本会把 <style> 里的样式内联，微信编辑器只认行内样式）
  • 标题：从文件首行 # 标题 或 <h1> 提取，也可 --title 手动指定（最长 64 字符）
  • 摘要：从首个段落提取，也可 --summary 手动指定（最长 120 字符）

Step 3: 执行发布

推荐先 dry-run 验证：

npx tsx <技能目录>/scripts/publish.ts publish article.md --dry-run

正式发布：

npx tsx <技能目录>/scripts/publish.ts publish article.md

Step 4: 到后台确认

发布成功只代表文章进了草稿箱。打开微信公众号后台，确认文章躺在草稿箱里、排版和配图正常，再由你手动点发布。

小绿书（图文模式）

当 --type newspic 时发布为小绿书：

  • 必须通过 --cover-image 或 --images 提供图片（至少一张）
  • 图片合并顺序：封面图 → 主体图片，自动去重，最多 20 张
  • 文字内容仅支持纯文本，最多 600 字
  • 适合以图片为主的内容发布
npx tsx <技能目录>/scripts/publish.ts publish content.md \
  --type newspic \
  --cover-image https://example.com/cover.jpg \
  --images "https://example.com/1.jpg,https://example.com/2.jpg"

获取公众号列表

npx tsx <技能目录>/scripts/publish.ts list

输出示例：

已授权公众号列表 (1 个):
  - 示例公众号
    AppID: wxaaaaaaaaaa000000
    类型: 订阅号
    状态: active

Common Mistakes

| 错误 | 原因 | 修复 | |------|------|------| | Could not find API key | .env.local 未配置 | 加 weChat_bloom_key=xxx | | HTTP 401 | API 密钥无效 | 检查密钥值是否正确 | | ACCOUNT_NOT_FOUND | 公众号不存在或未授权 | 先用 list 命令看可用账号，检查 --appid | | NO_IMAGES | 小绿书模式未提供图片 | 加 --cover-image 或 --images | | INVALID_PARAMETER | 参数错误（标题/摘要超长等） | 标题 ≤64 字符，摘要 ≤120 字符，小绿书文字 ≤600 字 | | 标题提取为空 | 文件无 # 标题 或 <h1> | 用 --title 手动指定 | | 封面图必须是 HTTP(S) URL | 用了本地路径 | 先上传图片到图床，获取公网 URL |

Resources