wechat-draft-publisher

Original：🇨🇳 Chinese

Translated

6 scripts

Automatically publish HTML articles to WeChat Official Account draft box (Crayfish Adaptation Version). Automatically guide users to configure IP whitelist for first-time use. Trigger when users say "Push to WeChat", "Publish to Official Account", or "Upload Draft".

2installs

Sourcebnd-1/wechat_article_mini

Added on2026-05-03

NPX Install

npx skill4agent add bnd-1/wechat_article_mini wechat-draft-publisher

SKILL.md Content (Chinese)

View Translation Comparison →

WeChat Official Account Draft Publisher (Crayfish Express Version)

Core Concept: Guide configuration on first use, one-click publishing afterwards

Prerequisite: Install Dependencies

Before each use, ensure dependencies are installed (idempotent operation, can be executed repeatedly):

bash

pip3 install -r skills/wechat-draft-publisher/requirements.txt

First-time Use: Guided Configuration

Step 1: Query IP and Notify User

Query IP for users when using for the first time or encountering IP whitelist errors:

bash

python publisher.py --query-ip

This will automatically query the public IP and display:

>>> Your public IP is: x.x.x.x

Please add this IP to the WeChat Official Account backend:
1. Log in to https://developers.weixin.qq.com/platform
2. Settings & Development → Basic Configuration → IP Whitelist
3. Add IP: x.x.x.x

Tell the user:

Two configurations are required for first-time use:

1. IP Whitelist: I have found your server IP is x.x.x.x
   Please log in to the WeChat Official Account backend, and add this IP in Settings & Development→Basic Configuration→IP Whitelist

2. AppID and AppSecret:
   Copy AppID and AppSecret from the same page (Basic Configuration)
   The publishing tool will automatically guide you to fill them in when running

Let me know once configured, and I will help you publish!

Step 2: Run the Publisher (Automatically Guide Credential Input)

bash

python publisher.py --title "Article Title" --content article.html

The first run will automatically prompt you to enter AppID and AppSecret.

Normal Publishing Process (After Configuration)

One-click Publishing

bash

python publisher.py \
  --title "Article Title" \
  --content xxx_formatted.html \
  --cover cover.png \
  --author "Crayfish"

Automatic Execution Steps

Find HTML File: Prioritize
```
*_formatted.html
```
, fall back to the latest
```
.html
```
Extract Title: From HTML comments or file name
Find Cover Image:
```
cover.png
```
Call Publishing: Upload cover → Upload content images → Create draft
Return Result: Display media_id, prompt to check in backend

Prompt After Successful Publishing

✅ Article has been pushed to the draft box!

Next steps:
1. Log in to https://developers.weixin.qq.com/platform
2. Enter "Draft Box"
3. Preview the effect, then publish after confirmation

⚠️ Drafts will not be published automatically, you can edit them in the backend before publishing

Quick Troubleshooting

Error	Cause	Solution
`invalid ip not in whitelist`	IP is not in whitelist	Run `python publisher.py --query-ip` to check IP and add it
`AppSecret error`	Invalid credential	Check `~/.wechat-publisher/config.json`
`title size out of limit`	Title is too long	The tool will automatically truncate it, no manual handling needed
`api function not authorized`	Official Account type does not support	Authenticated service account is required

Configuration File Location

~/.wechat-publisher/config.json

json

{
  "appid": "xxx",
  "appsecret": "xxx"
}

Complete Workflow Integration

Write article(tech-writer/pm-writer) → Format beautification(formatter) → Push to WeChat(this skill)

Users only need to say three sentences:

"Write an article about XXX"
"Beautify the article"
"Push to WeChat"

wechat-draft-publisher

NPX Install

Tags

SKILL.md Content (Chinese)

WeChat Official Account Draft Publisher (Crayfish Express Version)

Core Concept: Guide configuration on first use, one-click publishing afterwards

Prerequisite: Install Dependencies

First-time Use: Guided Configuration

Step 1: Query IP and Notify User

Step 2: Run the Publisher (Automatically Guide Credential Input)

Normal Publishing Process (After Configuration)

One-click Publishing

Automatic Execution Steps

Prompt After Successful Publishing

Quick Troubleshooting

Configuration File Location

Complete Workflow Integration