Agent skill

Wechat Mp Publish

by tsingyuai in tsingyuai/growth-lab

通过微信公众号官方 API 把公众号文章生产单元渲染为微信排版 HTML、生成阅读页预览、上传封面与正文图片并创建草稿;在三重确认下提交发布并查询状态。支持本机直连与固定 IP 远程发布服务两种模式。用户要求预览公众号、同步微信草稿、发布公众号或查询发布状态时使用。

Apache-2.0Auto-check: notesProductivity & Automation

Install Wechat Mp Publish

skills CLI
$ npx skills add tsingyuai/growth-lab --skill wechat-mp-publish -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install tsingyuai/growth-lab wechat-mp-publish --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/tsingyuai/growth-lab.git skills-src && mkdir -p .claude/skills && cp -r skills-src/executors/wechat-mp-publish .claude/skills/wechat-mp-publish && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
wechat-mp-publish
GitHub stars
2k
Token cost
~797 tokens
SKILL.md length
154 words
Files
12 (incl. scripts, references)
Skills in repo
22
Repo updated
First seen
Licence
Apache-2.0

At a glance

通过微信公众号官方 API 把公众号文章生产单元渲染为微信排版 HTML、生成阅读页预览、上传封面与正文图片并创建草稿;在三重确认下提交发布并查询状态。支持本机直连与固定 IP 远程发布服务两种模式。用户要求预览公众号、同步微信草稿、发布公众号或查询发布状态时使用。

  • Works in 3 steps: 预览(每次都做) → 创建草稿(默认终点) → 受控发布(仅在用户明确要求时)
  • Tasks that involve Messaging and chat bots
  • SKILL.md covers 前置, 1. 预览(每次都做), 2. 创建草稿(默认终点) and 3. 受控发布(仅在用户明确要求时), plus 2 more sections
  • Runs Python scripts from its folder; calls make; needs WECHAT_MP_APP_SECRET and WECHAT_PUBLISH_SERVICE_TOKEN

What it does

Wechat Mp Publish is an agent skill from tsingyuai/growth-lab. 通过微信公众号官方 API 把公众号文章生产单元渲染为微信排版 HTML、生成阅读页预览、上传封面与正文图片并创建草稿;在三重确认下提交发布并查询状态。支持本机直连与固定 IP 远程发布服务两种模式。用户要求预览公众号、同步微信草稿、发布公众号或查询发布状态时使用。

Its SKILL.md is about 800 tokens, which your agent loads only when the skill is triggered. The skill folder holds 15 other files, including scripts and reference files (for example `agents/openai.yaml`, `deploy/docker-compose.yml` and `references/api.md`).

It sits in Productivity & Automation, covering Messaging and chat bots. It works with WeChat. The repository describes itself as: An end-to-end growth tool that understands the product, fetch the data it needs, researches the market, executes campaigns, and reviews results to improve the next round of… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Messaging and chat bots

Example prompts

  • “/wechat-mp-publish”

Requirements

  • Python 3
  • A credential in WECHAT_MP_APP_SECRET
  • A credential in WECHAT_PUBLISH_SERVICE_TOKEN

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. 预览(每次都做)
  2. 创建草稿(默认终点)
  3. 受控发布(仅在用户明确要求时)

What it can do on your machine

Read from SKILL.md and the folder at commit 2d0807c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 5 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • make

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • WECHAT_MP_APP_SECRET
    • WECHAT_PUBLISH_SERVICE_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Wechat Mp Publish loads about 797 tokens when it runs, and up to ~2.1k if it reads all its reference files. Until then it costs about 38 tokens; SKILL.md has 154 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~38
