mp-weixin-skills
微信公众号文章管理工具。用于管理微信公众号文章的发布和更新。使用场景:需要将文章发布到微信公众号草稿箱时;需要更新已有草稿内容时;需要上传图片素材到微信素材库时。核心功能:AI 直接生成带样式的 HTML 和封面,然后使用 Python 脚本调用微信 API 完成素材上传和草稿管理。
How do I install this agent skill?
npx skills add https://github.com/liangxp1990/mp-wechat-skills --skill mp-weixin-skillsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a legitimate tool for WeChat Official Account management. It automates document conversion and article publishing using official APIs. Security analysis confirms it uses secure credential handling and interacts with trusted domains. An indirect prompt injection surface is present due to its core functionality, which is managed by the agent's internal safety guardrails.
- Socketwarn
1 alert: gptSecurity
- Snykwarn
Risk: MEDIUM · No issues
- Runlayerwarn
84/85 files flagged
What does this agent skill do?
微信公众号文章管理 Skill
概述
这是一个专门用于管理微信公众号文章发布的 Skill。当您需要将文章发布到微信公众号时,此 Skill 会:
- AI 生成内容:将文档转换为带内联样式的 HTML,并生成封面图
- 脚本上传:使用 Python 脚本上传素材和创建草稿
核心原则:
- AI 负责:文档转换、样式应用、封面生成
- 脚本负责:微信 API 操作(上传素材、草稿管理)
快速开始
使用前准备
- 配置微信公众号 API 凭证
在项目根目录创建 .env 文件:
# 微信公众号配置(必需)
WECHAT_APP_ID=your_app_id_here
WECHAT_APP_SECRET=your_app_secret_here
# 输出配置(可选)
OUTPUT_DIR=./output
TEMP_DIR=./temp
# 样式配置(可选)
THEME_COLOR=#07c160
- 安装依赖
pip install -e .
基本使用
场景 1: AI 直接发布(推荐)
请将这篇文章发布到微信公众号草稿箱
AI 会自动:
- 读取并分析文章内容
- 生成带内联样式的 HTML
- 生成封面图(1080×460)
- 调用上传接口发布到微信草稿箱
场景 2: 命令行发布(备选)
# AI 生成内容后,使用命令行上传
python3 scripts/publish.py "文章标题" article.html cover.jpg
工作流程
AI 发布流程
graph LR
A[用户文章] --> B[AI 转换 HTML]
B --> C[AI 生成封面]
C --> D[publish.py 上传]
D --> E[微信草稿箱]
style B fill:#e1f5ff
style C fill:#e1f5ff
style D fill:#fff4e1
详细步骤
第一步:AI 内容生成
- 读取文章内容(Markdown/文本)
- 按样式规范转换为 HTML
- 应用内联样式(标题、段落、代码块等)
- 生成符合微信阅读体验的完整 HTML
- 根据文章主题生成封面图(1080×460)
第二步:微信 API 上传
- 接收 AI 生成的 HTML 和封面路径
- 上传封面到微信素材库
- 调用微信公众号 API 创建草稿
- 返回草稿 media_id
为什么这样设计?
| 优势 | 说明 |
|---|---|
| 职责分离 | AI 擅长内容理解和样式应用,脚本专注 API 操作 |
| 质量更高 | AI 能理解语义,生成更符合公众号风格的内容 |
| 维护简单 | 脚本只做 API 调用,不需要维护复杂的文档解析逻辑 |
| 灵活扩展 | 可以轻松更换 AI 提供商或生成方式 |
样式规范
自动应用的样式
| 元素 | 样式特点 |
|---|---|
| 一级标题 | 主题色渐变背景、白色文字、圆角阴影 |
| 二级标题 | 左侧主题色装饰条(4px)、12px 左内边距 |
| 段落 | 行高 1.75、字号 15px、两端对齐 |
| 代码块 | 深色背景(#2d2d2d)、支持横向滚动、字号 13px |
| 内联代码 | 浅灰背景(#f0f0f0)、粉色文字(#d63384) |
| 引用块 | 左侧主题色边框、浅灰背景 |
| 表格 | 表头主题色背景、白色文字、边框合并 |
主题色推荐
| 色值 | 适用场景 |
|---|---|
#07c160 | 科技、效率(默认) |
#ff6b6b | 生活、情感 |
#4a90e2 | 商业、职场 |
#f5a623 | 教育、培训 |
#9013fe | 创意、设计 |
封面图生成
自动封面规格:
- 尺寸:1080×460 (2.35:1)
- 格式:JPEG
- 质量:95%
- 字体:华文黑体(支持中文)
封面生成方式:
| 方式 | 说明 | 适用场景 |
|---|---|---|
| 搜索加工(默认) | 从 Pexels 搜索高质量图片,添加渐变遮罩和标题文字 | 适用于所有文章 |
| AI 生成 | 使用 Claude/Midjourney/DALL·E 生成 | 重要文章、品牌建设 |
| 模板生成 | 简单渐变背景 + 标题文字 | 快速生成 |
详细说明请查看 封面生成参考
移动端友好设计
代码块(移动端优化)
关键特性:
- 深色背景(#2d2d2d)保护眼睛
- 字号 13px 适合手机阅读
- 横向滚动(overflow-x: auto)
- 不强制换行(white-space: pre)
- iOS 平滑滚动(-webkit-overflow-scrolling: touch)
设计原则:
- 不破坏代码结构
- 支持横向滚动查看长代码
- 触控滑动体验流畅
图片优化
移动端建议:
- 单张图片 ≤ 500KB
- 宽度 ≤ 900px
- 使用渐进式 JPEG
- 考虑图片懒加载
CLI 命令
发布文章
# 使用 AI 生成的内容发布
python3 scripts/publish.py "文章标题" article.html cover.jpg
上传图片
# 上传单张图片(用于素材管理)
python3 scripts/cli.py upload-image cover.jpg
# 批量上传
python3 scripts/cli.py upload-images ./images
常见问题
Q: 如何获取 media_id?
A: 发布成功后会返回 media_id,也可以在微信公众号后台查看
Q: 图片上传失败怎么办?
A: 检查图片大小(thumb ≤ 2MB,image ≤ 5MB),使用 TinyPNG 压缩后重试
Q: 代码块在手机上显示不全?
A: 这是正常的,代码块支持横向滚动,不会强制换行破坏代码结构
Q: 如何只生成 HTML 不上传?
A: AI 可以直接输出 HTML 内容,保存为文件即可
项目结构
mp-weixin-skills/
├── SKILL.md # 主文件
├── skills.json # Skill 元数据
├── .env.example # 环境配置示例
│
├── scripts/ # 可执行脚本
│ ├── publish.py # 简化的发布接口(AI 调用)⭐
│ ├── cli.py # 完整的命令行接口(可选)
│ ├── config.py # 配置管理
│ ├── exceptions.py # 自定义异常
│ │
│ ├── wechat/ # 微信 API 操作(核心)⭐
│ │ ├── __init__.py
│ │ └── api_client.py
│ │
│ └── utils/ # 工具函数
│ ├── __init__.py
│ └── logger.py
│
├── references/ # 详细文档(按需加载)📚
│ ├── cover-guide.md # 封面指南
│ └── ... # 其他参考文档
│
├── output/ # 输出目录(生成)
└── temp/ # 临时文件(生成)
核心功能说明:
- ⭐ wechat/ - 微信公众号 API 操作(上传素材、创建/更新草稿)
- ⭐ publish.py - 简化的发布接口,接收 AI 生成的 HTML 和封面
- 📚 references/ - Progressive Disclosure 文档,按需加载
许可证
MIT License
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/liangxp1990/mp-wechat-skills/mp-weixin-skills">View mp-weixin-skills on skillZs</a>