Agent skill

Bggg Tiktok Downloader

by binggandata in binggandata/bggg-skills

下载 TikTok 视频到本地。当用户给出 TikTok 单个视频链接、分享链接、视频链接文本、 TikTok 博主主页链接、@handle,并要求下载、保存、抓取、批量下载、下载博主作品、 下载指定数量或下载全部作品时,使用此 skill。优先用 yt-dlp,单视频下载失败时用 tikwm 兜底; 可选引用本地 TikTokDownloader 作为链接类型识别辅助。

MITAuto-check passed

Install Bggg Tiktok Downloader

skills CLI
$ npx skills add binggandata/bggg-skills --skill bggg-tiktok-downloader -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install binggandata/bggg-skills bggg-tiktok-downloader --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/binggandata/bggg-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/bggg-tiktok-downloader .claude/skills/bggg-tiktok-downloader && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bggg-tiktok-downloader
GitHub stars
605
Token cost
~494 tokens
SKILL.md length
90 words
Files
7 (incl. scripts, references)
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

下载 TikTok 视频到本地。当用户给出 TikTok 单个视频链接、分享链接、视频链接文本、 TikTok 博主主页链接、@handle,并要求下载、保存、抓取、批量下载、下载博主作品、 下载指定数量或下载全部作品时,使用此 skill。优先用 yt-dlp,单视频下载失败时用 tikwm 兜底; 可选引用本地 TikTokDownloader 作为链接类型识别辅助。

  • Works in 4 steps: 识别输入类型 → 选择输出目录。默认是本 skill 下的… → 运行脚本并查看 JSON 输出里的 manifestPath、itemCount… → …
  • SKILL.md covers 目标, 工作流, 常用命令 and 注意事项
  • Runs Python scripts from its folder; calls python3; reaches tiktok.com

What it does

Bggg Tiktok Downloader is an agent skill from binggandata/bggg-skills. 下载 TikTok 视频到本地。当用户给出 TikTok 单个视频链接、分享链接、视频链接文本、 TikTok 博主主页链接、@handle,并要求下载、保存、抓取、批量下载、下载博主作品、 下载指定数量或下载全部作品时,使用此 skill。优先用 yt-dlp,单视频下载失败时用 tikwm 兜底; 可选引用本地 TikTokDownloader 作为链接类型识别辅助。

Its SKILL.md is about 490 tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including scripts and reference files (for example `README.md`, `README_EN.md` and `evals/evals.json`).

It works with TikTok. The repository describes itself as: Open-source Codex skills from BGGG. The licence is MIT.

Example prompts

  • “/bggg-tiktok-downloader”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. 识别输入类型
  2. 选择输出目录。默认是本 skill 下的 projects/downloads/tiktok;用户指定目录时传 --output-dir。
  3. 运行脚本并查看 JSON 输出里的 manifestPath、itemCount 和 items[].filePath。
  4. 如果后续要转写音轨,把输出的视频目录交给 bggg-tiktok-readvideo。

What it can do on your machine

Read from SKILL.md and the folder at commit 1034ee5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • tiktok.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Bggg Tiktok Downloader loads about 494 tokens when it runs, and up to ~802 if it reads all its reference files. Until then it costs about 53 tokens; SKILL.md has 90 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~53
When it runs · the whole SKILL.md, loaded when a task matches
~494
With references · SKILL.md plus every file in references/, read only if the agent opens them
~802

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from binggandata/bggg-skills at commit 1034ee5, republished under its MIT licence (© binggandata). 90 words, ~494 tokens.

Download SKILL.mdSave it as .claude/skills/bggg-tiktok-downloader/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
bggg-tiktok-downloader
description
下载 TikTok 视频到本地。当用户给出 TikTok 单个视频链接、分享链接、视频链接文本、 TikTok 博主主页链接、@handle,并要求下载、保存、抓取、批量下载、下载博主作品、 下载指定数量或下载全部作品时,使用此 skill。优先用 yt-dlp,单视频下载失败时用 tikwm 兜底; 可选引用本地 TikTokDownloader 作为链接类型识别辅助。

BGGG TikTok Downloader

目标

把 TikTok 视频下载到本地项目目录。优先使用随 skill 捆绑的确定性脚本:

bash
python3 bggg-tiktok-downloader/scripts/download_tiktok.py "<TikTok URL>"

脚本优先使用 yt-dlp 负责单视频和博主列表下载;单视频在 yt-dlp 不可用或失败时使用 tikwm 兜底。若设置 TIKTOKDOWNLOADER_ROOT 或传 --tiktokdownloader-root,脚本会尝试引用本地 TikTokDownloader 的链接识别规则;没有该目录也可以运行。

