wechat-article-parser

# 微信公众号文章解析器

解析微信公众号文章，自动提取标题、作者、发布时间、正文内容等信息。

## 功能特性

- ✅ 自动提取文章标题、作者、发布时间
- ✅ 完整正文内容提取
- ✅ 图片链接提取
- ✅ 字数统计
- ✅ 支持保存为 JSON/TXT
- ✅ 可选保存到飞书表格

## 使用方法

### 基本用法：解析文章

```bash
python3 scripts/wechat_parser.py "https://mp.weixin.qq.com/s/xxxxx"
```

**输出示例：**
```
================================================================================
📰 标题: 文章标题
✍️  作者: 公众号名称
🕐 发布时间: 2026-03-10
📊 字数: 3500
🖼️  图片数: 5
================================================================================

📝 正文内容:

这是文章的正文内容...
================================================================================
```

### 保存到文件

```bash
# 保存为 JSON（包含全部信息）
python3 scripts/wechat_parser.py "URL" --save

# 指定输出文件名
python3 scripts/wechat_parser.py "URL" --save --output article.json
```

### 保存到飞书表格

```bash
python3 scripts/save_to_feishu.py "https://mp.weixin.qq.com/s/xxxxx"

# 手动指定标题
python3 scripts/save_to_feishu.py "https://mp.weixin.qq.com/s/xxxxx" "自定义标题"
```

### 在 OpenClaw 对话中使用

直接发送微信公众号链接，AI 会自动调用此 skill 解析内容：

```
https://mp.weixin.qq.com/s/xxxxx
```

或带指令：
```
解析这篇文章 https://mp.weixin.qq.com/s/xxxxx
```

```
收藏 https://mp.weixin.qq.com/s/xxxxx
```

## 输出格式

### JSON 格式

```json
{
  "title": "文章标题",
  "author": "公众号名称",
  "publish_time": "2026-03-10",
  "content": "正文内容...",
  "word_count": 3500,
  "images_count": 5,
  "images": ["url1", "url2", ...],
  "url": "原始链接",
  "parsed_at": "2026-03-10 12:00:00"
}
```

## 飞书保存配置

如需使用飞书保存功能，需配置 `.env` 文件：

```env
FEISHU_APP_ID=your_app_id
FEISHU_APP_SECRET=your_app_secret
FEISHU_APP_TOKEN=your_bitable_app_token
FEISHU_TABLE_ID=your_table_id
```

## 支持的链接格式

- `https://mp.weixin.qq.com/s/xxxxx`
- `https://mp.weixin.qq.com/s?__biz=xxx&mid=xxx&idx=xxx`
-...

# 微信公众号文章解析器

解析微信公众号文章，自动提取标题、作者、正文内容，支持保存到飞书多维表格。

## 📦 安装

### 步骤 1：安装依赖

```bash
pip3 install requests beautifulsoup4 python-dotenv
```

或使用 requirements.txt：

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

### 步骤 2：验证安装

```bash
python3 scripts/wechat_parser.py
```

应该显示使用说明，表示安装成功。

## 🚀 快速开始

### 基本用法：解析文章

```bash
python3 scripts/wechat_parser.py "https://mp.weixin.qq.com/s/xxxxx"
```

无需任何配置，开箱即用！

## ⚙️ 飞书保存功能配置（可选）

如需将文章保存到飞书多维表格，需要额外配置。

### 步骤 1：创建飞书应用

1. 访问 [飞书开放平台](https://open.feishu.cn)
2. 创建企业自建应用
3. 获取 `App ID` 和 `App Secret`

### 步骤 2：开通权限

在应用的「权限管理」中开通：

- `bitable:app:readonly` - 查看多维表格
- `bitable:app` - 读写多维表格

### 步骤 3：创建多维表格

创建一个飞书多维表格，包含以下字段：

| 字段名 | 类型 | 说明 |
|--------|------|------|
| 文本 | 文本 | 文章标题 |
| 链接 | 超链接 | 文章 URL |
| 来源 | 单选 | 平台来源 |
| 保存时间 | 日期时间 | 保存时间 |
| 摘要 | 多行文本 | 摘要+正文 |

**单选「来源」的选项：**
- 微信公众号
- 知乎
- 今日头条
- 小红书
- B站
- 抖音
- 其他

### 步骤 4：获取表格信息

从表格 URL 中获取：
```
https://xxx.feishu.cn/base/APP_TOKEN?table=TABLE_ID
                            ↑                ↑
                       APP_TOKEN         TABLE_ID
```

### 步骤 5：配置环境变量

复制配置模板：

```bash
cp .env.example .env
```

编辑 `.env` 文件：

```env
FEISHU_APP_ID=cli_xxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxx
FEISHU_APP_TOKEN=xxxxxxxxx
FEISHU_TABLE_ID=tblxxxxxxxxx
```

### 步骤 6：验证配置

```bash
python3 scripts/save_to_feishu.py "https://mp.weixin.qq.com/s/xxxxx"
```

## 📖 使用指南

### 解析文章（无需配置）

```bash
# 基本解析
python3 scripts/wechat_parser.py "URL"

# 解析并保存到文件
python3 scripts/wechat_parser.py "URL" --save

# 指定输出文件名
python3 scripts/wechat_parser.py "URL" --save --output article.json
```

### 保存到飞书...