本文へ移動
cccskills
無料GitHub で公開

tiktok-home-downloader

TikTok主页视频批量提取 — 输入TikTok主页链接/handle,自动拉取账号主页全部作品并解析无水印下载链接,支持批量一键下载到本地。

适用场景:竞品账号内容拆解与逐帧学习、收藏喜欢的创作者全部作品避免被删、批量搬运素材二次剪辑创作、保存自己账号作品做本地备份防丢失、课程/教程类视频离线囤货反复看、甲方要求提供无水印源文件、达人合作前快速拉取对方作品做背调分析。

触发词:TikTok主页下载、TikTok视频下载、TikTok批量下载、TikTok无水印下载、下载TikTok作品、TikTok账号视频提取、TikTok主页视频批量提取、TikTok去水印、TikTok视频备份、竞品视频下载。

インストール方法を見る

含まれるファイル(5)

  • SKILL.md9.6 KB
  • README.en.md5.5 KB
  • README.md5.2 KB
  • references/core_workflow.md6.8 KB
  • scripts/tiktok-home-downloader.py44.5 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

TikTok 主页视频批量提取

输入 TikTok 主页链接 → 拉取主页作品列表 → 解析下载链接 → 一键下载到本地


简介

TikTok 账号主页视频批量提取工具。只需提供 TikTok 账号主页链接,自动拉取该账号主页作品列表,逐条解析无水印视频下载直链,支持一键批量下载到本地。

适用对象

  • 🎬 内容创作者 — 收藏学习竞品账号的优质内容,逐帧拆解拍摄与剪辑技巧。
  • 📦 运营 / MCN — 批量备份达人合作作品,快速完成背调分析。
  • 🎓 知识学习者 — 离线囤积教程类视频,随时反复观看。

功能特性

功能说明
📋 作品拉取通过主页链接/handle 获取账号主页作品(标题、互动数据、作品链接)
🔗 链接解析逐条获取视频无水印下载直链
📥 批量下载一键下载全部作品到本地 output/ 目录
📊 数据展示Markdown 表格 / JSON 双格式输出,含播放量等完整互动数据
📄 分页翻页支持翻页查看更多作品
📅 日期筛选可按作品发布时间挑选
⚡ 速率保护内置请求间隔,避免触发频率限制

使用指南

鉴权(使用前必读)

本技能调用 redfox.hk 接口,需要先获取 API Key。

前往 红狐hub 获取 API Key。

# 环境变量配置(推荐)
export REDFOX_API_KEY=ak_你的密钥

# Windows PowerShell
$env:REDFOX_API_KEY="ak_你的密钥"

secUserId 获取方式(账号标识获取指南)

secUserId 是 TikTok 内部用于标识账号的字符串,固定以 MS4w 开头(如 MS4wLjABAAAA...,通常 40~60 个字符)。当主页链接 / handle 无法解析(如网络受限、页面反爬)时,提供 secUserId 可直接查询。获取方式如下:

方法一:手机 App 分享链接(最简单,推荐)

  1. 打开手机 TikTok App,搜索并进入目标账号主页
  2. 点右上角「···」或分享图标 → 选择「分享」→ 点击「复制链接」
  3. 粘贴出来检查:分享链接中带有 sec_uid=MS4w... 参数,形如: https://www.tiktok.com/@xxx?sec_uid=MS4wLjABAAAA...&...
  4. 把完整分享链接直接提供给技能即可,技能会自动提取其中的 secUserId

