使用 yt-dlp 抓取 TikTok 内容

yt-dlp 是一个命令行工具（CLI），用于从 TikTok 及众多其他网站下载视频/音频。

环境准备

# macOS
brew install yt-dlp ffmpeg

# pip（适用于所有平台）
pip install yt-dlp
# 同时需单独安装 ffmpeg，以支持合并与后处理

下载模式

单个视频

yt-dlp "https://www.tiktok.com/@handle/video/1234567890"

整套个人主页

yt-dlp "https://www.tiktok.com/@handle" 
  -P "./tiktok/data" 
  -o "%(uploader)s/%(upload_date)s-%(id)s/video.%(ext)s" 
  --write-info-json

生成如下目录结构：

tiktok/data/
  handle/
    20260220-7331234567890/
      video.mp4
      video.info.json

多个个人主页

for handle in handle1 handle2 handle3; do
  yt-dlp "https://www.tiktok.com/@$handle" 
    -P "./tiktok/data" 
    -o "%(uploader)s/%(upload_date)s-%(id)s/video.%(ext)s" 
    --write-info-json 
    --download-archive "./tiktok/downloaded.txt"
done

搜索、话题标签与音效

# 按关键词搜索
yt-dlp "tiktoksearch:cooking recipes" --playlist-end 20

# 话题页
yt-dlp "https://www.tiktok.com/tag/booktok" --playlist-end 50

# 使用特定音效的视频
yt-dlp "https://www.tiktok.com/music/original-sound-1234567890" --playlist-end 30

格式选择

# 列出可用格式
yt-dlp -F "https://www.tiktok.com/@handle/video/1234567890"

# 下载指定格式（例如：在可选范围内下载最佳无水印视频）
yt-dlp -f "best" "https://www.tiktok.com/@handle/video/1234567890"

筛选条件

按日期筛选

# 发布于某日期或之后
--dateafter 20260215

# 发布于某日期之前
--datebefore 20260220

# 发布于精确日期
--date 20260215

# 日期范围
--dateafter 20260210 --datebefore 20260220

# 相对日期（macOS / Linux）
--dateafter "$(date -u -v-7d +%Y%m%d)"           # macOS：最近 7 天
--dateafter "$(date -u -d '7 days ago' +%Y%m%d)" # Linux：最近 7 天

按指标与内容筛选

# 播放量 ≥ 10 万
--match-filters "view_count >= 100000"

# 时长介于 30–60 秒之间
--match-filters "duration >= 30 & duration <= 60"

# 标题包含 “recipe”（不区分大小写）
--match-filters "title ~= (?i)recipe"

# 组合条件：2026 年 2 月发布、播放量 ≥ 5 万
yt-dlp "https://www.tiktok.com/@handle" 
  --match-filters "view_count >= 50000" 
  --dateafter 20260201

仅获取元数据（不下载）

预览将要下载的内容

yt-dlp "https://www.tiktok.com/@handle" 
  --simulate 
  --print "%(upload_date)s | %(view_count)s views | %(title)s"

导出为 JSON

# 单一 JSON 数组
yt-dlp "https://www.tiktok.com/@handle" --simulate --dump-json > handle_videos.json

# JSONL 格式（每行一个对象，适合大规模数据集）
yt-dlp "https://www.tiktok.com/@handle" --simulate -j > handle_videos.jsonl

导出为 CSV

yt-dlp "https://www.tiktok.com/@handle" 
  --simulate 
  --print-to-file "%(uploader)s,%(id)s,%(upload_date)s,%(view_count)s,%(like_count)s,%(webpage_url)s" 
  "./tiktok/analysis/metadata.csv"

使用 jq 分析

# 从已下载的 .info.json 文件中提取播放量最高的前 10 个视频
jq -s 'sort_by(.view_count) | reverse | .[:10] | .[] | {title, view_count, url: .webpage_url}' 
  tiktok/data/*/*.info.json

# 所有视频总播放量
jq -s 'map(.view_count) | add' tiktok/data/*/*.info.json

# 按上传日期分组统计视频数量
jq -s 'group_by(.upload_date) | map({date: .[0].upload_date, count: length})' 
  tiktok/data/*/*.info.json

提示：如需更深入的分析与可视化，可将 JSONL 或 CSV 导出文件加载至 Python 中，配合 pandas 库使用。适用于制作互动率散点图、发帖频率趋势图，或跨创作者对比关键指标等场景。

持续性抓取

归档机制（跳过已下载内容）

--download-archive 参数用于记录已下载视频，从而支持增量更新：

yt-dlp "https://www.tiktok.com/@handle" 
  -P "./tiktok/data" 
  -o "%(uploader)s/%(upload_date)s-%(id)s/video.%(ext)s" 
  --write-info-json 
  --download-archive "./tiktok/downloaded.txt"

后续再次运行相同命令时，将自动跳过 downloaded.txt 中已记录的视频。

身份认证（私有/受限内容）

# 使用浏览器 Cookies（推荐方式）
yt-dlp --cookies-from-browser chrome "https://www.tiktok.com/@handle"

# 或先将 Cookies 导出为文件再使用
yt-dlp --cookies tiktok_cookies.txt "https://www.tiktok.com/@handle"

定时抓取（Cron）

# crontab -e
# 每日凌晨 2 点执行，输出日志
0 2 * * * cd /path/to/project && ./scripts/scrape-tiktok.sh >> ./tiktok/logs/cron.log 2>&1

示例脚本 scripts/scrape-tiktok.sh：

#!/bin/bash
set -e

HANDLES="handle1 handle2 handle3"
DATA_DIR="./tiktok/data"
ARCHIVE="./tiktok/downloaded.txt"

for handle in $HANDLES; do
  echo "[$(date)] Scraping @$handle"
  yt-dlp "https://www.tiktok.com/@$handle" 
    -P "$DATA_DIR" 
    -o "%(uploader)s/%(upload_date)s-%(id)s/video.%(ext)s" 
    --write-info-json 
    --download-archive "$ARCHIVE" 
    --cookies-from-browser chrome 
    --dateafter "$(date -u -v-7d +%Y%m%d)" 
    --sleep-interval 2 
    --max-sleep-interval 5
done
echo "[$(date)] Done"

故障排查

调试模式

# 输出详细日志以诊断问题
yt-dlp -v "https://www.tiktok.com/@handle" 2>&1 | tee debug.log

参考文档

常用参数

输出模板变量

完整模板语法参考 →