抖音每日热门作品榜

SKILL.md

---
name: douyin-daily-hot
description: 抖音每日最热作品榜查询工具。日度收录全平台抖音作品，输出单日点赞TOP50榜单，支持按赛道分类查询、历史日期回溯（最多30天）、个性化订阅推送。当用户查询抖音热榜、抖音日榜、抖音爆款作品、抖音赛道排名、抖音达人排名、抖音热门内容时使用。触发词：抖音热榜、抖音日榜、抖音排名、抖音爆款、抖音最热、抖音TOP榜、抖音赛道榜单。
---

# 抖音每日热门作品榜

## 📝 简介

日度内容热度监测工具，每日人工收录核验全平台万级抖音作品，输出单日点赞 TOP50 榜单。

- 更新时间：每日 06:00 更新昨日数据
- 回溯范围：最多回溯过去 30 天
- 每个分类最多返回 50 条

## ✨ 功能特性

| 功能模块 | 能力描述 | 核心价值 |
|---------|---------|---------|
| 日榜排名 | 每日输出单日点赞 TOP50 榜单 | 快速获取全平台当日最热作品 |
| 赛道筛选 | 支持 28 个赛道分类查询 | 精准定位垂直领域热门内容 |
| 历史回溯 | 支持回溯过去 30 天数据 | 追溯往期热门趋势 |
| 可点击链接 | 作品标题以超链接格式输出 | 一键跳转查看原作品 |
| 分页展示 | 默认 TOP20，可查看完整 TOP50 | 按需获取全量或摘要数据 |
| 订阅推送 | 支持赛道和时间偏好订阅 | 定时获取热门动态 |

## 🔑 鉴权

### 获取 API Key

请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=clawhub) 获取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个赛道]
```

### 作品标题超链接规范（必须遵守）

- 作品标题**必须**以 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)