微信公众号终极工作台

技能文档

---
name: wechat-mp-suite
title: 微信公众号终极工作台
category: 内容创作
description: 集搜索、爬取、写作、洗稿、AI 配图、专业排版、发布于一体的微信公众号全流程一站式工作台，覆盖公众号内容创作全生命周期。当用户需要搜索公众号文章、爬取/下载公众号文章为 Markdown、按特定风格写作公众号文章、洗稿改写去 AI 味、生成封面配图、公众号排版或发布到公众号草稿箱时触发。触发词：公众号、公众号排版、公众号发布、洗稿、微信文章爬取。
---

# 微信公众号终极工作台 (wechat-mp-suite)

集 **搜索 → 爬取 → 写作 → 洗稿 → AI 配图 → 专业排版 → 发布** 全流程于一体，覆盖公众号内容创作全生命周期。

## 模块一览

| 模块 | 功能 | 触发词示例 |
|------|------|-----------|
| 🔍 搜索 | 关键词搜索公众号文章（搜狗微信） | "搜XX的公众号文章" |
| 📥 爬虫 | URL → Markdown + 本地图片（轻量版） | "爬取这篇公众号文章" |
| 💾 下载 | URL → Markdown + 图片（完整版，含懒加载） | "下载这篇公众号文章" |
| ✍️ 写作 | 多风格写作（商业深度/爆款推文/真人口语/财经点评） | "帮我写篇公众号" |
| 🔄 洗稿 | AI 去痕迹 + 原创改写 | "帮我洗稿/改写这篇文章" |
| 🖼️ AI 配图 | 生成封面图与配图 prompt（配合内置 ImageGen 生成图片） | "给文章配张图" |
| 🎨 排版 | Markdown → 公众号 HTML（多主题 + 代码高亮） | "公众号排版" |
| 📤 发布 | 本地直发 / 远程 MCP 中转发布到公众号草稿箱 | "发布到公众号" |

## 技能工作流

接收用户需求 → 环境准备 → 按需进入以下一个或多个步骤：搜索 → 爬取/下载 → 写作/洗稿 → AI 配图 → 排版 → 发布。

### 步骤1：环境准备

首次使用时初始化环境：

```bash
cd {baseDir}
pip install -r requirements.txt
cp .env.example .env          # 填入公众号凭证（发布模块必需）
python3 check.py              # 环境自检（依赖、凭证、网络）
```

凭证说明：发布模块需要 `WECHAT_APP_ID` 与 `WECHAT_APP_SECRET`（在微信公众号后台「设置与开发 → 基本配置」获取）；搜索模块可选填 `SOGOU_COOKIE` 提升成功率；远程发布可选填 `MCP_SERVER_URL`。

> ⚠️ 本地发布时，本机 IP 必须添加到微信公众号后台 IP 白名单。

### 步骤2：文章搜索

通过搜狗微信搜索公众号文章列表，可选抓取正文：

```bash
python3 {baseDir}/scripts/search/index.py "关键词"
python3 {baseDir}/scripts/search/index.py "关键词" -n 15 -o result.json
python3 {baseDir}/scripts/search/index.py "关键词" -n 5 -c   # -c 抓取正文（自动解析真实链接）
```

参数：`-n` 返回数量（默认 10，最大 50）；`-o` 输出 JSON 路径；`-r` 解析真实链接；`-c` 抓取正文。

### 步骤3：文章爬取与下载

| 方式 | 命令 | 说明 |
|------|------|------|
| 轻量爬虫 | `python3 {baseDir}/scripts/spider/main.py <url> [输出目录]` | Markdown + images/ |
| 完整下载 | `python3 {baseDir}/scripts/downloader/download.py <url> -o ./articles` | 处理懒加载图片；`--no-image` 跳过图片 |

输出为 `<文章标题>.md` 与 `images/` 目录，可直接用于后续洗稿、排版。

### 步骤4：文章写作（多风格）

按用户选择的风格直接撰写 Markdown 文章：

- **商业深度风格**：从具体案例切入 → 独特观点 → 2-3 个真实案例论证 → 数据支撑 → 结论与行动建议；3000-5000 字；结尾不加话题标签、少用 emoji。
- **爆款推文风格**：五维标题矩阵（悬念/痛点/反直觉/利益/强情绪）；H2/H3 分层、每段 ≤4 行；3-5 张配图（配合内置 ImageGen 生成）；开头用提问式/场景式/数据式/故事式/反差式钩子。
- **真人口语风格**：随意感 > 口语化；前 3 段内出现冲突/反差/损失感钩子；每 4-6 段插入划重点小标题；结尾带 CTA；禁用「赋能、抓手、闭环」等空泛词与「综上所述」等学术套话。
- **财经点评风格**：老韭菜视角、大白话说真相、像朋友聊天，可吐槽调侃。

产出文章保存为 Markdown 文件，进入排版或发布步骤。

### 步骤5：文章洗稿

将已有文章改写为自然原创风格，去除 AI 痕迹：

