wxvideo-download：按关键词批量下载微信视频号视频

是什么

wxvideo-download 是一个 Claude Code Skill，用来批量下载微信视频号的视频。

输入账号名称和关键词，它会自动翻页匹配标题、解析下载链接、保存视频文件，同时为每条视频生成元数据 JSON。整个过程一条命令完成。

能解决什么问题

视频号没有官方下载入口。想保存一条视频，通常只有两条路：

用第三方工具手动一条条操作，效率低
找到视频链接后自己想办法解析，步骤繁琐

当需要批量归档某个账号的特定内容时，手动方式基本不可行。

这个 Skill 解决的正是这种场景：给一个账号名、一个关键词、一个数量上限，剩下的全自动处理。

它能做什么

按账号 + 关键词匹配视频

输入视频号账号名称，Skill 会先解析出对应的内部 ID（v2_name），然后翻页拉取该账号的视频列表，逐条检查标题是否包含指定关键词，匹配到足够数量后停止。

自动解析下载链接

每条匹配到的视频，都会调用接口获取真实的 .mp4 下载地址，然后流式写入本地文件，支持大文件。

输出视频 + 元数据

每条视频下载完成后，同目录生成一个同名 .json 文件，包含：

标题、发布时间、账号昵称
object_id / object_nonce_id（可用于后续直接下载）
文件大小、下载地址

所有视频处理完后，还会生成一个汇总 summary.json，记录本次下载的全部结果。

失败自动重试

网络抖动或接口超时时，脚本会自动重试最多 5 次，间隔递增，避免因临时故障中断整批下载。

支持快捷路径

如果已知 v2_name 或 object_id，可以跳过账号解析步骤，直接进入下载环节，速度更快。

安装

pip install requests

脚本无其他依赖，requests 是唯一需要安装的库。

配置

需要一个 API Key，设置为环境变量：

export XHS_API_KEY=你的key

或者每次运行时通过 --key 参数传入。

使用

基本用法：账号名 + 关键词

python3 scripts/download_wxvideo.py \
  --account-name "大湾区之声" \
  --keyword "李家超" \
  --limit 5 \
  --out-dir "~/Desktop/视频下载"

已知 v2_name 时直接使用

python3 scripts/download_wxvideo.py \
  --v2-name "v2_xxx@finder" \
  --keyword "李家超" \
  --limit 3 \
  --out-dir "~/Desktop/视频下载"

参数说明

参数	说明	是否必填
`--account-name`	视频号账号名称	与 `--v2-name` 二选一
`--v2-name`	账号内部 ID	与 `--account-name` 二选一
`--keyword`	标题关键词	必填
`--limit`	下载数量上限，默认 5	可选
`--out-dir`	输出目录	必填
`--key`	API Key	可选（优先读环境变量）

输出示例

下载目录/
├── 01_李家超出席立法会_2026-03-01_10-00-00.mp4
├── 01_李家超出席立法会_2026-03-01_10-00-00.json
├── 02_李家超回应记者提问_2026-02-28_15-30-00.mp4
├── 02_李家超回应记者提问_2026-02-28_15-30-00.json
└── wxvideo_download_summary_李家超.json

在 Claude Code 里使用

加入 Skill 后，直接用自然语言描述需求：

下载大湾区之声，标题含"李家超"，最近 5 条，保存到桌面/视频下载

Claude 会自动识别并运行脚本，不需要手动拼命令。

适用场景

内容研究：批量归档特定话题的视频素材
媒体监测：定期抓取指定账号的关键内容
个人存档：保存想留存但担心被删的视频

是什么