SuperAPI AI 工具集

bggg-tiktok-downloader

通用与其它

查看项目

更新于 10-15 20:06

技能介绍

用途:把 TikTok 视频下载到本地项目目录,支持单个作品与博主主页批量下载。

主要能力:优先使用随技能捆绑的脚本 python3 bggg-tiktok-downloader/scripts/download_tiktok.py "<TikTok URL>"。脚本用 yt-dlp 处理单视频和博主列表;单视频在 yt-dlp 不可用或失败时用 tikwm 兜底。含 /video/ 或 /photo/ 的链接按单个作品处理,https://www.tiktok.com/@username 主页按博主处理。可用 --limit N 下载指定数量,--limit 0 或只给博主链接且无数量时表示不限制。默认输出到技能下 projects/downloads/tiktok,可用 --output-dir 指定。支持 --thumbnail 下载缩略图;需要登录态时可 --cookies-browser chrome 使用浏览器 Cookie。若设置 TIKTOKDOWNLOADER_ROOT 或传 --tiktokdownloader-root,会尝试引用本地 TikTokDownloader 的链接识别规则,无该目录也可运行。

使用方式:运行后查看 JSON 输出中的 manifestPath、itemCount 和 items[].filePath;如后续要转写音轨,把输出视频目录交给 bggg-tiktok-readvideo。输出目录内会生成 .bggg-tiktok-download-archive.txt 跳过重复视频,以及 download_manifest.json 记录结果。

适用场景:用户给出 TikTok 单视频链接、分享链接、链接文本、博主主页或 @handle,要求下载、保存、抓取、批量下载、下载博主作品、下载指定数量或全部作品时使用。

限制与注意:只下载用户有权保存和处理的内容;遇到私密账号、地区限制或风控时需用户提供可用 Cookie。作者批量下载依赖 yt-dlp,单视频可走 tikwm 兜底。不要提交 Cookie 文件、浏览器 profile、下载结果、.info.json 或采集 manifest 到公开仓库。更多实现细节按需读取 references/implementation-notes.md。