Wechat Public CLI Skill

Goal

Publish an Obsidian markdown article to WeChat Public Platform or Baidu Baijiahao using a local CLI.

Requirements

• Node.js 16+
• Config file or environment variables for credentials
• Markdown file with frontmatter (author, digest, banner or banner_path, thumb_media_id optional)

Article Template

---

title: "Test" author: Blake digest: Short summary banner: "https://image.png"

---

Install

git clone https://github.com/ai-chen2050/obsidian-wechat-public-platform.git
cd obsidian-wechat-public-platform
npm install

Or by clawdhub
claw install wechat-public-cli

Or install globally via npm:

npm install -g wechat-public-cli

If this CLI is published to npm, you can run it via npx without cloning:

npx wechat-public-cli wechat:draft --file /path/to/article.md

Config

Create a JSON file in the repo root named

wechat-public.config.json

:

{
	"wechat": {
		"appid": "YOUR_APP_ID",
		"secret": "YOUR_APP_SECRET",
		"accessToken": ""
	},
	"baidu": {
		"cookie": "YOUR_BJH_COOKIE",
		"token": "YOUR_BJH_TOKEN",
		"appId": "YOUR_BJH_APP_ID"
	},
	"paths": {
		"customCss": "./custom.css",
		"downloadDir": "./wechat-downloads"
	}
}

Env override:

• WECHAT_APPID

  ,

  WECHAT_SECRET

  ,

  WECHAT_ACCESS_TOKEN

• BJH_COOKIE

  ,

  BJH_TOKEN

  ,

  BJH_APP_ID

• WECHAT_CUSTOM_CSS

  ,

  WECHAT_PUBLIC_CONFIG

• WECHAT_DOWNLOAD_DIR

Build

npm run build:cli

Commands

• Create WeChat draft:

  wechat-public-cli wechat:draft --file /path/to/article.md
  # 使用自定义 CSS
  wechat-public-cli wechat:draft --file /path/to/article.md --css /path/to/tech.css
  

• Publish WeChat (from file):

  wechat-public-cli wechat:publish --file /path/to/article.md
  # 使用自定义 CSS
  wechat-public-cli wechat:publish --file /path/to/article.md --css /path/to/business.css
  

• Publish WeChat (from media_id):

  wechat-public-cli wechat:publish --media-id YOUR_MEDIA_ID
  

• Send to all WeChat followers:

  wechat-public-cli wechat:sendall --file /path/to/article.md
  

• Publish Baijiahao:

  wechat-public-cli bjh:publish --file /path/to/article.md
  # 使用自定义 CSS
  wechat-public-cli bjh:publish --file /path/to/article.md --css /path/to/custom.css
  

• Convert markdown to HTML:

  wechat-public-cli convert --file /path/to/article.md --platform wechat
  # 使用自定义 CSS
  wechat-public-cli convert --file /path/to/article.md --platform wechat --css /path/to/style.css
  

• Download recent N WeChat articles:

  wechat-public-cli wechat:download --count 10 --out-dir ./wechat-downloads
  

• Get cumulative user statistics:

  # 查询最近7天（默认）
  wechat-public-cli wechat:stats:cumulate
  # 指定日期范围（最多30天）
  wechat-public-cli wechat:stats:cumulate --begin-date 2025-11-01 --end-date 2025-11-07
  

• Get published content overview statistics:

  # 查询最近7天（默认）
  wechat-public-cli wechat:stats:bizsummary
  # 指定日期范围（最多30天）
  wechat-public-cli wechat:stats:bizsummary --begin-date 2025-11-01 --end-date 2025-11-07
  

使用自定义 CSS 样式

所有发布命令都支持通过

--css

参数指定自定义样式文件：

# 使用技术类文章样式
wechat-public-cli wechat:draft --file tech-article.md --css ./styles/tech.css

# 使用营销类文章样式
wechat-public-cli wechat:publish --file marketing.md --css ./styles/marketing.css

# 使用教程类文章样式
wechat-public-cli bjh:publish --file tutorial.md --css ./styles/tutorial.css

自定义公众号格式

你可以通过定义和修改 CSS 文件，来调整发布到微信公众号的文章样式。支持为不同类型的文章使用不同的样式文件。

CSS 文件加载优先级

1. 命令行参数

   --css

   （最高优先级）
2. 配置文件

   wechat-public.config.json

   中的

   paths.customCss

3. 默认文件 当前目录下的

   custom.css

4. 空样式 如果以上都不存在，则不应用自定义样式

使用场景示例

1. 使用默认样式

在项目根目录创建

custom.css

，不传任何参数时自动使用：

wechat-public-cli wechat:publish --file article.md

2. 为不同类型文章使用不同样式

创建多个 CSS 文件，通过

--css

参数指定：

# 技术类文章使用 tech.css
wechat-public-cli wechat:publish --file tech-article.md --css ./styles/tech.css

# 商业类文章使用 business.css
wechat-public-cli wechat:publish --file business-article.md --css ./styles/business.css

# 教程类文章使用 tutorial.css
wechat-public-cli wechat:publish --file tutorial.md --css ./styles/tutorial.css

3. 在配置文件中指定默认样式

在

wechat-public.config.json

的

paths.customCss

字段指定默认样式文件路径：

{
	"paths": {
		"customCss": "./styles/default.css"
	}
}

这样不传

--css

参数时，会使用配置文件中指定的样式。

CSS 示例

/* tech.css - 技术文章样式 */
.wechat-title {
	font-size: 2em;
	color: #2c3e50;
	font-family: "Monaco", "Consolas", monospace;
}
.wechat-banner {
	border-radius: 8px;
}
code {
	background-color: #f4f4f4;
	padding: 2px 4px;
}

/* business.css - 商业文章样式 */
.wechat-title {
	font-size: 2.2em;
	color: #c7254e;
	font-family: "Arial", "Helvetica", sans-serif;
}

AI 也可通过自动生成或修改 CSS 文件，实现对公众号内容格式的智能优化。

Notes

• WeChat draft requires

  thumb_media_id

  or

  banner

  /

  banner_path

  in frontmatter.
• Baijiahao publish requires

  banner

  or

  banner_path

  in frontmatter.
• The CLI uploads inline images to the target platform automatically.

• wechat:download

  saves recent articles in update_time order and writes all

  news_item

  entries.

• wechat:stats:cumulate

  /

  wechat:stats:bizsummary

  must be called server-side; the date range can be at most 30 days. Results are printed as JSON to stdout.