📝 Overview
Weekly content surge monitoring tool that collects and verifies tens of thousands of Douyin works across the entire platform daily, and outputs a top 50 ranking of new likes over seven days.
- Update time: updates the past seven days of data daily at 17:00
- Lookback range: up to the past 30 days
- Each category returns up to 50 items
✨ Features
| Feature Module | Capability Description | Core Value |
|---|---|---|
| Weekly Surge | Outputs a top 50 ranking of new likes over seven days daily | Discover works with sustained growth over seven days |
| Category Filtering | Supports queries across 28 category classifications | Precisely locate surge content in vertical fields |
| Historical Lookback | Supports looking back at data from the past 30 days | Trace past surge trends |
| Clickable links | Work titles are output in hyperlink format | One-click jump to view the original work |
| Paged Display | Defaults to TOP20, with the full TOP50 available | Obtain full or summary data as needed |
| Subscription Push | Supports subscription by category and time preference | Get surge updates on a schedule |
🔑 Authentication
Go to RedFox Hub to get an API Key, and configure it in the following way:
# 方式一：配置文件（如 OpenClaw 的 ~/.openclaw/openclaw.json）
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
# 方式二：终端环境变量
export REDFOX_API_KEY="ak_xxxx..."
📡 API Calls
- Endpoint：
POST https://redfox.hk/story/api/dy/search/hotContentRank - Authentication method: request header
X-API-KEY, value obtained from the environment variableREDFOX_API_KEYGet - Fixed parameters：
source(see script for values) - Optional parameters：
type(category),startTime(date)
See api-config.md。
🔄 Interaction Flow
1. Time Determination
| User Input | Handling Method |
|---|---|
| Today / Current / Latest | Reply explaining that the latest is yesterday, and provide seven-day data up to yesterday |
| Future date | Reply with a prompt, and provide seven-day data up to yesterday |
| Historical date within 30 days | Directly query the corresponding date |
| More than 30 days ago | Reply with a prompt, and provide data within the closest time range |
Time prompt:
- Current day/future: "We are very sorry 🙏, our latest data is the seven-day data up to yesterday, and we will provide you with the seven-day surge ranking closest to your needs."
- Exceeds lookback: "We are very sorry 🙏, the ranking currently supports lookback only within the past 30 days. I will query the time range closest to your needs for you~"
2. Category Determination
Classify the user's description into the following supported tracks; if no match is found, clearly inform them and list all tracks, then ask the user to choose:
全部、小剧场、财富理财、二次元、身体锻炼、居家装修、数码科技、科学普及、
旅行、美食、动物、明星娱乐、汽车、亲子、人文、三农、潮流风尚、游戏、
生活记录、体育、舞蹈才艺、学习教育、休闲玩乐、影视、音乐、颜值造型、
健康医学、综艺、个人成长
3. Default Behavior
Unless otherwise specified, by default return the seven-day all-category rising chart as of yesterday.All queries (including all-category and specific tracks) display TOP20 by default; only output all 50 entries when the user explicitly requests to view the full chart.
📊 Standard Output Format
The chart is presented as a Markdown table,The work title must use the [标题](workUrl) format to output as a clickable hyperlink：
💡 榜单说明：每日 17:00 更新过去七日数据，[如有时间偏差提示则插入]。飙升数据为七日新增统计，与累计总量存在差异。
📊 抖音七日点赞飙升TOP20（截至 YYYY-MM-DD）[查询全部时含"赛道"列，查询特定赛道时不含]
| 排名 | 作品标题 | 作者 | 赛道* | 七日新增收藏 | 七日新增评论 | 七日新增分享 | **七日新增点赞** | 发布时间 |
|------|---------|------|-------|---------|---------|---------|------------|---------|
| 1 | [红烧肉的教程](https://www.douyin.com/video/xxx) | 美食达人 | 美食 | 10w+ | 10w+ | 10w+ | **10w+** | 05-28 12:00 |
*查询特定赛道时去掉"赛道"列
⚡ 更多操作
• 本次榜单完整共50条数据，是否需要查看剩余30条？
📬 订阅服务
1️⃣ 我们每日 17:00 更新过去七日数据，是否需要订阅每日的抖音作品七日飙升排行，订阅后定时推送给您
2️⃣ 是否需要订阅具体赛道的作品表现？我们支持：[列出28个赛道]
Work Title Hyperlink Specification
- Work Titlemustbe output in Markdown link format:
[作品标题](workUrl) workUrlis theshare_urlfield returned by the API- Prohibitedto use HTML
<a>tags or terminal OSC escape sequences
Data Field Description
| Field | Source Field | Description |
|---|---|---|
| Rank | Array Position | Sorted in descending order by seven-day new likes |
| Work Title | aweme_desc + share_url | Displayed as a hyperlink format, see the specification above |
| Author | user_nickname | Account Name |
| Track | category | Displayed only for all-category queries |
| Seven-day new favorites / seven-day new comments / seven-day new shares / seven-day new likes | add_collect_count / add_comment_count / add_share_count / add_digg_count | Seven-day new interaction data (snapshot at ingestion time),The values in the seven-day new likes column must be displayed in bold |
| Publish Time | create_time_str | Format MM-DD HH:00 |
📬 File Output and Subscription
- Display 20 entries by default; when the user requests the full version, output a Markdown table (containing 50 entries)
- Subscription: supports users selecting tracks and time preferences, automatically pushing after the daily 17:00 update
📚 Other Resources
- API Configuration and Invocation:api-config.md
- Track Classification and Interaction Examples:interaction-guide.md