WeChat Official Account Draft Publisher

⚡ Quick Start

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

python publisher.py \
  --title "Title" \
  --content article.html \
  --author "Author Name" \
  --cover cover.png \
  --digest "Article Abstract"

• Author:

  YanG

• Cover image:

  cover.png

📋 Execution Steps

1. Locate HTML file
   • Prioritize looking for

     *_formatted.html

     (output from formatter)
   • Fall back to the latest

     .html

     file
2. Extract article title
   • Extract from HTML comment:

     <!-- Title: xxx -->

   • Extract from file name
   • Ask user for input if needed
3. Check cover image
   • Look for

     cover.png

   • Warn but continue publishing if missing
4. Call publishing script
   bash

   python publisher.py --title "xxx" --content xxx.html --cover xxx.png

5. Verify results
   • Confirm draft creation is successful
   • Obtain draft media_id
6. Notify user
   • Provide WeChat backend link
   • Explain next steps

🔧 Configuration Requirements

First-time Use

1. Obtain WeChat Official Account credentials
   • Visit https://mp.weixin.qq.com
   • Go to Settings → Basic Configuration
   • Copy AppID and AppSecret
2. Run the publisher
   bash

   python publisher.py --title "Test" --content test.html

3. Add server IP to whitelist (if required)

Configuration File

~/.wechat-publisher/config.json

{
  "appid": "wx1234567890abcdef",
  "appsecret": "your_secret_here"
}

✨ Core Features

• ✅ Automatic access_token caching (valid for 7200 seconds)
• ✅ Cover image upload and management
• ✅ Automatic HTML content optimization (adapted for WeChat)
• ✅ Automatic field length truncation (title/author/abstract)
• ✅ Error handling and retry mechanism
• ✅ Chinese error prompts and solutions
• ✅ Interactive mode and command-line mode

🛠️ Workflow Integration

1. wechat-tech-writer

   → Generate article (

   xxx_article.md

   +

   cover.png

   )

2. wechat-article-formatter

   → Format HTML (

   xxx_formatted.html

   )

3. wechat-draft-publisher

   → Publish to WeChat draft box (this skill)

• Automatically find

  *_formatted.html

  files
• Automatically find

  cover.png

  cover image
• Automatically identify content images

🚨 Common Issues

Error: IP not in whitelist

invalid ip not in whitelist

1. Log in to WeChat Official Account backend
2. Go to Settings → Basic Configuration
3. Add server IP to whitelist

Error: AppSecret error

AppSecret error

• Check configuration file:

  ~/.wechat-publisher/config.json

• Verify AppID starts with "wx" (18 characters)
• Confirm AppSecret is correct

Error: Title/author exceeds limit

title/author size out of limit

• The tool will automatically truncate (title: 32 bytes, author: 20 bytes)
• Modify

  publisher.py

  if adjustments are needed

📁 File Structure

wechat-draft-publisher/
├── SKILL.md                # This file
├── publisher.py            # Core publishing script
├── scripts/                # Utility scripts
│   ├── fix-wechat-style.py # HTML optimizer
│   ├── optimize-html.py    # HTML compression tool
│   ├── publish-workflow.sh # Complete workflow
│   ├── install.sh          # Installation assistant
│   └── test.sh             # Test script
├── examples/               # Sample files
│   ├── config.json.example # Configuration example
│   └── example.html        # HTML example
└── README.md               # Detailed English documentation

💡 Usage Examples

python publisher.py \
  --title "VSCode Renaming Incident" \
  --content article.html

python publisher.py \
  --title "Technical Article" \
  --content article.html \
  --author "YanG" \
  --cover images/cover.png \
  --digest "This is an article about..."

python publisher.py --interactive

📱 Post-Publishing Actions

1. Log in to WeChat Official Account backend
2. Go to "Draft Box"
3. Preview the effect
4. Publish after confirmation

• ⚠️ Drafts are saved in WeChat backend and will not be published immediately
• ⚠️ You can edit drafts in the draft box before publishing
• ⚠️ Cover images will be displayed during preview

🔗 Related Documents

• Detailed Documentation: README.md (English)
• Installation Guide: scripts/install.sh
• HTML Processing: scripts/fix-wechat-style.py