SuperAPI AI 工具集

tiktok-music-archive-downloader

设计与创作

查看项目

更新于 10-16 09:51

技能介绍

用途:该技能用于在 TikTok 音乐或声音候选已选定后,下载对应的视频样本、提取本地音频引用,并生成可复现的归档 manifest,服务于音乐研究或素材参考。它不负责发现热门音乐,也不提供托管元数据采集,更不判断音频是否已获公开使用授权。

主要能力:从选定的视频或声音构建有界 manifest;运行共享下载器获取视频;用 ffmpeg 从成功下载的文件提取音频;生成 index.json,关联本地文件与 musicId、musicTitle、sourceVideoUrl、来源集合路径、下载状态及本地视频/音频路径。

使用方式:需准备含 TikTok 帖子页面 URL 的小型下载 manifest、本地依赖 python3(含 yt_dlp)与 ffmpeg,以及用于写入归档的工作目录(位于 .postplus/ 下)。当上游数据同时含 postPageUrl 与直链视频字段时,sourceUrl 优先使用规范的 TikTok 帖子页面 URL。默认工作流先构建有界 manifest,再运行共享下载器,参数包括 --manifest <download-manifest.json>、--output-dir <videos-dir>、--report <download-report.json>、--concurrency 2、--attempts 3。遇到下载阻塞应先停止,不要进入音频提取。归档目录为 <work-folder>/.postplus/tiktok-music-archive-downloader/<run-id>/,含 manifest/、videos/、audio/、index.json。

适用场景:已选定 TikTok 音乐/声音候选,需要本地样本、音频引用与可复现归档的音乐研究。

限制:仅在用户当前本地浏览器/IP 环境可访问 TikTok 帖子 URL 时支持下载;本地工具是必要条件但非充分条件,IP、浏览器访问、登录或 cookies 受限仍可能失败。若报告含 failureCode: "tiktok_ip_blocked",应报告阻塞并保留 sourceUrl、stderr 和报告路径,不要重试大批量下载、切换代理或自行构造 cookie/浏览器引导路径。下载的 TikTok 音乐除用户确认权利或平台授权外,仅作研究或参考材料,不得当作已获商业复用许可。需验证文件与音频存在且非空,失败需单独报告,下载失败仍保留来源 URL。其他相关需求可转交 tiktok-research、video-analysis、audio-transcription 或 video-transcription。