bulk-tiktok-downloader

TotalClaw 作者 totalclaw

使用 yt-dlp 从 URL 文本文件批量下载 TikTok 视频。当用户要求一次下载多个 TikTok 视频、处理 URL 列表文件或从本地终端将 TikTok 视频保存到特定文件夹时使用。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~mes28io-bulk-tiktok-downloader-skill

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~mes28io-bulk-tiktok-downloader-skill/file -o mes28io-bulk-tiktok-downloader-skill.md

## 概述（中文）

## 原文

# 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:

```bash
python3 -m pip install --user -r skills/bulk-tiktok-downloader/scripts/requirements.txt
```

## Run

Default (uses `urls.txt` next to script and `downloads/` output):

```bash
python3 skills/bulk-tiktok-downloader/scripts/downloader.py
```

Custom URL file:

```bash
python3 skills/bulk-tiktok-downloader/scripts/downloader.py my_urls.txt
```

Custom URL file + output directory:

```bash
python3 skills/bulk-tiktok-downloader/scripts/downloader.py my_urls.txt my_downloads
```

## Recommended workflow

1. Validate URL list file exists and is non-empty.
2. Run downloader.
3. Report successful vs failed counts.
4. 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`