工作流

  1. 识别输入类型:
    • 包含 /video/ 或 /photo/ 的 TikTok 链接按单个作品处理。
    • https://www.tiktok.com/@username 这类主页链接按博主处理。
    • 用户指定“下载 N 条/前 N 个/最新 N 个”时传 --limit N。
    • 用户说“全部”或只给博主链接且无数量时传 --limit 0,表示不限制数量。
  2. 选择输出目录。默认是本 skill 下的 projects/downloads/tiktok;用户指定目录时传 --output-dir。
  3. 运行脚本并查看 JSON 输出里的 manifestPath、itemCount 和 items[].filePath。
  4. 如果后续要转写音轨,把输出的视频目录交给 bggg-tiktok-readvideo。

常用命令

下载单个视频:

bash
python3 bggg-tiktok-downloader/scripts/download_tiktok.py "https://www.tiktok.com/@user/video/1234567890123456789" --thumbnail

下载某博主前 30 个视频:

bash
python3 bggg-tiktok-downloader/scripts/download_tiktok.py "https://www.tiktok.com/@user" --mode author --limit 30 --thumbnail

下载某博主全部可见视频:

bash
python3 bggg-tiktok-downloader/scripts/download_tiktok.py "https://www.tiktok.com/@user" --mode author --limit 0 --thumbnail

需要登录态时,可以显式使用浏览器 Cookie:

bash
python3 bggg-tiktok-downloader/scripts/download_tiktok.py "https://www.tiktok.com/@user" --mode author --limit 20 --cookies-browser chrome

注意事项

  • 只下载用户有权保存和处理的内容。遇到私密账号、地区限制或风控时,需要用户提供可用 Cookie。
  • 不要提交 Cookie 文件、浏览器 profile、下载结果、.info.json 或采集 manifest 到公开仓库。
  • 作者批量下载依赖 yt-dlp;单视频可走 tikwm 兜底。
  • 输出目录内会生成 .bggg-tiktok-download-archive.txt 跳过重复视频,以及 download_manifest.json 记录结果。

更多实现细节按需读取 references/implementation-notes.md。

© binggandata, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (scripts, references) in bggg-tiktok-downloader of binggandata/bggg-skills.

  • SKILL.md
  • README.md
  • README_EN.md
  • evals/evals.json
  • projects/.gitkeep
  • references/implementation-notes.md
  • scripts/download_tiktok.py

Open the folder on GitHubat commit 1034ee5

Compare with similar skills

Bggg Tiktok Downloader next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Bggg Tiktok Downloader compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bggg Tiktok Downloader this skillbinggandata/bggg-skills605—~494Automated safety check: PassMIT
Socialcoreyhaines31/marketingskills54k4 repos~4.5kAutomated safety check: PassMIT
Last30daysmvanhorn/last30days-skill64k—~7.9kAutomated safety check: NotesMIT
Social Contentfreekmurze/dotfiles1k23 repos~2.1kAutomated safety check: PassNone
Video Transcribewendy7756/AI-Video-Transcriber3.3k—~937Automated safety check: NotesApache-2.0
Last30days CnJesseovo/last30days-skill-cn1.9k—~2.4kAutomated safety check: NotesMIT

Similar skills

  • Social

    coreyhaines31/marketingskills

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, or Facebook, or wants to do social listening and engagement triage.

    54k GitHub starsUsed in 4 repos~4.5k tokens
    Writing & ContentAuto-check passed
  • Last30days

    mvanhorn/last30days-skill

    Research what people actually say about any topic in the last 30 days.

    64k GitHub stars~7.9k tokensUpdated yesterday
    Research & ScienceAuto-check: notes
  • Social Content

    freekmurze/dotfiles

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms.

    1k GitHub starsUsed in 23 repos~2.1k tokens
    Writing & ContentAuto-check passed
  • Video Transcribe

    wendy7756/AI-Video-Transcriber

    Transcribe and summarize a video or podcast from a URL (YouTube, TikTok, Bilibili, Apple Podcasts, SoundCloud, 30+ platforms) or from a local media/.txt file.

    3.3k GitHub stars~937 tokensUpdated 26 days ago
    Media & CreativeAuto-check: notes
  • Last30days Cn

    Jesseovo/last30days-skill-cn

    Research what Chinese internet users actually said in the last 30 days across Weibo, Xiaohongshu (RED), Bilibili, Zhihu, Douyin, WeChat public accounts, Baidu and Toutiao: engagement-weighted…

    1.9k GitHub stars~2.4k tokensUpdated 4 days ago
    Productivity & AutomationAuto-check: notes
  • Postiz

    gitroomhq/postiz-agent

    Postiz is a tool to schedule social media and chat posts to 28+ channels X, LinkedIn, LinkedIn Page, Reddit, Instagram, Facebook Page, Threads, YouTube, Google My Business, TikTok, Pinterest…

    508 GitHub starsUsed in 2 repos~7.9k tokens
    Writing & ContentAuto-check passed

