with one click
tiktok-music-archive-downloader
// Download TikTok video samples for selected music or sounds, extract local audio references, and preserve manifests for reproducible music research archives.
// Download TikTok video samples for selected music or sounds, extract local audio references, and preserve manifests for reproducible music research archives.
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | tiktok-music-archive-downloader |
| description | Download TikTok video samples for selected music or sounds, extract local audio references, and preserve manifests for reproducible music research archives. |
| metadata | {"postplus":{"familyId":"tiktok","familyName":"TikTok"}} |
Follow shared public skill rules in:
postplus-shared public skill rulesUse this skill when TikTok music or sound candidates have already been selected and the user needs local files.
Good fits:
Do not use this skill for:
postplus-shared TikTok music workflowExpected inputs usually come from:
Use the shared TikTok downloader:
node ${CLAUDE_SKILL_DIR}/_postplus_shared/00-core/shared-runtime/scripts/download_videos_from_manifest_with_ytdlp.mjs \
--manifest <download-manifest.json> \
--output-dir <videos-dir> \
--report <download-report.json> \
--concurrency 2 \
--attempts 3
The manifest should contain:
{
"items": [
{
"sourceId": "musicid-videoid",
"sourceUrl": "https://www.tiktok.com/@user/video/123"
}
]
}
When the upstream normalized dataset includes both postPageUrl and direct
video fields, prefer the canonical TikTok post page URL for sourceUrl.
That keeps yt_dlp on the stable page surface instead of an expiring CDN URL.
After videos are downloaded, extract audio with ffmpeg.
Prefer m4a for compact review assets:
ffmpeg -y -i <video.mp4> -vn -c:a aac -b:a 192k <audio.m4a>
Use wav only when a downstream model or editor needs uncompressed audio:
ffmpeg -y -i <video.mp4> -vn -ac 1 -ar 48000 <audio.wav>
Use a stable layout:
<work-folder>/.postplus/tiktok-music-archive-downloader/<run-id>/
manifest/
download-manifest.json
download-report.json
videos/
audio/
index.json
index.json should link every local file back to:
musicIdmusicTitlesourceVideoUrlsourceCollectionPathBefore reporting success:
../audio-transcription/SKILL.md or ../video-transcription/SKILL.md../subtitle-packager/SKILL.mdTreat downloaded TikTok music as research/reference material unless the user confirms rights or platform-licensed use. Do not present extracted audio as cleared for commercial reuse.
<work-folder>/.postplus/tiktok-music-archive-downloader/.postplus/python3 with yt_dlpffmpegpostplus-shared Local Dependency Bootstrap Rule before the first
download or extraction