Agent skill

Douyin Batch Download

by cat-xierluo in cat-xierluo/legal-skills

抖音视频批量下载工具 - 基于 F2 框架实现高效、增量的视频下载功能。支持单个/批量博主下载,自动 Cookie 管理,差量更新机制。本技能应在用户需要批量下载特定博主视频、服务器部署自动化下载、或定期更新视频库时使用。

MITAuto-check: notesMedia & Creative

Install Douyin Batch Download

skills CLI
$ npx skills add cat-xierluo/legal-skills --skill douyin-batch-download -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install cat-xierluo/legal-skills douyin-batch-download --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/cat-xierluo/legal-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/douyin-batch-download .claude/skills/douyin-batch-download && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
douyin-batch-download
GitHub stars
720
Token cost
~1.1k tokens
SKILL.md length
150 words
Files
21 (incl. scripts, references)
Skills in repo
62
Repo updated
First seen
Licence
MIT

At a glance

抖音视频批量下载工具 - 基于 F2 框架实现高效、增量的视频下载功能。支持单个/批量博主下载,自动 Cookie 管理,差量更新机制。本技能应在用户需要批量下载特定博主视频、服务器部署自动化下载、或定期更新视频库时使用。

  • Media & Creative work in your project
  • SKILL.md covers 功能概述, 使用场景, 配置说明 and 视频元数据, plus 6 more sections
  • Runs Python scripts from its folder; calls python, brew and apt; reaches douyin.com

What it does

Douyin Batch Download is an agent skill from cat-xierluo/legal-skills. 抖音视频批量下载工具 - 基于 F2 框架实现高效、增量的视频下载功能。支持单个/批量博主下载,自动 Cookie 管理,差量更新机制。本技能应在用户需要批量下载特定博主视频、服务器部署自动化下载、或定期更新视频库时使用。

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 23 other files, including scripts and reference files (for example `CHANGELOG.md`, `references/INSTALLATION.md` and `references/USAGE.md`).

It sits in Media & Creative. It works with Douyin and FFmpeg. The licence is MIT.

When your agent uses it

  • Media & Creative work in your project

