WeChat Channels One-Click Video Downloader

What It Solves

WeChat Channels videos do not expose a simple bulk-download workflow. Users often have to save a video to the phone gallery first, then move it to a desktop. This skill targets engineering and automation use cases: resolving https://weixin.qq.com/sph/... share links, organizing locally saved WeChat Channels video files, and processing multiple links in batch. It is not intended for Bilibili, Douyin, YouTube, or other platforms.

How It Works

The core script is scripts/wx_channels.py. For share links, it opens an isolated Playwright browser profile so the user can log in to Tencent Yuanbao once. It then uses Yuanbao parsing to turn the sph/... link into playback information and fetches the real videoUrl. The MP4 is streamed to local disk with a file-header check, which helps avoid saving partial files.

Common commands include:

• doctor: checks browser and login status without printing secrets
• resolve: resolves the direct link and metadata only
• download: saves the video, with optional --transcribe to call media2text for transcripts and derivative drafts
• batch: downloads from arguments or urls.txt, logs in once for the whole batch, and emits a summary JSON

Since v1.1.0, downloads can also write a sidecar .json metadata file and best-effort .jpg cover image, which makes archiving and script consumption easier.

Boundaries and Notes

This skill depends on Tencent Yuanbao interfaces, which may change or stop working as versions evolve. If that happens, the local-file path remains available: save the video on the phone, then provide the local file path. It does not install system root certificates, does not modify system proxies, and does not read the user's normal browser profile. The script outputs structured JSON and does not print cookies, tokens, or media URLs to the outside. Pure downloading has minimal local dependencies; link resolution requires a Playwright browser and one Yuanbao login.