# Wespy Fetcher

获取并转换微信公众号/网页文章为 Markdown 的封装 Skill，完整支持 WeSpy 的单篇抓取、微信专辑批量下载、专辑列表获取、HTML/JSON/Markdown...

- Repository: https://github.com/wlzh/skills (694 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-27
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add wlzh/skills --skill wespy-fetcher -g -a claude-code -y`
Codex: `npx skills add wlzh/skills --skill wespy-fetcher -g -a codex -y`
Cursor: `npx skills add wlzh/skills --skill wespy-fetcher -g -a cursor -y`
Gemini CLI: `npx skills add wlzh/skills --skill wespy-fetcher -g -a gemini-cli -y`

## Description

获取并转换微信公众号/网页文章为 Markdown 的封装 Skill，完整支持 WeSpy 的单篇抓取、微信专辑批量下载、专辑列表获取、HTML/JSON/Markdown 多格式输出。Use when user asks to 抓取微信公众号文章、公众号专辑批量下载、URL 转 Markdown、保存微信文章、mp.weixin.qq.com to markdown.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# WeSpy Fetcher

封装 [tianchangNorth/WeSpy](https://github.com/tianchangNorth/WeSpy) 的完整能力。

## 功能范围（与 WeSpy 对齐）

- 单篇文章抓取（微信公众号 / 通用网页 / 掘金）
- 微信专辑文章列表获取（`--album-only`）
- 微信专辑批量下载（`--max-articles`）
- 多格式输出（Markdown 默认，支持 HTML / JSON / 全部）
- 交互模式（不传 URL 时）

## 依赖来源

- 上游项目：`https://github.com/tianchangNorth/WeSpy`
- 本地约定克隆目录：`~/Documents/QNSZ/project/WeSpy`

## 使用

脚本位置：`scripts/wespy_cli.py`

```bash
# 查看帮助
python3 scripts/wespy_cli.py --help

# 单篇文章（默认输出 markdown）
python3 scripts/wespy_cli.py "https://mp.weixin.qq.com/s/xxxxx"

# 输出 markdown + html
python3 scripts/wespy_cli.py "https://mp.weixin.qq.com/s/xxxxx" --html

# 输出 markdown + json
python3 scripts/wespy_cli.py "https://mp.weixin.qq.com/s/xxxxx" --json

# 输出所有格式
python3 scripts/wespy_cli.py "https://mp.weixin.qq.com/s/xxxxx" --all

# 专辑只拉列表
python3 scripts/wespy_cli.py "https://mp.weixin.qq.com/mp/appmsgalbum?..." --album-only --max-articles 20

# 专辑批量下载
python3 scripts/wespy_cli.py "https://mp.weixin.qq.com/mp/appmsgalbum?..." --max-articles 20 --all
```

## 参数

透传 WeSpy 原生命令参数：

- `url`
- `-o, --output`
- `-v, --verbose`
- `--html`
- `--json`
- `--all`
- `--max-articles`
- `--album-only`

## 实现说明

- 优先使用本地源码路径 `~/Documents/QNSZ/project/WeSpy`
- 若本地不存在则自动执行 `git clone` 到该目录
- 通过导入 `wespy.main.main` 直接调用上游 CLI，保持行为一致