SuperAPI AI 工具集

canghe-post-to-wechat

营销与增长

查看项目

更新于 10-15 11:55

技能介绍

用途

canghe-post-to-wechat 用于将内容发布到微信公众号(WeChat Official Account)。它支持两种发布方式:通过微信公众号 API 发布,或通过 Chrome CDP(浏览器)发布。内容类型包括文章(文章)和图文(图文)短帖。

主要能力

  • 文章发布:支持 HTML、Markdown 或纯文本输入,可通过 API 或浏览器方式发布。
  • 图文发布:支持带多张图片的短帖,最多 9 张图片。
  • Markdown 转 HTML:依赖 canghe-markdown-to-html 技能进行转换,支持 default、grace、simple 三种主题。
  • 元数据校验:检查标题、摘要、作者、封面图等字段,缺失时可自动生成或提示补充。
  • 评论控制:支持 need_open_comment(默认 1)和 only_fans_can_comment(默认 0)两个开关。
  • 环境检查:提供 check-permissions.ts 脚本,检查 Chrome、Bun、剪贴板、API 凭证等环境项。
  • 配置扩展:通过 EXTEND.md 设置默认主题、默认发布方式、默认作者、评论开关、Chrome 配置路径等。

使用方式

脚本目录以 SKILL_DIR 表示,脚本包括:

  • scripts/wechat-browser.ts:图文发布
  • scripts/wechat-article.ts:通过浏览器发布文章
  • scripts/wechat-api.ts:通过 API 发布文章
  • scripts/check-permissions.ts:验证环境与权限

环境检查(可选):

npx -y bun ${SKILL_DIR}/scripts/check-permissions.ts

图文发布示例:

npx -y bun ${SKILL_DIR}/scripts/wechat-browser.ts --markdown article.md --images ./images/
npx -y bun ${SKILL_DIR}/scripts/wechat-browser.ts --title "标题" --content "内容" --image img.png --submit

文章发布(API):

npx -y bun ${SKILL_DIR}/scripts/wechat-api.ts <html_file> [--title <title>] [--summary <summary>] [--author <author>] [--cover <cover_path>]

文章发布(浏览器):

npx -y bun ${SKILL_DIR}/scripts/wechat-article.ts --html <html_file>

文章发布流程包含 7 个步骤:加载偏好(EXTEND.md)、确定输入类型、检查 markdown-to-html 技能、转换为 HTML、校验元数据、选择发布方式并配置凭证、发布到微信、报告完成。

EXTEND.md 配置查找优先级:项目级 .canghe-skills/canghe-post-to-wechat/EXTEND.md,然后用户级 $HOME/.canghe-skills/canghe-post-to-wechat/EXTEND.md。若未找到则运行首次设置。

EXTEND.md 支持的键(大小写不敏感,接受 1/0 或 true/false):

  • default_author(默认空)
  • need_open_comment(默认 1)
  • only_fans_can_comment(默认 0)
  • default_theme
  • default_publish_method(api/browser)
  • chrome_profile_path

值优先级:CLI 参数 > Frontmatter > EXTEND.md > 技能默认值。

API 凭证配置:在 .canghe-skills/.env 中设置 WECHAT_APP_ID 和 WECHAT_APP_SECRET。凭证可从 https://mp.weixin.qq.com 的「开发 → 基本配置」获取。

适用场景

  • 需要将 Markdown 或 HTML 文章发布到微信公众号草稿箱。
  • 需要发布带多张图片的图文短帖。
  • 希望通过 API 快速发布,或通过浏览器方式发布。
  • 需要统一管理默认作者、评论开关、主题等发布偏好。

限制

  • 图文发布不支持纯文本输入、HTML 输入、主题、自动生成元数据、默认封面回退、评论控制,且需要 Chrome。
  • 文章 API 方式需要 API 凭证,不需要 Chrome;浏览器方式需要 Chrome 和登录会话,速度较慢。
  • Markdown 转换需要安装 markdown-to-html 技能(如 canghe-markdown-to-html),未安装时会提示安装。
  • 文章类型为 news 时封面图必填,缺失时会停止并请求提供封面图。
  • 环境检查项失败时需按对应指引修复(如安装 Chrome、Bun、xdotool 等)。
  • 具体收费、价格、平台支持范围等资料暂未提供。