使用 yt-dlp 自动下载公开 TikTok 账号的最新视频(或最近 N 个)。每当用户提及 TikTok 时使用此技能。
下载器 TikTok 视频
功能概述
下载器 TikTok 视频是一项面向实际任务的技能,主要用于Downloader TikTok Videos 从一个公众 TikTok. 账户下载最新视频(或多个视频);账户使用 yt- dlp;
核心要点
- 在 warin 之前完全读取此文档。
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
- 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
使用与执行
该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
结果检查与注意事项
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
下载 TikTok 视频
概述
“下载 TikTok 视频”功能使用 yt-dlp 从公开的 TikTok 账号中下载最新的一条(或多个)视频。在编写任何代码或运行命令前,请务必完整阅读本文档。
前提条件
本技能依赖 yt-dlp(如需音视频合并,可选安装 ffmpeg)。
⚠️ 以下命令会修改您的宿主环境(系统级安装软件包)。仅当尚未安装 yt-dlp,且您确认可执行系统级安装时,才运行这些命令。
pip install -U yt-dlp --break-system-packages # Linux 系统 Python # 或 pip install -U yt-dlp # virtualenv / macOS yt-dlp --version # 验证安装
操作类型
本技能支持四种操作类型。请根据用户需求判断适用哪一种(或多种):
- 快速下载 —— 下载账号最新发布的一条视频
- 批量下载 —— 下载最近 N 条视频
- 仅获取元数据 —— 仅提取视频信息/统计项,不下载视频文件
- 指定视频 URL 下载 —— 根据提供的具体视频链接进行下载
工作流
1. 快速下载 —— 从账号下载最新视频
适用场景: 用户提供了 @username 或个人主页 URL
步骤:
- 标准化用户名(若含
@符号则去除) - 构造个人主页 URL:
https://www.tiktok.com/@{username} - 获取最新视频的元数据(使用
--playlist-items 1 --no-download) - 向用户展示视频信息(标题、发布时间、时长)
- 使用最优命令执行下载
- 确认下载成功,并提供生成的文件路径
命令:
yt-dlp
--playlist-items 1
--format "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best"
--merge-output-format mp4
--output "./%(uploader_id)s_%(upload_date)s_%(id)s.%(ext)s"
"https://www.tiktok.com/@{username}"
验证结果:
ls -lh ./*.mp4
2. 批量下载 —— 下载最近 N 条视频
适用场景: 用户希望下载多条视频
步骤:
- 若未明确指定数量,则询问用户需下载多少条(默认为 5 条)
- 构造命令,添加
--playlist-items 1-{N} - 添加
--download-archive参数避免重复下载 - 启用进度输出并执行下载
- 列出已下载的文件
命令:
yt-dlp
--playlist-items 1-{N}
--format "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best"
--merge-output-format mp4
--download-archive ./tiktok_archive.txt
--output "./%(uploader_id)s/%(upload_date)s_%(id)s.%(ext)s"
"https://www.tiktok.com/@{username}"
3. 仅获取元数据
适用场景: 用户仅需查看视频信息,无需下载
参考: 查阅 references/metadata.md 获取所有可用字段及完整命令示例
快捷命令:
yt-dlp
--playlist-items 1
--skip-download
--write-info-json
--print "%(uploader_id)s | %(upload_date)s | %(duration)ss | %(view_count)s views | %(title)s"
"https://www.tiktok.com/@{username}"
4. 指定视频 URL 下载
适用场景: 用户提供了具体的视频 URL
命令:
yt-dlp
--format "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best"
--merge-output-format mp4
--output "./%(uploader_id)s_%(id)s.%(ext)s"
"{video_url}"
常见错误
| 错误 | 原因 | 修复方法 |
|---|---|---|
HTTP Error 403 |
TikTok 的请求频率限制 | 添加 --sleep-interval 3 --max-sleep-interval 6 |
Unable to extract |
yt-dlp 版本过旧 | pip install -U yt-dlp --break-system-packages |
Private account |
账号为私密状态 | 若已登录浏览器,可使用 --cookies-from-browser chrome(⚠️ 此操作导出的是有效会话 Cookie,请严格保密) |
No video formats |
地理区域限制 | 添加 --geo-bypass |
Sign in required |
内容受访问限制 | 通过 --cookies cookies.txt 提供 Cookie 文件(⚠️ 请将该文件视同密码妥善保管) |
Merge requires ffmpeg |
系统未安装 ffmpeg | apt-get install ffmpeg -y |
⚠️ Cookie 安全提示: 使用
--cookies-from-browser或cookies.txt导出的浏览器 Cookie 包含活跃会话令牌。切勿共享此类文件、将其提交至版本控制系统,或传递给不可信脚本。如不再需要,请及时删除。
用户名标准化
# 支持以下任意格式输入:
# @myaccount → myaccount
# myaccount → myaccount
# https://www.tiktok.com/@myaccount → myaccount
def normalize(input_str):
if "tiktok.com/@" in input_str:
return input_str.split("tiktok.com/@")[-1].split("/")[0]
return input_str.lstrip("@").strip()
参考文件
按需加载以下参考文档:
references/metadata.md
- 适用场景:获取元数据、处理 JSON 字段
- 内容:全部可用的 yt-dlp 字段说明、打印格式示例、JSON 导出方式
references/advanced.md
- 适用场景:去水印、Cookie 管理、代理配置、自定义请求头
- 内容:高级技巧、限制绕过方法、完整的 yt-dlp 参数列表
KBLICENSE.txt
- 适用场景:有关使用权限或服务条款的疑问
- 内容:使用条件、允许与禁止用途说明
输出规范
- 下载前始终先显示元数据(标题、发布时间、时长)
- 确认并告知最终生成的文件路径
- 显示下载完成后的文件大小
- 发生错误时,直接给出对应修复建议
示例查询
快速下载:
- "下载 @someaccount 的最新视频"
- "获取 myaccount 的最新 TikTok 动态"
- "下载 https://www.tiktok.com/@user 的最后一条视频"
批量下载:
- "下载 @user 最近的 5 条视频"
- "获取 @account 最近的 10 条视频"
元数据查询:
- "提供 @user 最新视频的详细信息"
- "@account 最后一条动态的标题和发布时间是什么?"
指定 URL 下载:
- "下载该 TikTok 视频:https://www.tiktok.com/@user/video/123456"
热门AI工具
相关专题
tiktok是由中国公司字节跳动推出的一款短视频社交媒体应用,在2016年下半年首次发布,tiktok主要在中国市场发展起来,并一度在国内取得了巨大的成功,随着时间的推移,tiktok开始在全球范围内推广,其中北美、欧洲和印度等地迅速增长。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。
9816
2025.01.17
tiktok是抖音的英文名称,于2018年8月在全球范围内推出,tiktok是一款社交媒体应用程序,它允许用户创建和分享短视频。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。
5316
2024.08.12
本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。
0
2026.11.20
本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。
0
2026.11.20
从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。
0
2026.11.20
本专题汇总PHP8.6数组与数据处理教程,涵盖CSV读取和导出、引用遍历删除、array_filter回调模式、配置键名冲突、pathinfo文件名校验、GMP大整数进制转换及UTF-8正则筛选,说明升级兼容变化、输入范围和失败处理方法。
0
2026.11.20
本专题汇总PHP8.6升级迁移与弃用接口改造教程,涵盖反射调用、对象属性赋值、标识符更名、构造函数与__debugInfo调整,以及插件类名检查、常量导出、ArrayIterator排序、SPL和DTO查询参数转换,帮助梳理弃用提示并完成代码兼容改造。
0
2026.11.20
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 162万人学习
共6课时 | 54.8万人学习
最新文章

