douyin-daily-hotlisted
Install: claude install-skill redfox-data/redfox-community
# 抖音每日热门作品榜
## 📝 简介
日度内容热度监测工具,每日人工收录核验全平台万级抖音作品,输出单日点赞 TOP50 榜单。
- 更新时间:每日 06:00 更新昨日数据
- 回溯范围:最多回溯过去 30 天
- 每个分类最多返回 50 条
## ✨ 功能特性
| 功能模块 | 能力描述 | 核心价值 |
|---------|---------|---------|
| 日榜排名 | 每日输出单日点赞 TOP50 榜单 | 快速获取全平台当日最热作品 |
| 赛道筛选 | 支持 28 个赛道分类查询 | 精准定位垂直领域热门内容 |
| 历史回溯 | 支持回溯过去 30 天数据 | 追溯往期热门趋势 |
| 可点击链接 | 作品标题以超链接格式输出 | 一键跳转查看原作品 |
| 分页展示 | 默认 TOP20,可查看完整 TOP50 | 按需获取全量或摘要数据 |
| 订阅推送 | 支持赛道和时间偏好订阅 | 定时获取热门动态 |
## 🔑 鉴权
### 获取 API Key
请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取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. 赛道判断
将用户描述归类至以下支持赛道,未能匹配时明确告知并列出全部赛道,询问用户选择:
```
全部、小剧场、财富理财、二次元、身体锻炼、居家装修、数码科技、