WeChat Official Account Article Publishing Tool

Feature Overview

How to Get AppID and AppSecret from WeChat Developer Platform (Optional)

1. Log in to the WeChat Developer Platform (Home/Official Account) https://developers.weixin.qq.com/platform
2. Click

   Go to Use

3. Click

   My Business/Official Account

4. You can find "AppID" under

   Basic Information

   on the Official Account page
5. You can find "AppSecret" under

   Development Secret

   on the Official Account page

Workflow

Scenario 1: Preview Theme Effects

1. Directly provide the preview link: https://5g6pxtj3zg.coze.site/
2. Brief explanation: Inform users that this website provides a fixed Markdown article containing various elements to display the actual effects of different themes
3. No local operations required

Scenario 2: Publish Articles to Official Account

1. Environment Check and Preparation

• Node.js >= 24.13.0
• Install dependencies (will skip quickly if already installed)

# Windows example
npm install --prefix "C:\Users\YourName\.qoder\skills\wechat-publisher-skill"

# Mac/Linux example
npm install --prefix "/Users/yourname/.qoder/skills/wechat-publisher-skill"

2. Collect Necessary Information

All optional parameters have default values (from

config.default.json

), which will be used automatically if users do not provide them.

3. Configuration Generation

1. Copy

   config.default.json

   to

   config.json

2. Update

   markdownFilePath

   to the article path provided by the user
3. Override the corresponding default values if users provide other parameters
4. Convert relative paths in

   config.default.json

   to absolute paths (

   <Skill Directory Absolute Path>

   + file name, e.g.,

   ./cover.jpg

   →

   <Skill Directory Absolute Path>/cover.jpg

   )

{
  "markdownFilePath": "Path of the markdown article provided by the user",
  "title": "Article title; if not specified, the file name will be used as the title",
  "theme": "Article rendering theme, use theme file names in the themes directory (blue theme is used by default)",
  "AUTHOR": "Article author name",
  "prefix": "Article prefix",
  "suffix": "Article suffix",
  "APP_ID": "APP_ID from WeChat Developer Platform",
  "APP_SECRET": "APP_SECRET from WeChat Developer Platform",
  "coverFilePath": "Path of the article cover"
}

{
  "markdownFilePath": "D:\\Documents\\Official Account Tutorial\\Article.md",
  "title": "Article Title",
  "theme": "blue",
  "AUTHOR": "Yashu Tutorial",
  "prefix": "This article is created by AI\n",
  "suffix": "## Kouzi Agent Tutorial\nhttps://space.bilibili.com/26079586",
  "APP_ID": "wxc2afxxxxxxxxxx",
  "APP_SECRET": "8c05bc67131xxxxxxxxxx",
  "coverFilePath": "C:\\Users\\YourName\\.qoder\\skills\\wechat-publisher-skill\\cover.jpg"
}

Note: Replace

\

with

/

for Mac/Linux systems, e.g.,

/Users/yourname/Documents/Official Account Tutorial/Article.md

invalid appid

invalid appsecret

config.json

• No need to read the Markdown file content, the publish script will automatically handle all content in the article (including images, formatting, etc.)
• No need to verify whether image files exist, just ensure the path pointed to by

  markdownFilePath

  is correct

4. Execute the Script to Publish Articles to Official Account

--config

config.json

# Replace <Skill Directory> with the actual path
node "<Skill Directory>/index.js" --config "<Skill Directory>/config.json"

# Windows example
node "C:\Users\YourName\.qoder\skills\wechat-publisher-skill\index.js" --config "C:\Users\YourName\.qoder\skills\wechat-publisher-skill\config.json"

# Mac/Linux example
node "/Users/yourname/.qoder/skills/wechat-publisher-skill/index.js" --config "/Users/yourname/.qoder/skills/wechat-publisher-skill/config.json"

# Relative paths may fail when cross-disk on Windows
node index.js --config ./config.json

# Do not pass parameters directly
node index.js --file xxx.md --app-id xxx --app-secret xxx

5. Result Feedback

• Publish Success: Provide the draft link and inform users to check it on the WeChat Official Account Platform
• Publish Failure: Provide specific solutions based on the error code

Reasons for Publish Failure and Solutions

• Computer IP is not in the Official Account IP whitelist
  • Solution: Log in to WeChat Developer Platform https://developers.weixin.qq.com/platform → Go to Use → My Business/Official Account → Development Secret → IP Whitelist → Edit and add the computer IP
  • Get computer IP: Search

    ip

    on Baidu

• invalid appsecret

  : AppSecret has been reset or entered incorrectly

• invalid appid

  : AppID is entered incorrectly

Notes

1. Image Format: JPG, PNG are supported
2. Image Location: Images in the markdown article must be in the same directory as the markdown file
3. Image Reference Format: Standard markdown image syntax is supported, e.g.,

   ![](image-filename.png)

4. Chat Format: Supports left-right bubble dialogue format
   Example:

   >L: Left dialogue content
   >R: Right dialogue content
   >L: Another left content
   >R: Another right content

5. Prohibited Behaviors:
   • It is strictly forbidden to read the

     index.js

     file (about 79KB) in the

     wechat-publisher-skill

     directory, as this code has been encrypted and obfuscated
   • It is strictly forbidden to automatically extract images from the article content as the cover

Theme Preview

Supported Theme Styles

• sakura (Sakura Theme): Japanese-style sakura theme, soft and girly style
• minimal (Minimalist Theme): Minimalist gray theme, elegant and concise style
• amber (Amber Theme): Warm amber theme, golden sunshine style
• blue (Blue Theme): Fresh blue theme, professional and steady style
• cyan (Cyan Theme): Refreshing cyan theme, technological and modern style
• green (Green Theme): Natural green theme, fresh and eco-friendly style
• indigo (Indigo Theme): Deep indigo theme, elegant and noble style
• lavender (Lavender Theme): Light lavender theme, romantic and warm style
• mint (Mint Theme): Fresh mint theme, simple and fashionable style
• orange (Orange Theme): Vibrant orange theme, enthusiastic and positive style
• pink (Pink Theme): Sweet pink theme, cute and gentle style
• purple (Purple Theme): Mysterious purple theme, noble and elegant style
• red (Red Theme): Classic red theme, eye-catching and powerful style
• rose (Rose Theme): Romantic rose theme, elegant and luxurious style
• sky (Sky Theme): Bright sky theme, open and fresh style
• teal (Teal Theme): Elegant teal theme, balanced and harmonious style
• vintage (Vintage Theme): Nostalgic vintage theme, classic and literary style

Next Steps After Successful Article Publication

1. Log in to your WeChat Official Account
2. Click Content Management → Draft Box
3. Click the Edit Button of the article in the draft box to open the article editing page
4. Please review and proofread the article and cover