douyin-batch-download by cat-xierluo/legal-skills
npx skills add https://github.com/cat-xierluo/legal-skills --skill douyin-batch-download本技能基于 F2 框架 实现抖音视频批量下载,提供高效、稳定的批量下载能力。
在 config/config.yaml 中配置下载路径:
# 下载路径配置
# 留空则使用系统 Downloads 目录下的 "抖音视频下载" 子目录
# macOS: ~/Downloads/抖音视频下载
# Windows: C:\Users\<用户名>\Downloads\抖音视频下载
download_path: ""
# 自定义路径示例:
# download_path: "/Users/maoking/Movies/抖音"
# download_path: "D:\\Videos\\抖音"
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
视频文件按博主昵称分类存储,例如:
~/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 技能进行转录。两个技能独立运行,可根据需要灵活组合使用。
Weekly Installs
65
Repository
GitHub Stars
50
First Seen
Feb 20, 2026
Security Audits
Installed on
gemini-cli62
github-copilot62
codex62
kimi-cli62
amp62
opencode62
本技能基于 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 |
数据存储在 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 技能进行转录。两个技能独立运行,可根据需要灵活组合使用。
Weekly Installs
65
Repository
GitHub Stars
50
First Seen
Feb 20, 2026
Security Audits
Gen Agent Trust HubPassSocketWarnSnykWarn
Installed on
gemini-cli62
github-copilot62
codex62
kimi-cli62
amp62
opencode62
通过 LiteLLM 代理让 Claude Code 对接 GitHub Copilot 运行 | 高级变通方案指南
29,800 周安装
| 点赞数 |
comment_count | 评论数 |
collect_count | 收藏数 |
share_count | 分享数 |