wechat-article-explainer

# 微信公众号文章通俗内容解释技能

## 概述

这个 Skill 用于阅读和用通俗的语言总结微信公众号链接的内容。

## 使用方法

当用户提供微信公众号文章链接时，按照以下步骤执行：

### 1. 验证链接格式

确认是有效的微信公众号链接，格式如下：
- `https://mp.weixin.qq.com/s/xxx`
- `https://mp.weixin.qq.com/s?xxx`

### 2. 执行 Python 工具获取文章内容

使用 `wechat_reader.py` 工具抓取文章：

```bash
python3 scripts/wechat_reader.py "<文章链接>"
```

### 3. 总结文章内容

根据获取的文章内容，提供通俗内容解释：

- **文章标题**：
- **作者/来源**：
- **发布时间**：
- **内容总结**（通俗内容解释）：

## 技术细节

- **Python 依赖**：
  - `requests`（基础 HTTP 请求）
  - `playwright`（浏览器模拟，更稳定）

- **安装依赖**：
  ```bash
  pip install requests
  # 或使用浏览器模式
  pip install playwright
  playwright install chromium
  ```

- **使用浏览器模式**：默认使用 Playwright，更稳定但需要安装浏览器
- **不使用浏览器**：`python3 wechat_reader.py <url> --no-browser`

## 注意事项

- 微信文章可能有防盗链限制，直接 HTTP 请求可能失败
- 浏览器模式更稳定但速度较慢
- 如果抓取失败，提示用户在微信中打开文章并复制内容

# 微信公众号文章总结工具

## 项目结构

```
wechat-article-explainer/
├── scripts/wechat_reader.py        # Python 解析工具
├── SKILL.md #  Skill 定义
├── requirements.txt        # Python 依赖
└── README.md              # 说明文档
```

## 安装

```bash
# 安装 Python 依赖
pip install -r requirements.txt

# 安装 Playwright 浏览器（可选但推荐）
playwright install chromium
```

## 使用方法

### 命令行直接使用

```bash
# 使用浏览器模式（推荐，更稳定）
python3 wechat_reader.py "https://mp.weixin.qq.com/s/xxxx"

# 不使用浏览器
python3 wechat_reader.py "https://mp.weixin.qq.com/s/xxxx" --no-browser

# 输出到文件
python3 wechat_reader.py "https://mp.weixin.qq.com/s/xxxx" -o result.json
```

### Openclaw 中使用

1. 将 `SKILL.md` 放到 openclaw 的 skill 目录
2. 使用 `/wechat-article-explainer` 命令调用
3. 提供微信公众号链接，skill 会自动抓取并总结

## Skill 调用流程

1. 用户提供微信文章链接
2. Skill 调用 `wechat_reader.py` 抓取文章
3. 解析返回的 JSON 内容
4. 提供结构化总结

## 输出格式

```json
{
  "success": true,
  "url": "原始链接",
  "title": "文章标题",
  "author": "作者",
  "publish_date": "发布时间",
  "source": "来源公众号",
  "content": "文章内容"
}
```

## 注意事项

- 微信文章可能有防盗链限制
- 浏览器模式成功率更高
- 如遇抓取失败，建议用户在微信中打开文章并复制内容