# Wechat Video Fetch

> Collect WeChat Channels (Weixin Shipinhao / video account) videos through Beeize/Jifengyun scrapers and export CSV/JSON results. Use when the user asks to search a WeChat Channels account by name, get its username/finderName, run the account video-list scraper, configure a Beeize API key, or produce a spreadsheet of a video account's works.

- Skill: `yuming-captain518/wechat-video-fetch` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add yuming-captain518/wechat-video-fetch`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yuming-captain518/wechat-video-fetch/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: Yuming-captain518 (https://skillmd.com/u/yuming-captain518)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/yuming-captain518/wechat-video-fetch

---


# WeChat Video Fetch

Use this skill to turn a WeChat Channels account name into a CSV table of that account's videos.

## Workflow

1. If the user has not configured a Beeize token, run the configuration command below.
2. Run the bundled script with the account name and desired page count.
3. Report the selected account, `username/finderName`, video count, and output paths.
4. If matching is uncertain, do not guess silently; show the candidates from the script error and ask which account is correct.

## First-Time Configuration

Prefer storing a path to the user's key file instead of copying the secret into the config:

```powershell
python C:\Users\Administrator\.codex\skills\wechat-video-fetch\scripts\wechat_video_fetch.py configure --key-file "D:\desktop\key.txt"
```

The script writes private config to:

```text
%USERPROFILE%\.codex\wechat-video-fetch\config.json
```

Never print the token value. It is also valid to use environment variable `BEEIZE_API_TOKEN` for one-off runs.

## Run Collection

Default: fetch all pages (`page_number = 0` in Beeize). Each page is about 15 videos.

```powershell
python C:\Users\Administrator\.codex\skills\wechat-video-fetch\scripts\wechat_video_fetch.py run "account name" --output-dir "D:\desktop\API_jifengyun_caiji\outputs"
```

Use `--pages 1`, `--pages 4`, etc. only when the user explicitly wants to limit the collection.

Use `--download-media` only when the user explicitly asks to download media files.

## Outputs

The script writes:

- `*.csv`: UTF-8 BOM spreadsheet for Excel.
- `*.json`: full raw result payload.
- `*_summary.json`: selected account, run IDs, counts, and output paths.

CSV columns include author nickname, `username/finderName`, work ID, publish time, description, like/comment/favorite/forward counts, duration, download URL, and cover URL.

## Confirmed Beeize Details

- API base: `https://api.beeize.com`
- Storage result base: `https://console.beeize.com/api/storages/result`
- Account search scraper: `755r23ex9mv7lh95f`
- Video list scraper: `hx5r23ex9mv7kz0vt`