Skip to content
cccskills
FreePublished on GitHub

tiktok-home-downloader

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

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

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

The English summary is being prepared. Showing the original description.

Works withTikTok
See how to install

Files included (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 (original)

Review the instructions the agent will receive before you install.

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。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

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

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community446Updated Oct 16, 2026

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

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community446Updated Oct 16, 2026

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

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community446Updated Oct 16, 2026

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

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community446Updated Oct 16, 2026

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

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community446Updated Oct 16, 2026

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

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community446Updated Oct 16, 2026

See all skills by redfox-data

Report a problem with this skill