抖音每日最热作品榜查询工具。日度收录全平台抖音作品，输出单日点赞TOP50榜单，支持按赛道分类查询、历史日期回溯（最多30天）、个性化订阅推送。当用户查询抖音热榜、抖音日榜、抖音爆款作品、抖音赛道排名、抖音达人排名、抖音热门内容时使用。触发词：抖音热榜、抖音日榜、抖音排名、抖音爆款、抖音最热、抖音TOP榜、抖音赛道榜单。
---
name: douyin-daily-hot
display_name: 抖音每日热门作品榜
display_name_en: Douyin Daily Hot Rank
description: 抖音每日最热作品榜查询工具。日度收录全平台抖音作品，输出单日点赞TOP50榜单，支持按赛道分类查询、历史日期回溯（最多30天）、个性化订阅推送。当用户查询抖音热榜、抖音日榜、抖音爆款作品、抖音赛道排名、抖音达人排名、抖音热门内容时使用。触发词：抖音热榜、抖音日榜、抖音排名、抖音爆款、抖音最热、抖音TOP榜、抖音赛道榜单。
description_zh: 抖音每日最热作品榜查询工具，输出单日点赞TOP50榜单，支持赛道筛选、30天回溯与订阅推送。
description_en: Douyin daily hottest works ranking. Outputs the TOP50 works by daily likes, with category filters, 30-day history lookup and subscription push.
category: data
version: 1.0.2
author: 红狐数据
---
# 抖音每日热门作品榜
## 📝 简介
日度内容热度监测工具，每日人工收录核验全平台万级抖音作品，输出单日点赞 TOP50 榜单。
- 更新时间：每日 06:00 更新昨日数据
- 回溯范围：最多回溯过去 30 天
- 每个分类最多返回 50 条
## ✨ 功能特性
| 功能模块 | 能力描述 | 核心价值 |
|---------|---------|---------|
| 日榜排名 | 每日输出单日点赞 TOP50 榜单 | 快速获取全平台当日最热作品 |
| 赛道筛选 | 支持 28 个赛道分类查询 | 精准定位垂直领域热门内容 |
| 历史回溯 | 支持回溯过去 30 天数据 | 追溯往期热门趋势 |
| 可点击链接 | 作品标题以超链接格式输出 | 一键跳转查看原作品 |
| 分页展示 | 默认 TOP20，可查看完整 TOP50 | 按需获取全量或摘要数据 |
| 订阅推送 | 支持赛道和时间偏好订阅 | 定时获取热门动态 |
## 🔑 鉴权
### 获取 API Key
请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=workbuddy) 获取API KEY
### 配置 API Key
方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中，部分内容如下：
```bash
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
```
方案2: 终端配置
```bash
export REDFOX_API_KEY="ak_xxxx..."
```
## 📡 API 调用
- **接口地址**：`POST https://redfox.hk/story/api/dy/search/likesRank`
- **认证方式**：请求头 `X-API-KEY`，值从环境变量 `REDFOX_API_KEY` 获取
- **固定参数**：`source`（值见脚本）
- **可选参数**：`type`（赛道）、`startTime`、`endTime`（日期范围）
详见 [api-config.md](api-config.md)。
## 🔄 交互流程
### 1. 时间判断
| 用户输入 | 处理方式 |
| ------------------ | ------------------------------------ |
| 今天 / 当前 / 最新 | 回复说明最新为昨日，提供昨日数据 |
| 未来日期 | 回复提示，提供昨日数据 |
| 30天内历史日期 | 直接查询对应日期 |
| 超过30天前 | 回复提示，提供最接近时间范围内的数据 |
时间提示语：
- 当日/未来：「非常抱歉🙏，我们最新的是昨日数据，将为您提供最接近您需求的昨日热榜。」
- 超出回溯：「非常抱歉🙏，目前榜单最多支持回溯「过去30天」，我将为您查询最接近您需求的时间范围~」
### 2. 赛道判断
将用户描述归类至以下支持赛道，未能匹配时明确告知并列出全部赛道，询问用户选择：
```
全部、小剧场、财富理财、二次元、身体锻炼、居家装修、数码科技、科学普及、
旅行、美食、动物、明星娱乐、汽车、亲子、人文、三农、潮流风尚、游戏、
生活记录、体育、舞蹈才艺、学习教育、休闲玩乐、影视、音乐、颜值造型、
健康医学、综艺、个人成长
```
### 3. 默认行为
无特殊说明时，默认返回昨日全品类日榜。**所有查询（包括全品类和特定赛道）均默认展示 TOP20，用户明确要求查看完整榜单时再输出全部 50 条数据。**
## 📊 标准输出格式
榜单以 Markdown 表格呈现，**作品标题必须使用 `[标题](workUrl)` 格式输出为可点击的超链接**：
```
💡 榜单说明：每日 06:00 更新昨日数据，[如有时间偏差提示则插入]。互动数据为入库时间，与实时数据存在差异。
📊 抖音每日点赞TOP20（YYYY-MM-DD）[查询全部时含"赛道"列，查询特定赛道时不含]
| 排名 | 作品标题 | 作者（粉丝数） | 赛道* | 收藏 | 评论 | 分享 | **点赞** | 发布时间 |
|------|---------|--------------|-------|------|------|------|------|---------|
| 1 | [红烧肉的教程](https://www.douyin.com/video/xxx) | 美食达人（10w+） | 美食 | 10w+ | 10w+ | 10w+ | **10w+** | 05-28 12:00 |
*查询特定赛道时去掉"赛道"列
⚡ 更多操作
• 本次榜单完整共50条数据，是否需要查看剩余30条？
📬 订阅服务
1️⃣ 我们每日 06:00 更新昨日数据，是否需要订阅每日的抖音作品最新排名，订阅后定时推送给您
2️⃣ 是否需要订阅具体赛道的作品表现？我们支持：[列出28个赛道]
> 💼 另外红狐配套全量数据库可提供完整详实数据，如需了解采购方案，可前往红狐hub[企业服务](https://redfox.hk/dashboard/enterprise)对接咨询
```
### 作品标题超链接规范（必须遵守）
- 作品标题**必须**以 Markdown 链接格式输出：`[作品标题](workUrl)`
- `workUrl` 为接口返回字段，是作品在抖音的访问链接
- **禁止**使用 HTML `<a>` 标签或终端 OSC 转义序列
- 即使终端不支持直接点击，Markdown 链接格式也能确保对话界面正确渲染为可点击超链接
### 数据字段说明
| 字段 | 来源字段 | 说明 |
| ------------------------- | -------------------------------- | -------------------------------------------------- |
| 排名 | rank | 当日点赞排名 |
| 作品标题 | video_title + workUrl | **必须展示为 `[标题](workUrl)` 超链接格式** |
| 作者 | author_name + author_fans | 账号名 + 粉丝总数 |
| 赛道 | category | 仅全品类查询时展示 |
| 收藏 / 评论 / 分享 / 点赞 | collect / comment / share / like | 互动数据（入库时间快照），**点赞列数值需加粗显示** |
| 发布时间 | publish_time | 格式 MM-DD HH:00 |
## 📬 文件输出与订阅
- 默认展示 20 条；用户请求完整版时输出 Markdown 表格（含 50 条）
- 订阅：支持用户选择赛道和时间偏好，按每日 06:00 更新后自动推送
## 📚 其他资源
- API 配置与调用：[api-config.md](api-config.md)
- 赛道分类与交互示例：[interaction-guide.md](interaction-guide.md)
抖音账号视频批量下载器 — 输入抖音号，自动拉取账号全部作品并解析无水印下载链接，支持批量一键下载到本地。适用场景：竞品账号内容拆解与逐帧学习、收藏喜欢的创作者全部作品避免被删、批量搬运素材二次剪辑创作、保存自己账号作品做本地备份防丢失、课程/教程类视频离线囤货反复看、甲方要求提供无水印源文件、达人合作前快速拉取对方作品做背调分析。触发词：抖音主页下载、抖音视频下载、抖音批量下载、抖音无水印下载、下载抖音作品、抖音账号视频提取、抖音视频保存、抖音去水印、抖音视频备份、竞品视频下载。
---
name: douyin-video-downloader
description: 抖音账号视频批量下载器 — 输入抖音号，自动拉取账号全部作品并解析无水印下载链接，支持批量一键下载到本地。适用场景：竞品账号内容拆解与逐帧学习、收藏喜欢的创作者全部作品避免被删、批量搬运素材二次剪辑创作、保存自己账号作品做本地备份防丢失、课程/教程类视频离线囤货反复看、甲方要求提供无水印源文件、达人合作前快速拉取对方作品做背调分析。触发词：抖音主页下载、抖音视频下载、抖音批量下载、抖音无水印下载、下载抖音作品、抖音账号视频提取、抖音视频保存、抖音去水印、抖音视频备份、竞品视频下载。
display_name: 抖音账号视频批量下载器
display_name_en: Douyin Video Batch Downloader
description_zh: 输入抖音号即可拉取该账号全部作品，解析无水印下载直链，支持批量一键下载视频与图片到本地
description_en: Batch download watermark-free videos and images from any Douyin account by entering the account ID.
category: media
version: 1.0.1
author: 红狐数据
---
# 抖音账号视频批量下载器
> 输入抖音号 → 拉取作品列表 → 解析下载链接 → 一键下载到本地
***
## 简介
抖音账号主页下视频批量下载工具。只需提供抖音号，自动拉取该账号近期作品列表，逐条解析无水印视频/图文下载直链，支持一键批量下载到本地。
***
## 功能特性
| 功能 | 说明 |
| ------- | -------------------------------- |
| 📋 作品拉取 | 通过抖音号获取账号近期作品（标题、互动数据、作品链接） |
| 🔗 链接解析 | 逐条调用解析接口，获取视频/图文无水印下载直链 |
| 📥 批量下载 | 一键下载全部作品（视频+图文）到本地 `output/` 目录 |
| 📊 数据展示 | Markdown 表格 / JSON 双格式输出，含完整互动数据 |
| 📄 分页翻页 | 支持翻页查看更多作品 |
| 📅 日期筛选 | 可按作品发布时间挑选 |
| ⚡ 速率保护 | 内置请求间隔，避免触发频率限制 |
***
## API 说明
本 Skill 调用两个 redfox.hk 接口：
| 步骤 | 接口 | 说明 |
| ------- | ------------------------------------------------ | --------------- |
| 1. 拉取作品 | `POST /story/api/dy/data/listWorkByAccount` | 根据抖音号获取作品列表 |
| 2. 解析下载 | `POST /story/api/parseWork/videoDownload/douyin` | 根据作品链接获取无水印下载直链 |
### 认证
前往 [红狐hub](https://redfox.hk/settings/api-keys?source=workbuddy) 获取 API Key。
```bash
# 环境变量配置（推荐）
export REDFOX_API_KEY=ak_你的密钥
# Windows PowerShell
$env:REDFOX_API_KEY="ak_你的密钥"
```
***
## 使用方式
### CLI 命令行
```bash
# 基础用法：拉取作品并解析下载链接（不下载文件）
python3 "$SKILL_PATH/scripts/douyin_video_downloader.py" --account "Fish688688"
# 下载视频到本地
python3 "$SKILL_PATH/scripts/douyin_video_downloader.py" --account "Fish688688" --download
# 指定下载目录
python3 "$SKILL_PATH/scripts/douyin_video_downloader.py" --account "Fish688688" --download --output-dir ./my_videos
# JSON 格式输出
python3 "$SKILL_PATH/scripts/douyin_video_downloader.py" --account "Fish688688" --json
# 多账号（逗号分隔）
python3 "$SKILL_PATH/scripts/douyin_video_downloader.py" --accounts "Fish688688,YuZhouXiaoLi1220" --download
# 指定作品数量（默认10，最多50）
python3 "$SKILL_PATH/scripts/douyin_video_downloader.py" --account "Fish688688" --count 20 --download
# 翻页查看更多作品
python3 "$SKILL_PATH/scripts/douyin_video_downloader.py" --account "Fish688688" --page 2
# 按日期范围筛选作品
python3 "$SKILL_PATH/scripts/douyin_video_downloader.py" --account "Fish688688" --date-start 2026-07-01 --date-end 2026-07-31
# 组合使用：第2页 + 日期过滤 + 下载
python3 "$SKILL_PATH/scripts/douyin_video_downloader.py" --account "Fish688688" --page 2 --count 20 --date-start 2026-06-01 --download
```
### 参数说明
| 参数 | 说明 |
| -------------- | ------------------ |
| `--account` | 单个抖音号 |
| `--accounts` | 多个抖音号，逗号分隔 |
| `--count` | 拉取作品数量（默认10，最多50） |
| `--page` | 页码（默认1） |
| `--date-start` | 起始日期 YYYY-MM-DD |
| `--date-end` | 结束日期 YYYY-MM-DD |
| `--download` | 下载视频文件到本地 |
| `--output-dir` | 下载目录（默认 `output/`） |
| `--json` | JSON 格式输出 |
| `--rate-limit` | 请求间隔秒数（默认 1.0） |
| `--api-key` | 指定 API Key |
### 依赖
| 依赖 | 安装命令 |
| ---------- | ----------------------- |
| `requests` | `pip3 install requests` |
***
## 抖音号要求
接口通过 `uniqueName`（抖音展示ID）查询，脚本将用户提供的抖音号统一按 `uniqueName` 传入，`userId` 和 `shortId` 固定为空字符串。**必须提供抖音号**。
**重要：** 若用户只输入账号名称（如"李佳琦""老高與小茉"）而未提供抖音号，必须提示：
> "抖音账号名称存在多个重名情况，请提供准确的**抖音号**以便精准查询。"
并附上获取抖音号的示例图供用户参考：
> **抖音号**是抖音 APP → 目标账号主页 → 昵称下方显示的唯一 ID（如 `Fish688688`、`YuZhouXiaoLi1220`），非中文昵称。
***
## 数据规则
### 失败阈值保护
* **同一抖音号在 6 小时内累计 5 次 API 调用失败后，后续请求将被拒绝**
* 拒绝时提示：「当前账号下载已超过失败阈值，请联系客服邮箱 <redfoxdata@proton.me> 处理」
* **距上次失败超过 6 小时**，计数自动归零，恢复正常调用
* **同一账号查询成功**（API 返回正常数据），计数归零，恢复正常调用
* 失败计数持久化至 `~/.qoder/douyin_video_downloader_failures.json`
> **注意：** 仅记录因网络超时、API 错误码（3108/3106/3107/400 等）导致的调用失败；账号暂无作品数据（空数据）不计入失败次数。
***
## Agent 集成指南
### 触发词
* 抖音下载 / 抖音视频下载
* 抖音批量下载 / 抖音无水印下载
* 下载抖音作品 / 抖音账号视频提取
* 帮我下载 xxx 的抖音视频
### Agent 执行流程
```
Step 1: 确认用户意图与抖音号
- 若用户提供了抖音号（如 Fish688688），直接执行
- 若用户只提供了账号名称（中文昵称，如"李佳琦"），必须提示：
"抖音账号名称存在多个重名情况，请提供准确的抖音号以便精准查询。"
并展示获取抖音号的示例图：https://lyy.redfox.hk/page/ljq.png
Step 2: 识别用户输入的时间范围（如有）
- 若用户提到了作品时间范围，自动识别并转换为 --date-start / --date-end：
- "7.1~7.20" → --date-start 2026-07-01 --date-end 2026-07-20
- "7月1日到7月20日" → --date-start 2026-07-01 --date-end 2026-07-20
- "最近一周" → 当前日期往前推 7 天
- "上个月" → 上个月 1 日到上个月最后一天
- "7月份的作品" → --date-start 2026-07-01 --date-end 2026-07-31
- 日期格式固定为 YYYY-MM-DD，年份默认为当前年份
- 若用户要求"继续"/"下一页"，添加 --page N
Step 3: 调用脚本拉取作品 + 解析下载链接
python3 "$SKILL_PATH/scripts/douyin_video_downloader.py" --account "抖音号"
Step 4: 展示结果 + 询问翻页
- 展示 Markdown 表格，含可点击的作品链接和下载链接
- 若有失败：提示「可能是用户已删除该视频，如需数据核查可联系工作人员邮箱 redfoxdata@proton.me 处理」
- 若可翻页：告诉用户「还有更多作品，是否需要翻看下一页？」，输入下一页翻页
- 提示用户支持按时间范围提取作品
Step 5: 询问用户是否需要批量下载
- 使用 AskUserQuestion：「是否需要将能下载的视频批量下载到本地？」
- 选项：「下载到本地」/「只看链接即可」
Step 6: 用户确认后执行下载
python3 "$SKILL_PATH/scripts/douyin_video_downloader.py" --account "抖音号" --download
- 告知用户文件保存路径
```
### Agent 输出规范
解析完成后按以下格式输出（自然语言风格，面向普通用户）。
#### ⛔ 强制规则：禁止简化输出
> **Agent 必须原样展示脚本返回的完整表格，禁止以下行为：**
>
> * ❌ 禁止删除或合并任何列（发布时间、作品、赞、评论、收藏、分享、资源下载 缺一不可）
>
> * ❌ 禁止省略翻页提示行（"还有更多作品，输入 `--page 2` 翻看下一页"）
>
> * ❌ 禁止省略时间范围筛选提示（"💡 支持输入想提取的作品时间范围…"）
>
> * ❌ 禁止省略下载询问提示（"💾 需要将这 X 条作品批量下载到本地吗？"）
>
> * ❌ 禁止用「...」或摘要代替完整表格内容
>
> * ✅ 必须逐行展示所有作品的完整信息（含资源下载链接）
#### 输出模板
```markdown
## 📥 抖音视频下载 — @账号名（粉丝: X）
当前是**第 1 页**，共 10 条作品 | 还有更多作品，输入 `--page 2` 翻看下一页
| # | 发布时间 | 作品 | 赞 | 评论 | 收藏 | 分享 | 资源下载 |
|---|----------|------|-----|------|------|------|------|
| 1 | 07-28 | [作品标题](https://www.iesdouyin.com/...) | 5.2k | 67 | 689 | 5.8k | [🎬视频](...) · [🖼封面](...) · [🎵音频](...) |
| 2 | 07-24 | [作品标题2](https://www.iesdouyin.com/...) | 3.1k | 22 | 136 | 865 | [🖼封面](...) |
| 3 | … | … | … | … | … | … | … |
**合计：** 10 条作品，8 条可下载，2 条下载失败
> ⚠️ 下载失败的视频可能是用户已删除该视频，如需数据核查可联系工作人员邮箱 **redfoxdata@proton.me** 处理。
> 💡 需要提取特定时间范围的作品？直接告诉我时间范围即可，如「7.1~7.20」「最近一周」
> 💾 需要将这 X 条作品批量下载到本地吗？直接告诉我即可。
```
***
## 常见问题
**Q：如何获取 API Key？**
A：前往 [redfox.hk](https://redfox.hk/settings/api-keys?source=workbuddy) 注册获取。
**Q：下载的视频有水印吗？**
A：无水印。API 返回的视频/图文直链已去除抖音水印。
**Q：图文作品能下载吗？**
A：可以。图文作品（幻灯片、相册类）会自动下载首张无水印图片，格式为 JPG/PNG/WebP。
**Q：为什么提示「调用频率超限」？**
A：API 返回 code=3108 时表示请求过快触发了限流。可增加 `--rate-limit 2.0` 延长间隔。
**Q：支持哪些抖音号格式？**
A：支持抖音展示 ID（uniqueName），如 `Fish688688`、`YuZhouXiaoLi1`