1. **结构重组**：段落重排、拆合、叙事角度转换、论据重组
2. **语言改写**：删除意义膨胀句、去虚假权威、去广告语气、去 AI 高频词（赋能、闭环、生态、抓手、底层逻辑）
3. **添加真实感**：适当使用第一人称、承认复杂性、长短句交错、加入具体细节

### 步骤6：AI 配图

生成封面图与配图的 prompt，再用内置 ImageGen 生成图片。封面 prompt 模板：

```text
文章封面：{标题}。风格：简洁、现代、公众号头图、强对比、高可读中文标题排版、16:9、2K。主视觉：{核心意象}。颜色：{主色+强调色}。避免：复杂背景、过多文字、水印。
```

配图策略：技术教程用架构图/流程图；产品测评用对比图/细节特写；行业观点用数据图表；个人故事用场景照片；工具推荐用软件界面截图。封面尺寸需 1080×864 像素 JPG/PNG（发布要求）。

### 步骤7：专业排版

Markdown → 公众号可用的内联样式 HTML：

```bash
python3 {baseDir}/scripts/typeset/cli.py article.md -t lapis -o article.html
echo "# 标题" | python3 {baseDir}/scripts/typeset/cli.py -t forest
python3 {baseDir}/scripts/typeset/cli.py -L              # 列出主题
python3 {baseDir}/scripts/typeset/cli.py --list-code-themes
```

主题：lapis / forest / ocean / sunset / noir 等；代码高亮：solarized-light / dracula / github-dark 等。排版 HTML 规范见 [references/SPEC.md](references/SPEC.md)。生成的 HTML 可直接全选复制粘贴到公众号后台。

### 步骤8：文章发布

**方式一：本地直发**

```bash
python3 {baseDir}/scripts/publisher/publish.py article.md [theme] [code_theme]
# 含视频文章
python3 {baseDir}/scripts/publisher/publish_with_video.py article.md
```

**方式二：远程 MCP 中转发**（适合家庭宽带 IP 频繁变动的场景）

```bash
# .env 中配置 MCP_SERVER_URL，如 http://<your-remote-server>:3000/api/mcp
python3 {baseDir}/scripts/publisher/publish_remote.py article.md [theme]
```

**Markdown 格式要求**：文件顶部 frontmatter 必须包含 `title` 与 `cover`（封面绝对路径），可选 `author`、`digest`、`content_source_url`；正文图片路径必须为绝对路径。

```markdown
---
title: 文章标题
cover: /absolute/path/to/cover.jpg
---
```

发布成功后文章进入公众号后台草稿箱，需人工登录后台预览群发。

## 完整工作流示例

```text
1. 搜索：python3 {baseDir}/scripts/search/index.py "AI教程" -n 5 -c
2. 洗稿/写作：按步骤4/5 生成 article.md
3. 配图：按步骤6 生成封面 cover.jpg（内置 ImageGen）
4. 排版：python3 {baseDir}/scripts/typeset/cli.py article.md -t lapis -o article.html
5. 发布：python3 {baseDir}/scripts/publisher/publish.py article.md lapis
```

## 注意事项

- 搜索内置防封禁机制（随机 UA、请求延迟），请勿高频使用
- 发布内容需合规，遵守微信公众号平台规则
- IP 白名单：本地发布加本机 IP，远程发布加服务器 IP
- 环境异常时先运行 `python3 {baseDir}/check.py` 自检

使用说明

# 微信公众号终极工作台

一站式公众号内容工具链：搜索 → 爬取 → 写作 → 洗稿 → AI 配图 → 排版 → 发布，覆盖公众号创作全流程。

## 使用

```bash
# 1. 初始化（安装依赖 + 配置凭证 + 环境自检）
pip install -r requirements.txt
cp .env.example .env        # 填入 WECHAT_APP_ID / WECHAT_APP_SECRET
python3 check.py

# 2. 搜索公众号文章
python3 scripts/search/index.py "关键词" -n 10

# 3. 下载文章为 Markdown + 图片
python3 scripts/downloader/download.py "https://mp.weixin.qq.com/s/xxxx" -o ./articles

# 4. 排版（Markdown → 公众号 HTML）
python3 scripts/typeset/cli.py article.md -t lapis -o article.html

# 5. 发布到公众号草稿箱（IP 需加白名单）
python3 scripts/publisher/publish.py article.md lapis
```

写作、洗稿、配图按 SKILL.md 的「技能工作流」对应步骤以自然语言指令完成。

## 工作原理

- 搜索模块经搜狗微信接口检索文章列表，可解析真实链接并抓取正文
- 爬虫/下载模块将文章正文转为 Markdown 并本地化图片（含懒加载处理）
- 排版模块按 SPEC 规范生成内联样式 HTML，粘贴到公众号后台即保留样式
- 发布模块调用微信公众号 API，将带封面与标题的文章推入草稿箱；也支持经远程 MCP 服务中转发布

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。