⚠️ 注意:分享链接必须带有 sec_uid=MS4w... 参数。普通主页链接(如 https://www.tiktok.com/@tiktok,链接中不含 sec_uid= 参数)需要访问 TikTok 页面才能解析,可能因网络受限或反爬而失败;带 sec_uid 参数的分享链接则可以直接查询,成功率最高。

方法二:浏览器开发者工具一键提取

  1. 打开账号主页后按 F12 打开开发者工具
  2. 切换到 Console(控制台) 标签页
  3. 粘贴以下代码并回车,会直接打印出该账号的 secUserId:
JSON.parse(document.getElementById('__UNIVERSAL_DATA_FOR_REHYDRATION__').textContent).__DEFAULT_SCOPE__['webapp.user-detail'].userInfo.user.secUid

常见问题

  • 复制的 secUserId 不完整? 请确认以 MS4w 开头且整串完整复制,中途截断会查询失败。
  • 分享链接里没有 sec_uid= 参数? 说明复制的不是标准分享链接,请重新通过「分享 → 复制链接」获取,或改用方法二。

核心执行流程、数据规则与接口说明详见 references/core_workflow.md

一键安装

本技能为标准 Skill 文件包,兼容所有支持 Skill 机制的 AI Agent 平台。

平台安装方式
Qoder将本技能目录放入 .qoder/skills/ 后重启
OpenClaw将本技能目录放入对应 skills 目录后重启
WorkBuddy将本技能目录放入对应 skills 目录后重启
Codex将本技能目录放入对应 skills 目录后重启
Claude Code将本技能目录放入 ~/.claude/skills/ 后重启

CLI 命令行

# 基础用法:拉取作品并解析下载链接(不下载文件)
python3 "$SKILL_PATH/scripts/tiktok-home-downloader.py" --account "https://www.tiktok.com/@tiktok"

# 也可以直接输入 @handle
python3 "$SKILL_PATH/scripts/tiktok-home-downloader.py" --account "@tiktok"

# 下载视频到本地
python3 "$SKILL_PATH/scripts/tiktok-home-downloader.py" --account "@tiktok" --download

# 指定下载目录
python3 "$SKILL_PATH/scripts/tiktok-home-downloader.py" --account "@tiktok" --download --output-dir ./my_videos

# JSON 格式输出
python3 "$SKILL_PATH/scripts/tiktok-home-downloader.py" --account "@tiktok" --json

# 多账号(逗号分隔)
python3 "$SKILL_PATH/scripts/tiktok-home-downloader.py" --accounts "@tiktok,@khaby.lame" --download

# 指定每页作品数量(默认10,最多50)
python3 "$SKILL_PATH/scripts/tiktok-home-downloader.py" --account "@tiktok" --count 20 --download

# 翻页查看更多作品
python3 "$SKILL_PATH/scripts/tiktok-home-downloader.py" --account "@tiktok" --page 2

# 按日期范围筛选作品
python3 "$SKILL_PATH/scripts/tiktok-home-downloader.py" --account "@tiktok" --date-start 2026-07-01 --date-end 2026-07-31

# 组合使用:第2页 + 日期过滤 + 下载
python3 "$SKILL_PATH/scripts/tiktok-home-downloader.py" --account "@tiktok" --page 2 --count 20 --date-start 2026-06-01 --download

参数说明

参数说明
--account单个 TikTok 账号(主页链接 / secUserId)
--accounts多个 TikTok 账号,逗号分隔
--count每页作品数量(默认10,最多50)
--page页码(默认1)
--date-start起始日期 YYYY-MM-DD
--date-end结束日期 YYYY-MM-DD
--download下载视频文件到本地
--output-dir下载目录(默认 output/)
--jsonJSON 格式输出
--rate-limit请求间隔秒数(默认 1.0)
--api-key指定 API Key

依赖

依赖安装命令
requestspip3 install requests

TikTok 账号输入要求

作品拉取接口通过 secUserId 查询。脚本支持三种输入,会自动解析:

  1. 主页链接(推荐):如 https://www.tiktok.com/@tiktok,脚本会自动从页面解析出账号标识
  2. @handle:如 @tiktok、@khaby.lame,即主页链接中 @ 后面的部分
  3. secUserId:MS4w 开头的长串,可直接使用

重要: 若用户只输入账号名称(如"甲亢哥""Khaby Lame")而未提供主页链接或 handle,必须提示:

"TikTok 账号名称存在多个重名情况,请提供准确的TikTok 主页链接(如 https://www.tiktok.com/@tiktok)或主页 URL 中的 handle(如 @tiktok)以便精准查询。"

handle 是 TikTok 账号主页链接中 @ 后面的部分,非中文昵称。

注意: 若用户输入的是单条视频链接(链接中含 /video/),需提示本技能用于提取账号主页全部作品,请改为提供账号主页链接。

重要: 若用户输入的 secUserId 不正确(不以 MS4w 开头、长度过短或格式错误),必须将「secUserId 获取方式」章节的完整获取指引返回给用户,引导用户按方法重新获取后再查询,不要直接报错结束。

重要: 若用户提供的是普通主页链接(如 https://www.tiktok.com/@tiktok,链接中不含 sec_uid= 参数)或 @handle,必须提示用户:

"分享链接需要带上 sec_uid=MS4w... 参数:请在手机 TikTok App 中进入该账号主页 →「分享」→「复制链接」,带 sec_uid 参数的分享链接可以直接查询,成功率更高。"

原因:普通主页链接 / handle 需要访问 TikTok 页面解析账号标识,可能因网络受限或反爬失败;带 sec_uid=MS4w... 参数的分享链接无需访问页面即可直接查询。


常见问题

Q:如何获取 API Key? A:前往 redfox.hk 注册获取。

Q:下载的视频有水印吗? A:无水印。解析后的视频直链已去除 TikTok 水印。

Q:支持哪些账号输入格式? A:支持三种:① 主页链接(如 https://www.tiktok.com/@tiktok);② @handle(如 @tiktok);③ secUserId(MS4w 开头的长串)。

Q:为什么主页链接解析失败? A:部分地区的 TikTok 页面存在访问限制或反爬,脚本无法从页面提取账号标识。此时可让账号本人在主页"分享→复制链接"重新提供,或直接提供 secUserId。

Q:为什么提示「调用频率超限」? A:请求过快触发了限流。可增加 --rate-limit 2.0 延长间隔。

Q:图文作品能下载吗? A:可以。图文作品(photo 类型)会自动下载首张无水印图片,格式为 JPG/PNG/WebP。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

多平台账号主页视频提取器 — 输入平台名称和账号id/链接,自动拉取抖音/快手/B站/YouTube 四大平台主页作品,解析下载链接,支持批量下载。适用场景:竞品账号内容拆解与逐帧学习、收藏喜欢的创作者全部作品避免被删、批量搬运素材二次剪辑创作、保存自己账号作品做本地备份防丢失、课程/教程类视频离线囤货反复看、达人合作前快速拉取对方作品做背调分析。触发词:主页视频下载、批量下载视频、账号视频提取、快手主页下载、B站视频提取、YouTube频道下载、视频保存、无水印下载、竞品视频下载、博主视频备份。

日本語の概要は準備中です。原文の説明を表示しています。

redfox-data/redfox-community4302026年10月12日 更新

深度A股情报调查与分析工具,支持A股情报调查、竞品分析、舆情监测、人物背景调查、信息交叉验证,生成结构化调查报告。当用户需要调查A股公司/行业/概念、调查竞品、追踪热点事件、了解人物背景、验证信息真实性时使用。触发词:A股情报、股票调查、财报分析、概念追踪、资金流向、情报调查、竞品分析、舆情调查、背景调查、信息验证、多源搜索。

日本語の概要は準備中です。原文の説明を表示しています。

redfox-data/redfox-community4302026年10月12日 更新

B站AI信息源 — 每日扫描B站AI相关账号,按点赞量发现爆款视频,智能聚类话题后生成包含封面图、互动数据与订阅支持的HTML日报。同时基于热门话题执行AI情报调查,采用多引擎搜索与交叉验证,输出结构化调查报告。支持用户自定义关键词定向查询。⚠️数据每日15:00更新前一天数据,目标日期无数据时必须先告知用户并等待确认后才能调用接口,禁止自动获取。当用户需要AI-B站日报、B站爆款、AI-B站热点、B站AI内容、B站AI视频、B站情报或自定义关键词查询时使用。

日本語の概要は準備中です。原文の説明を表示しています。

redfox-data/redfox-community4302026年10月12日 更新

B站评论分析工具。输入B站视频链接或BV号即可获取一级评论数据,支持分页浏览、评论情感分析(积极/负面/需求/竞品),生成精美 HTML 报告。当用户需要查看B站视频评论、分析评论舆情、了解用户反馈时使用。触发词:B站评论、B站视频评论、评论查询、评论分析、评论舆情、看评论、bilibili评论。

日本語の概要は準備中です。原文の説明を表示しています。

redfox-data/redfox-community4302026年10月12日 更新

B站关键词搜账号工具。根据用户输入的关键词查询B站相关账号,支持按综合排序或粉丝数排序,返回账号列表(含粉丝数、等级、简介等信息)。当用户需要搜索B站账号、查找B站UP主、找B站同类账号时使用。

日本語の概要は準備中です。原文の説明を表示しています。

redfox-data/redfox-community4302026年10月12日 更新

B站关键词搜作品工具。根据用户输入的关键词调用 Redfox 接口搜索B站最新视频,支持按排序方式和发布时间筛选,返回新鲜数据(非缓存/历史数据)。当用户要求搜索B站最新内容、查看某关键词下的视频数据时使用。触发词:B站搜索、B站最新视频、B站热门、B站搜作品、bilibili搜索。

日本語の概要は準備中です。原文の説明を表示しています。

redfox-data/redfox-community4302026年10月12日 更新

redfox-data のスキルをすべて見る

このスキルの問題を報告する