前言¶
微信视频号分享出去的是 https://weixin.qq.com/sph/... 短链，官方没有面向个人的公开下载接口。常见做法是手机先「保存到相册」再传到电脑，或者走抓包类工具——后者往往要装系统根证书、改系统代理，环境和合规成本都不低。
下面介绍 SkillHub 上的社区 Skill「视频号视频一键下载」（@user_fa3f12d0/wechat-channels-downloader，当前 v1.1.6）。它把解析与下载封装成 Agent 可触发的能力：贴链接或问「视频号怎么保存」时，由 Agent 调用内置脚本 scripts/wx_channels.py，把 mp4 下载到本地；也支持只处理本机已有文件、零登录。Skill 标注 requires_api_key=false，不强制配置 API Key。
这是什么¶
「视频号视频一键下载」是面向 微信视频号 的下载专用 Agent Skill，由社区发布者 user_fa3f12d0（页面标注作者「书童哥」）维护，分类为 design-media，来源为 community。Skill 说明写明：本工具从同作者的 media2text（全平台转录与二创）中拆出，专注下载链路。
在 SkillHub 上，该 Skill 评分 100000，下载量 4351（统计以 SkillHub 页面为准）。
核心功能¶
以下能力均来自 Skill 自带的 SKILL.md 与脚本说明，可按子命令复现。
两种使用路径
- 本地文件（零登录）：用户把手机里已保存的视频号文件路径交给 Agent，无需 Playwright、无需登录。
- 分享链接（贴 sph 链接）：通过腾讯元宝解析接口换取可播放地址，再调视频号 feed 接口拿到
videoUrl，用标准库流式下载 mp4。首次需在隔离的 Edge/Chrome 配置里登录元宝一次，会话长期保存在本机专用目录，不读取日常浏览器 Profile。
脚本子命令（scripts/wx_channels.py）
| 命令 | 作用 |
|---|---|
doctor |
检查浏览器与元宝登录状态，不输出密钥 |
login |
打开隔离浏览器完成元宝登录 |
resolve <sph-url> |
仅解析直链与元信息 |
download <sph-url> |
解析并下载 mp4，默认 ~/Downloads，可用 --output-dir |
batch [urls...] [--file urls.txt] |
批量下载，整批只登录一次 |
v1.1.0 起的能力（当前包版本仍为 1.1.6，说明中保留该版本说明）：download / batch 支持 --transcribe、--srt、--no-rewrite，可联动已安装的 media2text 做转录与二创；下载同时落盘同名 .json 元数据与尽力抓取的 .jpg 封面。
v1.1.6：channels.weixin.qq.com/finder-preview/pages/sph?id=... 类预览链接会自动归一化为 weixin.qq.com/sph/... 再解析。
安全与边界（官方强调）
- 不安装系统根证书、不改系统代理；不向外打印 cookie、token、直链。
- 仅用于有权处理的内容（本人作品、已授权、本地自有文件）；不支持付费、会员、私密内容解析。使用法律责任由使用者承担。
安装与启用¶
SkillHub 推荐让 Agent 按安装文档拉取 Skill，或在本机用 CLI 指定 Agent 的 skills 目录安装（装错目录 Agent 无法识别）。
方式 A：提示词安装（SkillHub 页面）
把下面意图发给已接入 SkillHub 安装流程的 AI：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_fa3f12d0/wechat-channels-downloader。
方式 B：skillhub CLI
若尚未安装 CLI，可先执行：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 Skill 时需 --dir 指向当前 Agent 的 skills 目录，例如：
# Cursor
skillhub install wechat-channels-downloader --namespace user_fa3f12d0 --dir ~/.cursor/skills/
# Claude Code
skillhub install wechat-channels-downloader --namespace user_fa3f12d0 --dir ~/.claude/skills/
# Codex
skillhub install wechat-channels-downloader --namespace user_fa3f12d0 --dir ~/.codex/skills/
安装完成后，按各客户端要求刷新或重启 Agent，使 SKILL.md 被加载。
贴链接模式的额外依赖（仅方式二）
pip install "playwright>=1.52,<2" && playwright install chromium
也可使用本机 Edge/Chrome，具体见 Skill 内 references/dependencies.md。
典型用法¶
触发方式：向 Agent 发送 https://weixin.qq.com/sph/... 链接，或自然语言如「下载视频号视频」「视频号怎么保存」。B 站、抖音等平台应使用其它 Skill（如 media2text），不要误触发本 Skill。
命令行快速验证（安装 Skill 后进入 scripts 目录）：
cd <本 skill>/scripts
# 一次性登录元宝（隔离浏览器）
python wx_channels.py login --browser edge
# 单条下载
python wx_channels.py download "https://weixin.qq.com/sph/xxxxxx" --output-dir "/path/to/save"
# 下载并联动 media2text 转录（需已安装 media2text；未安装时仅跳过转录，不影响下载）
python wx_channels.py download "https://weixin.qq.com/sph/xxxxxx" --transcribe
# 批量：整批只登录一次
python wx_channels.py batch --file "/path/to/sph_urls.txt" --output-dir "/path/to/save"
链接清单文件每行一个 URL，# 开头为注释。
环境不确定时，先自检：
python wx_channels.py doctor --browser edge
若 resolve / download 返回 YUANBAO_AUTH_FAILED，按 Skill 说明执行 python wx_channels.py login --force --browser edge 重新登录。
适用场景与注意¶
适合谁
- 需要在 Cursor、Claude Code、Codex 等环境里，用对话完成「贴 sph 链接 → 本地 mp4」的创作者或运营，且能接受贴链接模式下的一次元宝登录。
- 已与 media2text 搭配使用、希望形成「下载 → 转录 → 二创」流水线的人（
--transcribe为可选，非必需）。
限制与坑
- 元宝侧接口可能随版本变化；失效时可退回「手机保存到本地 → 传路径」的零登录路径。
doctor显示已登录不代表会话仍有效，401 时需--force重登。- 批量场景优先用
batch，避免多次download重复开浏览器、增加风控风险。 - 版权与合规以 Skill 顶部声明为准，勿用于未授权搬运。
结尾¶
「视频号视频一键下载」把 sph 解析、mp4 落盘、可选转录联动收敛进一个 Skill，在「不装根证书、不改代理」的前提下提供链接与本地文件两条路径。需要安装或查看更新时，以 SkillHub 官方页为准：
- https://www.skillhub.cn/skills/user_fa3f12d0/wechat-channels-downloader
- https://api.skillhub.cn/user_fa3f12d0/wechat-channels-downloader
