使用 yt-dlp 自动下载公开 TikTok 账号的最新视频(或最近 N 个)。每当用户提及 TikTok 时使用此技能。
下载器 TikTok 视频是一项面向实际任务的技能,主要用于Downloader TikTok Videos 从一个公众 TikTok. 账户下载最新视频(或多个视频);账户使用 yt- dlp;
该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
“下载 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 # 验证安装
本技能支持四种操作类型。请根据用户需求判断适用哪一种(或多种):
适用场景: 用户提供了 @username 或个人主页 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
适用场景: 用户希望下载多条视频
步骤:
--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}"
适用场景: 用户仅需查看视频信息,无需下载
参考: 查阅 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}"
适用场景: 用户提供了具体的视频 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
references/advanced.md
KBLICENSE.txt
快速下载:
批量下载:
元数据查询:
指定 URL 下载:
相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.3万人学习
共49课时 | 82.7万人学习
最新文章