From legal-skills
抖音视频批量下载工具 - 基于 F2 框架实现高效、增量的视频下载功能。支持单个/批量博主下载，自动 Cookie 管理，差量更新机制。本技能应在用户需要批量下载特定博主视频、服务器部署自动化下载、或定期更新视频库时使用。
npx claudepluginhub cat-xierluo/legal-skills --plugin minimax-image-understandThis skill uses the workspace's default tool permissions.
本技能基于 **F2 框架**实现抖音视频批量下载，提供高效、稳定的批量下载能力。
CHANGELOG.mdLICENSE.txtconfig/config.yaml.exampleconfig/following.json.examplereferences/INSTALLATION.mdreferences/USAGE.mdscripts/batch-download.pyscripts/check_env.pyscripts/compress.pyscripts/download-v2.pyscripts/download.pyscripts/extract-metadata.pyscripts/following.pyscripts/generate-data.pyscripts/login.pyscripts/manage-following.pyscripts/sync-following.pyscripts/utils/__init__.pyscripts/utils/config.pyDownloads Douyin videos from share links or modal_ids via TikHub API after parsing. Auto-triggers on download requests, links, or modal_ids provided. Requires API token in config.
输入各类视频网站/播客平台链接后，自动下载对应媒体文件并交付给用户。优先使用 yt-dlp 覆盖抖音(Douyin)、B站(Bilibili)、YouTube 等常见视频网站，也可用于可直接暴露音频地址的播客平台（如小宇宙单集链接）。当遇到 403/登录/年龄或地区限制时，支持使用 cookies.txt 重试；对于可能存在 DRM/加密或条款限制的平台（例如部分 Spotify 内容），应提示用户仅下载其有权保存的内容，并在不可下载时建议改用官方离线/导出渠道或提供原始 RSS/直链。注意：抖音图文笔记暂不支持自动下载，需手动处理。
Downloads watermark-free Douyin videos, retrieves video info and download links, and extracts speech transcripts using Siliconflow API. Requires ffmpeg and Node.js. Useful for media processing in scripts.
Share bugs, ideas, or general feedback.
本技能基于 F2 框架实现抖音视频批量下载，提供高效、稳定的批量下载能力。
在 config/config.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 表中。
# 扫描本地视频并提取元数据（基本信息）
python scripts/extract-metadata.py
# 查看统计摘要
python scripts/extract-metadata.py --stats
⚠️ 注意:
--fetch选项已废弃。推荐使用download-v2.py重新下载视频，会自动保存统计数据。
# 创建配置
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 | 下载地址 |
| ffmpeg | macOS: brew install ffmpeg / Ubuntu: sudo apt install ffmpeg |
ffmpeg 用于视频压缩功能，如仅需下载功能可不安装。
| 包名 | 用途 |
|---|---|
f2 | 抖音视频下载框架 |
playwright | 浏览器自动化（扫码登录） |
pyyaml | YAML 配置文件解析 |
httpx | 异步 HTTP 客户端 |
aiofiles | 异步文件操作 |
详细安装说明：见 references/INSTALLATION.md
详细使用说明：见 references/USAGE.md
下载的视频可以使用 funasr-transcribe 技能将视频转录为带时间戳的 Markdown 文件。
配合方式：先使用抖音下载技能获取视频，再使用 FunASR 技能进行转录。两个技能独立运行，可根据需要灵活组合使用。