When it runs · the whole SKILL.md, loaded when a task matches
~797
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:37
    凭据只从进程环境或根目录 `.env.local` / `.env` 读取;不得回显、写入产物或 Memory。
  • NoteMentions a .env fileSKILL.md:63
    CHAT_ENABLE_AUTO_PUBLISH=true`(远程模式在服务器 `.env`)
  • NoteMentions a .env fileSKILL.md:95
    - 不把 `.env`、AppSecret、access_token 或服务 token 写入产物、日志或 Memory。

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from tsingyuai/growth-lab at commit 2d0807c, republished under its Apache-2.0 licence (© tsingyuai). 154 words, ~797 tokens.

Download SKILL.mdSave it as .claude/skills/wechat-mp-publish/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.
name
wechat-mp-publish
description
通过微信公众号官方 API 把公众号文章生产单元渲染为微信排版 HTML、生成阅读页预览、上传封面与正文图片并创建草稿;在三重确认下提交发布并查询状态。支持本机直连与固定 IP 远程发布服务两种模式。用户要求预览公众号、同步微信草稿、发布公众号或查询发布状态时使用。

微信公众号草稿与受控发布

scripts/ 是仓库自带的零依赖 Python Client(仅用标准库),只调用微信官方接口,见 api.md。输入是 wechat-article-compose 产出的生产单元:

text
<post-dir>/
├── article.md        # 必需
├── wechat.yml        # 必需
├── cover.png         # 创建草稿时必需(cover 字段可改名)
└── assets/           # 正文图片,可选

渲染器支持 wechat.yml 的 theme(主题名,或 base 加 accent / text / background / link / ink / tint / muted / line / generic 颜色覆盖,值可写 #RRGGBB)以及正文排版块 ::: card / steps / stats / bars / figure,语法见 wechat-article-compose。内置主题:default、white-accent(白底、中性灰,只用强调色点缀)。品牌色写成覆盖项:

yaml
theme:
  base: white-accent
  accent: "#2C3E8C"
  link: "#2C3E8C"

运行后在同一目录写入 preview.html、article.html、payload.json、publish-state.json。

前置

依赖缺失时触发统一的 onboard-growth-lab,本 Skill 不自行维护配置流程。

  • 本机直连:WECHAT_MP_APP_ID / WECHAT_MP_APP_SECRET,且本机公网出口 IP 已加入公众号后台 API IP 白名单。
  • 远程服务(推荐团队使用):本机只配 WECHAT_PUBLISH_SERVICE_URL / WECHAT_PUBLISH_SERVICE_TOKEN;AppSecret 只放在固定 IP 服务器上,部署见 remote-service.md。
  • 账号主体必须具备草稿与发布接口权限:个人主体、未认证企业主体等账号的发布接口可能已被回收,报 api unauthorized 时说明无法自动化,改为人类协作发布。

凭据只从进程环境或根目录 .env.local / .env 读取;不得回显、写入产物或 Memory。

1. 预览(每次都做)

bash
make wechat-preview POST=<post-dir>     # 生成并打开 preview.html
make wechat-render POST=<post-dir>      # article.html + dry-run payload.json

用真实浏览器检查 preview.html:标题、作者、摘要、首屏卡片、小标题节奏、图片居中与清晰度、CTA 链接。发现问题回到 article.md 修改后重新渲染。article.html 是草稿与预览共用的唯一正文,修改 article.md 后必须重新 render。

2. 创建草稿(默认终点)

bash
make wechat-draft POST=<post-dir>          # 本机直连
make wechat-remote-draft POST=<post-dir>   # 远程服务

两者都先跑 check-wechat-compliance.py,未通过即阻断。流程:上传封面为永久素材 → 上传正文本地图片并替换为微信图片 URL → 新建草稿 → 写 publish-state.json 的 draft_media_id。正文外链图片会被拒绝,改用 assets/ 本地图片;正文仍含 ::: figure 配图位时同样拒绝,先换成真实图片再 render。

创建成功后请用户在公众号后台预览草稿;这是人工把关点,不跳过。

3. 受控发布(仅在用户明确要求时)

必须同时满足三重确认,缺任一项就停下说明原因:

  1. 环境变量 WECHAT_ENABLE_AUTO_PUBLISH=true(远程模式在服务器 .env)
  2. 该篇 wechat.yml 中 publish.approved: true
  3. 命令显式带 --confirm-publish(Make 目标已内置)
bash
make wechat-publish POST=<post-dir>
make wechat-remote-publish POST=<post-dir>   # 会把本地 wechat.yml 审批状态同步到远端

发布是异步的。用 status 查询并落盘 publish_id、article_id、article_url:

bash
make wechat-status POST=<post-dir>
make wechat-remote-status POST=<post-dir>

不满足自动发布条件时,走人类协作发布:交付草稿 media_id、预览路径与操作说明,请用户在后台发布后回传文章 URL。

失败处理

信号处理
invalid credential / 40001检查 AppSecret、IP 白名单;token 缓存在 ~/.growth-lab/wechat/,可删除后重试
invalid ip / 40164把调用机器公网出口 IP 加入白名单,或改用远程服务
api unauthorized / 48001账号主体无接口权限,改人类协作发布
图片上传失败检查格式(jpg/png)、大小(正文图 ≤1MB,封面 ≤10MB)与路径
草稿成功、发布失败保留 draft_media_id,请用户到后台检查后人工发布

红线

  • 不删除已发布文章,不批量发布,不跳过草稿预览。
  • 不修改 wechat.yml 的 publish.approved 替用户审批。
  • 不把 .env、AppSecret、access_token 或服务 token 写入产物、日志或 Memory。

© tsingyuai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 11 other files (scripts, references) in executors/wechat-mp-publish of tsingyuai/growth-lab.

  • SKILL.md
  • agents/openai.yaml
  • deploy/Dockerfile
  • deploy/docker-compose.yml
  • deploy/server.env.example
  • references/api.md
  • references/remote-service.md
  • scripts/cli.py
  • scripts/client.py
  • scripts/payload_builder.py
  • scripts/remote_client.py
  • scripts/server.py

Open the folder on GitHubat commit 2d0807c

Compare with similar skills

Wechat Mp Publish next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Wechat Mp Publish compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Wechat Mp Publish this skilltsingyuai/growth-lab2k—~797Automated safety check: NotesApache-2.0
She Love Me863401402/she-love-me9311 repos~1.3kAutomated safety check: PassMIT
Wechat Article Extractorfreestylefly/wechat-article-extractor-skill1361 repos~1kAutomated safety check: PassNone
Wechat Miniprogram Builderchenjin-cmd/wechat-miniprogram-builder356—~634Automated safety check: PassMIT
Skill Wechat PublisherZJU-REAL/Easel3.4k—~1.8kAutomated safety check: PassApache-2.0
Wechat Mp Writerth3ee9ine/wechat-claw-skill207—~1.4kAutomated safety check: PassMIT

Similar skills

  • She Love Me

    863401402/she-love-me

    Acquire, import, and analyze WeChat or QQ chat histories, including installing supported exporters, guiding required login or contact selection, converting exports, assessing relationship dynamics…

    931 GitHub starsUsed in 1 repo~1.3k tokens
    Productivity & AutomationAuto-check passed
  • Wechat Article Extractor

    freestylefly/wechat-article-extractor-skill

    Extract metadata and content from WeChat Official Account articles.

    136 GitHub starsUsed in 1 repo~1k tokens
    Productivity & AutomationAuto-check passed
  • Wechat Miniprogram Builder

    chenjin-cmd/wechat-miniprogram-builder

    This skill should be used when the user wants to build, launch, monetize, or promote a WeChat mini-program with AI (vibe coding) — including topic selection, account registration & ICP filing…

    356 GitHub stars~634 tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • 微信公众号文章自动创作与发布工具。给定参考文章、文字或文档,自动搜索整理全网相关信息、生成图文并茂的公众号文章,并发布到微信公众号草稿箱。特别强调反 AI 检测写作。

    3.4k GitHub stars~1.8k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Wechat Mp Writer

    th3ee9ine/wechat-claw-skill

    微信公众号文章全自动写作与发布。从信息搜集、AI配图规划、报刊级 HTML 排版、到草稿创建和发布的完整流程。适用于 AI 日报、财经周报、深度分析、新闻资讯类文章。内置多种模板,并提供本地渲染、校验、图片规划和发布流水线脚本。

    207 GitHub stars~1.4k tokensUpdated 6 mo ago
    Productivity & AutomationAuto-check passed
  • Qiaomu Wx Video

    joeseesun/qiaomu-wx-video

    Qiaomu skill and workflow for downloading a WeChat Channels / 视频号 video or generated live replay when the user provides a weixin.qq.com/sph share link.

    135 GitHub stars~751 tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed

More from tsingyuai/growth-lab

All 22 skills in this repo
  • Screenshot Assets

    tsingyuai/growth-lab

    Capture authenticated product screenshots through the repository-owned Playwright CDP script and archive them in the invoking loop's Memory.

    2k GitHub stars~583 tokensUpdated 12 days ago
    Auto-check passed
  • Media Crawler

    tsingyuai/growth-lab

    Install, authenticate, configure, operate, and troubleshoot the external MediaCrawler client shared by Douyin, Kuaishou, Bilibili, Weibo, Tieba, and Zhihu collectors.

    2k GitHub stars~731 tokensUpdated 12 days ago
    Auto-check passed
  • Run SEO Page Loop

    tsingyuai/growth-lab

    Run an SEO page observation-action-review loop with persistent Memory by coordinating demand research, page creation, adversarial review, image generation, IndexNow submission, and performance review.

    2k GitHub stars~1.2k tokensUpdated 12 days ago
    Auto-check passed
  • Wechat Article Compose

    tsingyuai/growth-lab

    把一个已确认的选题写成微信公众号长文。锁定复刻锚与用户价值、写出 article.md / wechat.yml / review.md,并通过公众号通用合规检查和人工预览前自检。准备、改写或核验公众号文章时使用;不负责发布,也不产出小红书卡片。

    2k GitHub stars~860 tokensUpdated 12 days ago
    Auto-check passed
  • Xhs Render Cards

    tsingyuai/growth-lab

    把已批准的小红书草稿、单一分析参考和真实产品素材变成可审查卡片:先完成 DAI 与 image plan,再按确定性、完整效果或可分离图层模式制作,机械验证 PNG 与清单并运行合规检查。精确文字和真实 UI 不交给模型猜测;AI 生图需要单独配置和授权。

    2k GitHub stars~1k tokensUpdated 12 days ago
    Auto-check passed
  • Xiaohongshu MCP

    tsingyuai/growth-lab

    使用本机 browser-first xiaohongshu-mcp 只读搜索小红书、下载候选首图、补全用户选择的笔记详情,并把脱敏证据写入调用方 Memory。用于 xhs-replicate 的选题和视觉参考研究,取代小红书 MediaCrawler 路径。

    2k GitHub stars~822 tokensUpdated 12 days ago
    Auto-check passed

Works with

Questions about Wechat Mp Publish

What does Wechat Mp Publish do?

通过微信公众号官方 API 把公众号文章生产单元渲染为微信排版 HTML、生成阅读页预览、上传封面与正文图片并创建草稿;在三重确认下提交发布并查询状态。支持本机直连与固定 IP 远程发布服务两种模式。用户要求预览公众号、同步微信草稿、发布公众号或查询发布状态时使用。. Wechat Mp Publish is an agent skill from tsingyuai/growth-lab.

When should I use Wechat Mp Publish?

Wechat Mp Publish fits situations like: tasks that involve Messaging and chat bots.

How do I install Wechat Mp Publish in Claude Code?

Run `npx skills add tsingyuai/growth-lab --skill wechat-mp-publish -a claude-code`. Or copy the skill folder (executors/wechat-mp-publish in tsingyuai/growth-lab) into .claude/skills/wechat-mp-publish in your project. Claude Code loads it when a task matches its description.

How do I install Wechat Mp Publish in Codex?

Run `npx skills add tsingyuai/growth-lab --skill wechat-mp-publish -a codex`. Or copy the skill folder (executors/wechat-mp-publish in tsingyuai/growth-lab) into .agents/skills/wechat-mp-publish in your project. Codex loads it when a task matches its description.

Can I use Wechat Mp Publish in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add tsingyuai/growth-lab --skill wechat-mp-publish -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wechat-mp-publish, .gemini/skills/wechat-mp-publish, .github/skills/wechat-mp-publish and .opencode/skills/wechat-mp-publish in your project.

What does Wechat Mp Publish need to run?

Going by SKILL.md and its folder, Wechat Mp Publish needs Python for the scripts in its folder, the command-line tools its instructions call (make) and credentials named WECHAT_MP_APP_SECRET and WECHAT_PUBLISH_SERVICE_TOKEN. Our summary lists: Python 3; A credential in WECHAT_MP_APP_SECRET; A credential in WECHAT_PUBLISH_SERVICE_TOKEN.

Does Wechat Mp Publish access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Wechat Mp Publish safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Wechat Mp Publish use?

Wechat Mp Publish is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Wechat Mp Publish use?

About 797 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.3k tokens, read only when the agent opens those files.

What are the alternatives to Wechat Mp Publish?

Skills that share tags, products or a category with Wechat Mp Publish: She Love Me (863401402/she-love-me, 931 stars), Wechat Article Extractor (freestylefly/wechat-article-extractor-skill, 136 stars), Wechat Miniprogram Builder (chenjin-cmd/wechat-miniprogram-builder, 356 stars) and Skill Wechat Publisher (ZJU-REAL/Easel, 3.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wechat Mp Publish?

tsingyuai (a GitHub organization) maintains it in tsingyuai/growth-lab, which has 2,000 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on September 28, 2026.

Source: tsingyuai/growth-lab on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.