# wechat_platform_skills

**Repository Path**: aierwiki/wechat_platform_skills

## Basic Information

- **Project Name**: wechat_platform_skills
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-13
- **Last Updated**: 2026-04-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WeChat Platform Skills

一个标准的 [Claude Skills](https://docs.anthropic.com/) 项目，封装微信公众平台核心 API，可供 AI Agent（Cursor / Claude Code 等）直接调用。

## 功能

| 能力 | 说明 |
|------|------|
| **多账号管理** | 支持在配置文件中存储多个公众号账号，通过名称区分，适合频繁切换账号的场景 |
| **灵活凭证提供** | 支持命令行参数和配置文件两种方式提供凭证，满足不同使用场景 |
| **Access Token** | 每次实时获取，无缓存，避免账号切换时的混淆问题 |
| **上传封面图** | 上传为永久素材，返回 `media_id`，用于创建草稿 |
| **上传正文图片** | 返回微信 CDN URL，可直接用于 HTML 正文 `<img>` |
| **创建草稿** | 支持标题、正文、封面、作者、摘要、评论设置等完整参数 |
| **HTML 合规检查** | 发布前检查 HTML 是否符合微信规范，覆盖 20 条规则，输出问题说明与修复建议 |

## 安装

### 方式一：一键安装为 Claude Skill

```bash
cd wechat_platform_skills
chmod +x install-skill.sh
./install-skill.sh
```

安装后 AI Agent 会在需要操作公众号时自动触发该技能。

### 方式二：手动使用

```bash
pip install -r requirements.txt
```

## 快速开始

### 1. 配置多账号（可选）

配置文件位于 `~/.wechat_platform/config.json`，支持存储多个账号：

```bash
# 添加账号
python3 scripts/wechat_platform.py config --add main --appid YOUR_APPID --appsecret YOUR_APPSECRET
python3 scripts/wechat_platform.py config --add backup --appid ANOTHER_APPID --appsecret ANOTHER_SECRET

# 列出所有账号
python3 scripts/wechat_platform.py config --list

# 查看指定账号（AppSecret 自动脱敏）
python3 scripts/wechat_platform.py config --get main

# 删除账号
python3 scripts/wechat_platform.py config --remove backup

# 清除所有配置
python3 scripts/wechat_platform.py config --clear
```

### 2. 两种方式提供凭证

每个操作命令都需要提供凭证，按优先级从高到低：

**方式 1：命令行参数（适合临时操作）**
```bash
python3 scripts/wechat_platform.py token --appid wx123 --appsecret abc456
```

**方式 2：配置文件（推荐，适合日常使用）**
```bash
# 先添加账号到配置文件
python3 scripts/wechat_platform.py config --add main --appid wx123 --appsecret abc456
# 使用时指定账号名称
python3 scripts/wechat_platform.py token --account main
```

### 3. 获取 Access Token

```bash
# 使用配置文件中的账号（推荐）
python3 scripts/wechat_platform.py token --account main --json

# 直接提供凭证
python3 scripts/wechat_platform.py token --appid wx123 --appsecret abc456
```

### 4. 上传封面图

```bash
python3 scripts/wechat_platform.py upload-cover cover.png --account main --json
# 返回 {"success":true,"data":{"media_id":"...","url":"..."}}
```

封面图建议优先使用：**横版、主体明确、少文字** 的图片。

尽量避免直接使用：
- K 线图、表格截图
- 字太多的海报图
- 竖图或画面过挤的图片

### 5. 上传正文图片

```bash
python3 scripts/wechat_platform.py upload-image photo.jpg --account main --json
# 返回 {"success":true,"data":{"url":"https://mmbiz.qpic.cn/..."}}
```

### 6. 检查 HTML 合规性（发布前推荐）

```bash
python3 scripts/wechat_platform.py check-html article.html
python3 scripts/wechat_platform.py check-html article.html --json
```

检查内容包括：内容大小、禁止标签、外部图片、被过滤的 CSS 属性、id/事件属性等 20 条规则。

另外在表格样式上，建议把表头背景色直接写在 `<th>` 上，不要只写在 `<tr>` 上，否则公众号预览里有时会被渲染成浅色。

### 7. 创建草稿

```bash
python3 scripts/wechat_platform.py create-draft \
  --title "文章标题" \
  --content article.html \
  --cover-media-id MEDIA_ID \
  --account main \
  --author "作者" \
  --digest "摘要" \
  --open-comment \
  --json
```

## 项目结构

```
wechat_platform_skills/
├── SKILL.md                        # Claude Skill 定义文件
├── README.md                       # 本文件
├── requirements.txt                # Python 依赖
├── install-skill.sh                # 一键安装脚本
├── scripts/
│   └── wechat_platform.py          # 核心 CLI 工具
└── references/
    └── api_reference.md            # 微信 API 参考文档
```

## 获取微信凭证

1. 登录 [微信公众平台](https://mp.weixin.qq.com/)
2. 进入 **设置与开发** → **基本配置**
3. 在「开发者ID」栏目获取 AppID 和 AppSecret

> 注意：需要在「IP白名单」中添加你的服务器 IP 才能正常调用接口。

## 许可证

MIT License