Example prompts

  • “/douyin-batch-download”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit db2c58c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 11 files in scripts/ (Python, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • brew
    • apt

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • douyin.com

    Also links to:

    • google.com
    • f2.wiki
    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Douyin Batch Download loads about 1.1k tokens when it runs, and up to ~2.6k if it reads all its reference files. Until then it costs about 33 tokens; SKILL.md has 150 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~33
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteRuns commands with sudoSKILL.md:173
    macOS: `brew install ffmpeg` / Ubuntu: `sudo apt install ffmpeg` |

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from cat-xierluo/legal-skills at commit db2c58c, republished under its MIT licence (© cat-xierluo). 150 words, ~1,063 tokens.

Download SKILL.mdSave it as .claude/skills/douyin-batch-download/SKILL.md (or your agent's skills folder). This skill also uses 20 other files; get the full folder from GitHub.
name
douyin-batch-download
description
抖音视频批量下载工具 - 基于 F2 框架实现高效、增量的视频下载功能。支持单个/批量博主下载,自动 Cookie 管理,差量更新机制。本技能应在用户需要批量下载特定博主视频、服务器部署自动化下载、或定期更新视频库时使用。
homepage
https://github.com/cat-xierluo/legal-skills
author
杨卫薪律师(微信ywxlaw)
version
1.8.1
license
MIT

抖音视频批量下载

本技能基于 F2 框架实现抖音视频批量下载,提供高效、稳定的批量下载能力。

功能概述

  • 单个博主下载 - 输入主页链接或 ID,下载全部或指定数量
  • 批量下载 - 一次指定多个博主,批量处理
  • 增量下载 - 自动跳过已下载的视频(按 aweme_id 判断)
  • Cookie 管理 - 优先从浏览器自动读取,失败则提示手动配置
  • 关注列表管理 - 维护 following.json 记录已处理的博主
  • 差量更新 - 支持只下载主页有但本地没有的视频
  • 博主昵称文件夹 - 使用博主昵称作为文件夹名,更易识别
  • 自定义下载路径 - 支持自定义下载目录,默认使用系统 Downloads 目录
  • 视频压缩 - 使用 ffmpeg 压缩视频,节省存储空间
  • 视频元数据 - 抓取并保存视频统计数据(点赞、评论、收藏、分享数)
  • 数据可视化 - Web 界面展示博主和视频的统计信息,支持排序和筛选

使用场景

  • 服务器批量下载:部署在专用服务器上,定时批量抓取特定博主视频
  • 定期更新视频库:自动检测新视频,只下载缺失部分
  • 备份与迁移:视频文件分类存储,便于备份和后续处理
  • 内容分析:基于视频统计数据(点赞、评论、收藏)进行博主内容分析

配置说明

下载路径配置

在 config/config.yaml 中配置下载路径:

yaml
# 下载路径配置
# 留空则使用系统 Downloads 目录下的 "抖音视频下载" 子目录
# macOS: ~/Downloads/抖音视频下载
# Windows: C:\Users\<用户名>\Downloads\抖音视频下载
download_path: ""

# 自定义路径示例:
# download_path: "/Users/maoking/Movies/抖音"
# download_path: "D:\\Videos\\抖音"
文件夹命名

视频文件按博主昵称分类存储,例如:

~/Downloads/抖音视频下载/
├── 博主A/
│   ├── 2024-01-01_视频标题_xxx.mp4
│   └── ...
├── 博主B/
│   └── ...
└── data.js          # Web 界面数据

视频元数据

下载视频时,系统会自动提取并保存以下数据:

字段说明
aweme_id视频唯一 ID
uid作者 UID
nickname博主昵称
desc视频描述/文案
create_time发布时间
duration视频时长
digg_count点赞数
comment_count评论数
collect_count收藏数
share_count分享数

数据存储在 douyin_users.db 的 video_metadata 表中。

手动提取/更新元数据
bash
# 扫描本地视频并提取元数据(基本信息)
python scripts/extract-metadata.py

# 查看统计摘要
python scripts/extract-metadata.py --stats

⚠️ 注意: --fetch 选项已废弃。推荐使用 download-v2.py 重新下载视频,会自动保存统计数据。

快速开始

bash
# 创建配置
mkdir -p config
cp config/config.yaml.example config/config.yaml

# 编辑配置(填写 Cookie)
${EDITOR:-nano} config/config.yaml

# 单个下载(推荐)
python scripts/download-v2.py "https://www.douyin.com/user/MS4wLjABAAAA..."

# 批量下载
python scripts/batch-download.py --all

# 交互式选择博主下载
python scripts/batch-download.py

# 采样下载(每个博主1个视频,快速更新数据)
python scripts/batch-download.py --sample

# 生成 Web 界面数据
python scripts/generate-data.py

# 查看 Web 界面
open ~/Downloads/抖音视频下载/index.html

推荐工作流

1. 添加博主 → python scripts/manage-following.py --batch
2. 批量下载 → python scripts/batch-download.py --all
3. 查看数据 → open ~/Downloads/抖音视频下载/index.html

下载时自动保存:

  • ✅ 视频文件
  • ✅ 点赞、评论、收藏、分享数
  • ✅ 视频描述、发布时间、时长

目录结构

skills/douyin-batch-download/
├── SKILL.md                  # 本文件
├── references/
│   ├── INSTALLATION.md        # 详细安装依赖说明
│   └── USAGE.md              # 详细使用说明
├── scripts/
│   ├── utils/                # 工具模块
│   │   └── config.py         # 统一配置加载
│   ├── download-v2.py        # ✅ 推荐下载脚本(自动保存统计数据)
│   ├── batch-download.py     # 批量下载入口
│   ├── download.py           # ⚠️ 旧版下载脚本(已废弃)
│   ├── manage-following.py   # 关注列表管理(添加/删除/搜索)
│   ├── sync-following.py     # 从 F2 数据库同步 following.json
│   ├── compress.py           # 视频压缩脚本
│   ├── extract-metadata.py   # 视频元数据提取
│   ├── generate-data.py      # 生成 Web 界面数据文件
│   ├── following.py          # following.json 操作库
│   └── login.py              # 扫码登录脚本
├── config/
│   ├── config.yaml.example  # 配置模板
│   └── following.json       # 关注列表(已下载的博主)
└── douyin_users.db          # SQLite 数据库(用户信息 + 视频元数据)

依赖

系统依赖
依赖安装方式
Chrome/Chromium下载地址
ffmpegmacOS: brew install ffmpeg / Ubuntu: sudo apt install ffmpeg

ffmpeg 用于视频压缩功能,如仅需下载功能可不安装。

Python 包
包名用途
f2抖音视频下载框架
playwright浏览器自动化(扫码登录)
pyyamlYAML 配置文件解析
httpx异步 HTTP 客户端
aiofiles异步文件操作

详细安装说明:见 references/INSTALLATION.md

详细使用说明:见 references/USAGE.md

参考资源

与其他技能配合

本地 ASR 语音转文字

下载的视频可以使用 local-asr 技能将视频转录为带时间戳的 Markdown 文件。

配合方式:先使用抖音下载技能获取视频,再使用 local-asr 技能进行转录。两个技能独立运行,可根据需要灵活组合使用。

© cat-xierluo, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 20 other files (scripts, references) in skills/douyin-batch-download of cat-xierluo/legal-skills.

  • SKILL.md
  • CHANGELOG.md
  • LICENSE.txt
  • config/config.yaml.example
  • config/following.json.example
  • references/INSTALLATION.md
  • references/USAGE.md
  • scripts/batch-download.py
  • scripts/check_env.py
  • scripts/compress.py
  • scripts/download-v2.py
  • scripts/download.py
  • scripts/extract-metadata.py
  • scripts/following.py
  • scripts/generate-data.py
  • scripts/login.py
  • scripts/manage-following.py
  • scripts/sync-following.py
  • … and 3 more

Open the folder on GitHubat commit db2c58c

Compare with similar skills

Douyin Batch Download next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Douyin Batch Download compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Douyin Batch Download this skillcat-xierluo/legal-skills720—~1.1kAutomated safety check: NotesMIT
Douyin Videoyzfly/douyin-mcp-server1.3k—~666Automated safety check: PassApache-2.0
Videohubcacity/VideoHub168—~405Automated safety check: PassMIT
Douyin Resolverinfometa/workbuddyskills348—~659Automated safety check: NotesNone
Douyin Video ForgeLeoYeAI/openclaw-master-skills2.2k—~2.6kAutomated safety check: PassMIT
Remotion Best Practiceslyonjs/shortvid.io14733 repos~1kAutomated safety check: PassMIT

Similar skills

  • Douyin Video

    yzfly/douyin-mcp-server

    抖音无水印视频下载和文案提取工具. An agent skill from yzfly/douyin-mcp-server.

    1.3k GitHub stars~666 tokensUpdated 3 mo ago
    Media & CreativeAuto-check passed
  • Videohub

    cacity/VideoHub

    VideoHub 总入口。用于识别用户要处理的平台或功能,并路由到更具体的 VideoHub skills,如 YouTube、抖音、闲时队列、FFmpeg、字幕、故事剪辑、影视封面、音乐卡点剪辑和直播录制。

    168 GitHub stars~405 tokensUpdated 9 days ago
    Media & CreativeAuto-check passed
  • Douyin Resolver

    infometa/workbuddyskills

    抖音视频解析技能。当用户发送抖音链接(douyin.com / v.douyin.com)、 抖音分享口令("复制打开抖音")、或提到解析抖音、下载抖音视频、 提取视频文案、视频转文字、语音转文本、抖音内容总结时,使用此技能。

    348 GitHub stars~659 tokensUpdated yesterday
    Media & CreativeAuto-check: notes
  • Douyin Video Forge

    LeoYeAI/openclaw-master-skills

    抖音短视频全链路自动化制作。适用于:收到客户项目需要制作抖音推广视频、 策划短视频内容、生成视频脚本、分析抖音热点趋势、制作爆款短视频。

    2.2k GitHub stars~2.6k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Remotion Best Practices

    lyonjs/shortvid.io

    Best practices for Remotion - Video creation in React. An agent skill from lyonjs/shortvid.io.

    147 GitHub starsUsed in 33 repos~1k tokens
    Media & CreativeAuto-check passed
  • HyperFrames Video Entry Point

    heygen-com/hyperframes

    Entry point for making, editing and rendering videos from HTML compositions with HyperFrames, routing each request to the right workflow.

    60k GitHub starsUsed in 3 repos~5.2k tokens
    Media & CreativeAuto-check passed

More from cat-xierluo/legal-skills

All 62 skills in this repo
  • Elements-Style Complaint Generator

    cat-xierluo/legal-skills

    Converts a lawyer's ordinary complaint or a described case into the Supreme People's Court's elements-style Word template, with layout checks on the result.

    721 GitHub stars~2.6k tokensUpdated yesterday
    Auto-check: notes
  • Lecture Performance Review

    cat-xierluo/legal-skills

    Analyzes raw lecture transcripts for verbal tics, pacing, time use and promise follow-through, with optional slide-by-slide comparison and cross-session tracking.

    721 GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • De-AI Polish for Chinese Articles

    cat-xierluo/legal-skills

    Detects and rewrites machine-sounding patterns in the body text of Chinese articles while keeping the author's facts, headings and legal terms intact.

    721 GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed
  • GitHub Star Manager

    cat-xierluo/legal-skills

    Finds GitHub projects mentioned in articles or screenshots and stars them, tracks updates to your starred repos, and builds an HTML dashboard to browse them.

    721 GitHub stars~2k tokensUpdated yesterday
    Auto-check: notes
  • Legal Harness Initializer

    cat-xierluo/legal-skills

    Sets up or incrementally updates AGENTS.md and CLAUDE.md for legal professionals, with a minimal safety baseline and a check that a new session loads and follows the rules.

    721 GitHub stars~2.3k tokensUpdated yesterday
    Auto-check passed
  • Moot Court Simulation Builder

    cat-xierluo/legal-skills

    Chinese-language skill that organizes a case file into a multi-role mock trial with judge, parties and clerk, producing a transcript, issue review and a to-strengthen list.

    721 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Douyin Batch Download

What does Douyin Batch Download do?

抖音视频批量下载工具 - 基于 F2 框架实现高效、增量的视频下载功能。支持单个/批量博主下载,自动 Cookie 管理,差量更新机制。本技能应在用户需要批量下载特定博主视频、服务器部署自动化下载、或定期更新视频库时使用。. Douyin Batch Download is an agent skill from cat-xierluo/legal-skills.

When should I use Douyin Batch Download?

Douyin Batch Download fits situations like: media & Creative work in your project.

How do I install Douyin Batch Download in Claude Code?

Run `npx skills add cat-xierluo/legal-skills --skill douyin-batch-download -a claude-code`. Or copy the skill folder (skills/douyin-batch-download in cat-xierluo/legal-skills) into .claude/skills/douyin-batch-download in your project. Claude Code loads it when a task matches its description.

How do I install Douyin Batch Download in Codex?

Run `npx skills add cat-xierluo/legal-skills --skill douyin-batch-download -a codex`. Or copy the skill folder (skills/douyin-batch-download in cat-xierluo/legal-skills) into .agents/skills/douyin-batch-download in your project. Codex loads it when a task matches its description.

Can I use Douyin Batch Download in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add cat-xierluo/legal-skills --skill douyin-batch-download -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/douyin-batch-download, .gemini/skills/douyin-batch-download, .github/skills/douyin-batch-download and .opencode/skills/douyin-batch-download in your project.

What does Douyin Batch Download need to run?

Going by SKILL.md and its folder, Douyin Batch Download needs Python for the scripts in its folder and the command-line tools its instructions call (python, brew and apt). Our summary lists: Python 3.

Does Douyin Batch Download access the network?

SKILL.md names 4 domains. In commands or code: douyin.com; the agent is likely to contact it when it follows the instructions. As links in the text: google.com, f2.wiki and github.com. This is read from the text; nothing was executed.

Is Douyin Batch Download safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Douyin Batch Download use?

Douyin Batch Download is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Douyin Batch Download use?

About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.6k tokens, read only when the agent opens those files.

What are the alternatives to Douyin Batch Download?

Skills that share tags, products or a category with Douyin Batch Download: Douyin Video (yzfly/douyin-mcp-server, 1.3k stars), Videohub (cacity/VideoHub, 168 stars), Douyin Resolver (infometa/workbuddyskills, 348 stars) and Douyin Video Forge (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Douyin Batch Download?

cat-xierluo (a GitHub user) maintains it in cat-xierluo/legal-skills, which has 720 GitHub stars. The repository holds 62 skills in this directory. The repository was last updated on October 10, 2026.

Source: cat-xierluo/legal-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.