bulk TikTok downloader
Use this skill to run a local bulk TikTok downloader safely and reproducibly.
Safety + legality
- Download only content you are authorized to download.
- Respect platform Terms of Service, local copyright rules, and user privacy.
- Do not bypass paywalls or private/protected content.
Inputs
- URL list file (one URL per line)
- Optional output directory
Lines starting with # are comments and ignored.
Setup
From workspace root:
python3 -m pip install --user -r skills/bulk-tiktok-downloader/scripts/requirements.txt
Run
Default (uses urls.txt next to script and downloads/ output):
python3 skills/bulk-tiktok-downloader/scripts/downloader.py
Custom URL file:
python3 skills/bulk-tiktok-downloader/scripts/downloader.py my_urls.txt
Custom URL file + output directory:
python3 skills/bulk-tiktok-downloader/scripts/downloader.py my_urls.txt my_downloads
Recommended workflow
- Validate URL list file exists and is non-empty.
- Run downloader.
- Report successful vs failed counts.
- Surface failed URLs and likely reason (private/deleted/region restricted/rate limit).
Troubleshooting
No module named yt_dlp→ install requirements.File not found→ verify URL file path.- Frequent failures/rate limit → reduce batch size and retry later.
Upstream reference
See:
- skills/bulk-tiktok-downloader/references/upstream-readme.md
