WeChat CLI

微信公众平台 CLI 工具，提供公众号的完整管理功能。

Installation

方式一：通过 npm 安装（推荐）

# 全局安装
npm install -g season-wx-cli

# 或者使用 npx 直接运行（无需安装）
npx season-wx-cli --help

方式二：从源代码安装

# 克隆仓库
git clone https://github.com/seasonHL/wechat-cli
cd wechat-cli

# 安装依赖
npm install

# 构建项目
npm run build

# 全局链接（可选）
npm link

# 运行
season-wx-cli --help

Quick Start

# 配置初始化
season-wx-cli config --set --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET

# 查看当前配置
season-wx-cli config --get

# 获取 Access Token
season-wx-cli account --action token

# 查看帮助
season-wx-cli account --help

Core Features

1. 素材管理 (Material Management)

# 获取素材数量
season-wx-cli account --action material-count

# 获取素材列表
season-wx-cli account --action material-list --material-type image
season-wx-cli account --action material-list --material-type voice
season-wx-cli account --action material-list --material-type video
season-wx-cli account --action material-list --material-type news

# 获取单个素材
season-wx-cli account --action material-get --media-id MEDIA_ID

# 删除素材
season-wx-cli account --action material-delete --media-id MEDIA_ID

2. 草稿管理 (Draft Management)

# 获取草稿数量
season-wx-cli account --action draft-count

# 获取草稿列表
season-wx-cli account --action draft-list

# 获取草稿详情
season-wx-cli account --action draft-get --media-id MEDIA_ID

# 创建草稿
season-wx-cli account --action draft-create --draft-data '[
  {
    "title": "文章标题",
    "author": "作者",
    "digest": "摘要",
    "content": "<p>文章内容</p>",
    "thumb_media_id": "缩略图ID",
    "show_cover_pic": 1
  }
]'

# 更新草稿
season-wx-cli account --action draft-update --media-id MEDIA_ID --index 0 --draft-data '{...}'

# 删除草稿
season-wx-cli account --action draft-delete --media-id MEDIA_ID

3. 发布能力 (Publish Management)

# 发布草稿
season-wx-cli account --action publish-draft --media-id MEDIA_ID

# 获取发布状态
season-wx-cli account --action publish-status --msg-id PUBLISH_ID

# 获取已发布消息列表
season-wx-cli account --action publish-list
season-wx-cli account --action publish-list --offset 0 --count 10 --no-content

# 获取已发布图文信息
season-wx-cli account --action publish-article --article-id ARTICLE_ID [--index 0]

4. 留言管理 (Comment Management)

# 打开文章评论
season-wx-cli account --action comment-open --msg-id MSG_ID [--index 0]

# 关闭文章评论
season-wx-cli account --action comment-close --msg-id MSG_ID [--index 0]

# 获取评论列表
season-wx-cli account --action comment-list --msg-id MSG_ID [--index 0] [--begin 0] [--count 10] [--type 0]

# 标记精选评论
season-wx-cli account --action comment-mark --msg-id MSG_ID --comment-id COMMENT_ID [--index 0]

# 取消精选评论
season-wx-cli account --action comment-unmark --msg-id MSG_ID --comment-id COMMENT_ID [--index 0]

# 删除评论
season-wx-cli account --action comment-delete --msg-id MSG_ID --comment-id COMMENT_ID [--index 0]

# 回复评论
season-wx-cli account --action comment-reply --msg-id MSG_ID --comment-id COMMENT_ID --content "回复内容" [--index 0]

# 删除评论回复
season-wx-cli account --action comment-reply-delete --msg-id MSG_ID --comment-id COMMENT_ID --reply-id REPLY_ID [--index 0]

5. 用户管理 (User Management)

# 获取用户列表
season-wx-cli account --action user

# 获取指定用户信息
season-wx-cli account --action user --openid OPEN_ID

# 批量获取用户信息
season-wx-cli account --action batch-user --openid-list "openid1,openid2,openid3"

# 设置用户备注
season-wx-cli account --action remark-user --openid OPEN_ID --remark "备注名"

6. 标签管理 (Tag Management)

# 获取标签列表
season-wx-cli account --action tag

# 创建标签
season-wx-cli account --action tag --tag-name "新标签"

# 更新标签
season-wx-cli account --action tag-update --tag-id 1 --tag-name "新名称"

# 删除标签
season-wx-cli account --action tag-delete --tag-id 1

# 获取标签下用户
season-wx-cli account --action tag-user --tag-id 1

7. 菜单管理 (Menu Management)

# 获取菜单
season-wx-cli account --action menu

# 删除菜单
season-wx-cli account --action menu-delete

8. 消息发送 (Message Sending)

# 发送客服文本消息
season-wx-cli account --action message --openid OPEN_ID --content "消息内容"

# 发送模板消息
season-wx-cli account --action template --touser OPEN_ID --template-id TEMPLATE_ID --url "https://example.com" --data '{"first":{"value":"您好"},"keyword1":{"value":"内容"}}'

9. 二维码 (QR Code)

# 创建临时二维码
season-wx-cli account --action qrcode --scene-id 123

# 创建永久二维码（数字）
season-wx-cli account --action qrcode-limit --scene-id 123

# 创建永久二维码（字符串）
season-wx-cli account --action qrcode-str --scene-str "scene_string"

10. 群发消息 (Mass Messaging)

# 群发文本（全部用户）
season-wx-cli account --action mass --content "群发内容" --to-all

# 群发文本（指定标签）
season-wx-cli account --action mass --content "群发内容" --tag-id-for-mass 1

# 查看群发状态
season-wx-cli account --action mass-status --msg-id MSG_ID

11. 其他工具

# 获取微信服务器IP
season-wx-cli account --action server-ip

# 切换备用域名
season-wx-cli account --action domain-switch

Domain Configuration

支持多域名容灾：

# 使用不同节点
season-wx-cli config --set --app-id XXX --app-secret XXX --domain sh

# 可选域名: api, api2, sh, sz, hk

Configuration Management

# 设置配置
season-wx-cli config --set --app-id APP_ID --app-secret APP_SECRET [--domain api]

# 查看配置
season-wx-cli config --get

# 删除配置
season-wx-cli config --delete

Error Handling

常见错误码：

Permission Requirements

以下接口需要已认证的服务号才能调用：

• 发布能力相关接口（publish-*）
• 留言管理相关接口（comment-*）
• 模板消息接口

订阅号或个人主体账号可能无法使用部分功能。

Advanced Usage

See references/api.md for complete API documentation.