yy-post-to-wx

Features

• ✅ Supports three input formats: Markdown, HTML, plain text
• ✅ Four theme styles: default, grace, simple, modern
• ✅ Twelve preset colors, supports custom colors
• ✅ Automatically upload local images to WeChat material library
• ✅ External links are converted to bottom citations by default
• ✅ Configuration file supports default author and comment settings
• ✅ Direct upload via API, no browser automation required

Configuration

First-time Configuration

1. Obtain WeChat Official Account API credentials:
   • Visit https://mp.weixin.qq.com
   • Go to Development → Basic Configuration
   • Copy AppID and AppSecret
2. Save credentials to environment variables:
   • Project-level: Create

     .baoyu-skills/.env

     file
   • User-level: Create

     ~/.baoyu-skills/.env

     file

WECHAT_APP_ID=your_app_id
WECHAT_APP_SECRET=your_app_secret

1. Create configuration file

   EXTEND.md

   (optional):

default_theme: default
default_color: blue
default_author: Your Name
need_open_comment: 1
only_fans_can_comment: 0

Configuration Item Description

default_theme

default

default_color

default_author

need_open_comment

1

only_fans_can_comment

0

Theme Options

• default

  - Default theme, concise and elegant

• grace

  - Elegant style, larger line height

• simple

  - Minimalist style, removes borders and shadows

• modern

  - Modern style, card-based design

Color Presets

blue

green

vermilion

yellow

purple

sky

rose

olive

black

gray

pink

red

orange

#ff0000

Usage

# Using Bun
bun skills/yy-post-to-wx/scripts/main.ts <file> [options]

# Using npx bun
npx -y bun skills/yy-post-to-wx/scripts/main.ts <file> [options]

Parameter Options

<file>

article.md

--theme <name>

--theme grace

--color <color>

--color green

--title <title>

--title "Article Title"

--summary <text>

--summary "This is an article"

--author <name>

--author Zhang San

--cover <path>

--cover ./cover.png

--no-cite

--no-cite

Examples

# Publish Markdown file
bun skills/yy-post-to-wx/scripts/main.ts ./my-article.md --theme default --color blue

# Specify author and cover
bun skills/yy-post-to-wx/scripts/main.ts ./post.md --author "Baoyu" --cover ./imgs/cover.png

# Disable citation conversion
bun skills/yy-post-to-wx/scripts/main.ts ./article.md --no-cite

Workflow

1. Load Configuration - Load configuration from EXTEND.md and .env
2. Process Input - Read Markdown/HTML file, plain text is saved automatically
3. Parse Metadata - Extract title, author, summary, cover from frontmatter
4. Convert Format - Convert Markdown to WeChat-compatible HTML, apply theme styles
5. Get Token - Obtain access_token via API
6. Upload Images - Upload cover and body images, replace URLs
7. Create Draft - Call API to create draft in Official Account
8. Output Result - Display media_id and management link

Prerequisites

• Node.js 18+ or Bun
• WeChat Official Account AppID and AppSecret
• Official Account has developer permissions enabled
• Server IP has been added to API whitelist

Dependency Installation

Using Bun (Recommended)

bun skills/yy-post-to-wx/scripts/main.ts <file>

Using Node.js

cd skills/yy-post-to-wx/scripts
npm install
cd ../../..

Environment Check

bun skills/yy-post-to-wx/scripts/check-permissions.ts

• Bun runtime
• Environment variable configuration
• Whether API credentials exist

Dependencies

• marked

  - Markdown parsing

• front-matter

  - frontmatter parsing

Limitations

• Does not support browser automation publishing (API-only)
• Does not support multi-account management
• Image size must comply with WeChat Official Account restrictions