More from binggandata/bggg-skills

All 13 skills in this repo
  • Bggg Data Amazon

    binggandata/bggg-skills

    Collect Amazon.com written product reviews at scale through Woot's public review AJAX route, retain every attempt and error log, reconcile partial runs, and normalize exact review text into…

    605 GitHub stars~1.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Bggg Data Reddit

    binggandata/bggg-skills

    Collect auditable Reddit search results and full comment trees at scale, preserve the source JSON, and normalize posts and comments into analysis-ready JSONL.

    605 GitHub stars~1.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Bggg Data X

    binggandata/bggg-skills

    Collect auditable public X/Twitter posts by controlling the user's already logged-in Chrome, searching X's rendered web interface, scrolling visible results, and extracting original post text and…

    605 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Ngs Amazon Image Studio

    binggandata/bggg-skills

    Generate Amazon and cross-border ecommerce product images from a product business card.

    605 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Bggg Tiktok Capcut

    binggandata/bggg-skills

    通用 CapCut 草稿生成与 AI 视频检查 skill。用于把本地 AI 视频套用现有 CapCut 草稿模板, 生成可在 CapCut 首页显示并可编辑的新草稿;也用于提取模板样式、验证草稿结构、抽帧检查 AI 痕迹、规划修复窗口和做本地 RIFE 补帧。

    605 GitHub stars~854 tokensUpdated 1 mo ago
    Auto-check passed
  • Bggg Tiktok Cut

    binggandata/bggg-skills

    用于把 AI 生成的视频、本地素材、口播素材或产品短片剪成可发布到 TikTok 的竖屏成片. An agent skill from binggandata/bggg-skills.

    605 GitHub stars~954 tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Bggg Tiktok Downloader

What does Bggg Tiktok Downloader do?

下载 TikTok 视频到本地。当用户给出 TikTok 单个视频链接、分享链接、视频链接文本、 TikTok 博主主页链接、@handle,并要求下载、保存、抓取、批量下载、下载博主作品、 下载指定数量或下载全部作品时,使用此 skill。优先用 yt-dlp,单视频下载失败时用 tikwm 兜底; 可选引用本地 TikTokDownloader 作为链接类型识别辅助。. Bggg Tiktok Downloader is an agent skill from binggandata/bggg-skills.

How do I install Bggg Tiktok Downloader in Claude Code?

Run `npx skills add binggandata/bggg-skills --skill bggg-tiktok-downloader -a claude-code`. Or copy the skill folder (bggg-tiktok-downloader in binggandata/bggg-skills) into .claude/skills/bggg-tiktok-downloader in your project. Claude Code loads it when a task matches its description.

How do I install Bggg Tiktok Downloader in Codex?

Run `npx skills add binggandata/bggg-skills --skill bggg-tiktok-downloader -a codex`. Or copy the skill folder (bggg-tiktok-downloader in binggandata/bggg-skills) into .agents/skills/bggg-tiktok-downloader in your project. Codex loads it when a task matches its description.

Can I use Bggg Tiktok Downloader in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add binggandata/bggg-skills --skill bggg-tiktok-downloader -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bggg-tiktok-downloader, .gemini/skills/bggg-tiktok-downloader, .github/skills/bggg-tiktok-downloader and .opencode/skills/bggg-tiktok-downloader in your project.

What does Bggg Tiktok Downloader need to run?

Going by SKILL.md and its folder, Bggg Tiktok Downloader needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Bggg Tiktok Downloader access the network?

SKILL.md names 1 domain. In commands or code: tiktok.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Bggg Tiktok Downloader safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Bggg Tiktok Downloader use?

Bggg Tiktok Downloader is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bggg Tiktok Downloader use?

About 494 tokens (SKILL.md is roughly 2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 308 tokens, read only when the agent opens those files.

What are the alternatives to Bggg Tiktok Downloader?

Skills that share tags, products or a category with Bggg Tiktok Downloader: Social (coreyhaines31/marketingskills, 54k stars), Last30days (mvanhorn/last30days-skill, 64k stars), Social Content (freekmurze/dotfiles, 1k stars) and Video Transcribe (wendy7756/AI-Video-Transcriber, 3.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bggg Tiktok Downloader?

binggandata (a GitHub user) maintains it in binggandata/bggg-skills, which has 605 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on August 13, 2026.

Source: binggandata/bggg-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.