TikTok下载器 - 使用yt-dlp下载视频、封面和截图，支持音频提取

tiktok-downloader by anyt-io/notebook

1 周安装量

9 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/anyt-io/notebook --skill tiktok-downloader

内容创作自动化命令行工具

🇨🇳中文介绍

TikTok 下载器

使用 yt-dlp 下载 TikTok 视频、封面图片并截取屏幕截图。

先决条件

uv (Python 包管理器)
ffmpeg: brew install ffmpeg

下载视频

从技能文件夹 (skills/tiktok-downloader/) 运行：

uv run --project runtime runtime/download_video.py "URL" [options]

标志	描述	默认值
`-o, --output`

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

Azure RBAC 权限管理工具：查找最小角色、创建自定义角色与自动化分配

117,000 周安装

Skills CLI 使用指南：AI Agent 技能包管理器安装与管理教程

31,600 周安装

README 国际化工具：自动化翻译与多语言文档管理 | readme-i18n

30,900 周安装

# 下载视频
uv run --project runtime runtime/download_video.py "https://www.tiktok.com/@user/video/1234567890"

# 仅下载音频
uv run --project runtime runtime/download_video.py "https://www.tiktok.com/@user/video/1234567890" -a

# 自定义输出目录和格式
uv run --project runtime runtime/download_video.py "https://www.tiktok.com/@user/video/1234567890" -o downloads/ -f mkv

标志	描述	默认值
`-o, --output`	输出目录	`output/`
`-n, --name`	自定义文件名（不含扩展名）	视频 ID

标志	描述	默认值
`-t, --timestamps`	逗号分隔的时间：秒、M:SS 或 H:MM:SS	必需
`-o, --output`	输出目录	`output/`
`-p, --prefix`	截图文件名的前缀	`frame`
`-q, --quality`	JPEG 质量 (1=最佳, 31=最差)	`2`

🇺🇸English

TikTok Downloader

Download TikTok videos, cover images, and capture screenshots using yt-dlp.

Prerequisites

uv (Python package manager)
ffmpeg: brew install ffmpeg

Download Video

Run from the skill folder (skills/tiktok-downloader/):

uv run --project runtime runtime/download_video.py "URL" [options]

Flag	Description	Default
`-o, --output`	Output directory	`output/`
`-f, --format`	mp4, webm, mkv	`mp4`
`-a, --audio-only`	Extract audio as MP3	`false`

Examples

# Download video
uv run --project runtime runtime/download_video.py "https://www.tiktok.com/@user/video/1234567890"

# Download as audio only
uv run --project runtime runtime/download_video.py "https://www.tiktok.com/@user/video/1234567890" -a

# Custom output directory and format
uv run --project runtime runtime/download_video.py "https://www.tiktok.com/@user/video/1234567890" -o downloads/ -f mkv

Download Cover Image

uv run --project runtime runtime/download_cover.py "URL" [options]

Flag	Description	Default
`-o, --output`	Output directory	`output/`
`-n, --name`	Custom filename (without extension)	video ID

Downloads the thumbnail/cover image of a TikTok video. The file extension is detected automatically.

Capture Screenshots

Capture frame images at specific timestamps without downloading the full video.

uv run --project runtime runtime/screenshot_video.py "URL" -t "TIMESTAMPS" [options]

Flag	Description	Default
`-t, --timestamps`	Comma-separated times: seconds, M:SS, or H:MM:SS	required
`-o, --output`	Output directory	`output/`
`-p, --prefix`	Filename prefix for screenshots	`frame`
`-q, --quality`	JPEG quality (1=best, 31=worst)

Output files are named <prefix>_001.jpg, <prefix>_002.jpg, etc. A manifest.json is also written with metadata.

Supported URL Formats

https://www.tiktok.com/@user/video/ID
https://vm.tiktok.com/SHORTCODE/
https://m.tiktok.com/v/ID

Output

Default output directory: output/ inside the skill folder.
Videos are saved as MP4 by default.
Cover images use auto-detected extension (.jpg, .png, .webp).

Limitations

Single video only (not user profiles or playlists)
Screenshots require ffmpeg
Some regions or videos may require cookies for access
TikTok videos are typically short (15s–10min)

Weekly Installs

Repository

anyt-io/notebook

GitHub Stars

First Seen

1 day ago

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

mcpjam1

github-copilot1

junie1

windsurf1

zencoder1

crush1