echo-wechat-skilllisted
Install: claude install-skill xiangzhouEcho/Echo-wechat-skill
# Echo WeChat Skill — 下载微信公众号文章
## Overview
把微信公众号文章存到本地:Markdown(Obsidian 友好)、离线 HTML、PDF,连同文章内的图片、视频、音频。
**Core principle:** 免证书。全程只是对公开页面做 HTTPS GET + 读公开的合集 JSON 接口,不装证书、不架代理、不登录、不碰客户端密钥。
## When to Use
- 有一个或多个 `mp.weixin.qq.com/s/...` 文章链接,想存成 Markdown / HTML / PDF
- 要整份**合集(album)**批量下载
- 需要把文章图片/视频/音频一起保存到本地做离线归档
- 想把公众号文章导入 Obsidian(带 YAML frontmatter + 相对路径图片)
**Not for:**
- 任意公众号的**全量历史消息**批量抓取 —— macOS 上免证书做不到(Mac 版微信不落带密钥的链接),本 skill 不做;用**合集**或**批量 URL 列表**替代
- 阅读数 / 点赞数 / 评论 / 划线 —— 需要客户端密钥(等价于装证书),不支持
- 视频号(`mp-common-videosnap`)、腾讯视频(`v.qq.com`)—— 无法免证书下载,输出里会留占位说明
## Quick Start
**执行位置(重要)**:在**你希望产物落地的目录**运行(默认下载到当前目录下的 `wechat-download/`),并用**绝对路径**调用脚本——这样 `--out`、`--url-file` 等相对路径都相对你当前目录,脚本依赖也能就位。不要 `cd` 进 skill 目录(否则产物会落在 skill 目录里)。本机脚本绝对路径为 `~/.claude/skills/echo-wechat-skill/scripts/wechat_dl.py`。
依赖由 uv 按脚本内联声明自动安装,无需手动 pip。PDF 复用系统 Chrome。`--format`/`--media`/`--out` 等所有选项对单篇、合集、批量三种模式通用。
```bash
DL=~/.claude/skills/echo-wechat-skill/scripts/wechat_dl.py
# 单篇 -> Markdown(默认)
uv run "$DL" "https://mp.weixin.qq.com/s/XXXX"
# 单篇 -> 三种格式 + 图片/视频/音频全下
uv run "$DL" "https://mp.weixin.qq.com/s/XXXX" --format md,html,pdf --media all
# 合集:链接需含 __biz 与 album_id
uv run "$DL" --album "https://mp.weixin.qq.com/mp/appmsgalbum?__biz=XX==&action=getalbum&album_id=NNN"
# 批量:每行一个链接
uv run "$DL" --url-file links.txt --format md,pdf
```
## Options
| 选项 | 说明 | 默认 |
|------|------|------|
| `--format` | 逗号分隔:`md,html,pdf` | `md` |
| `--out` | 输出根目录 | `