# Douyin Weekly Surge

> 抖音七日点赞飙升榜查询工具。周度收录全平台抖音作品，输出七日新增点赞TOP50榜单，支持按赛道分类查询、历史日期回溯（最多30天）。当用户查询抖音七日飙升榜、抖音周榜飙升、抖音七日点赞飙升、抖音周度飙升榜时使用。触发词：抖音七日飙升榜、七日点赞飙升、周度飙升排名、周榜飙升、抖音七日新增、抖音周榜飙升。

- Skill: `redfox-data/douyin-weekly-surge` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds add redfox-data/douyin-weekly-surge`
- Raw SKILL.md: https://api.skillmd.com/api/skills/redfox-data/douyin-weekly-surge/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: redfox-data (https://skillmd.com/u/redfox-data)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/redfox-data/douyin-weekly-surge

---


# 抖音七日点赞飙升榜

## 📝 简介

周度内容飙升监测工具，每日收录核验全平台万级抖音作品，输出七日新增点赞 TOP50 榜单。

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

## ✨ 功能特性

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

## 🔑 鉴权

前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取 API Key，通过以下方式配置：

```bash
# 方式一：配置文件（如 OpenClaw 的 ~/.openclaw/openclaw.json）
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }

# 方式二：终端环境变量
export REDFOX_API_KEY="ak_xxxx..."
```

## 📡 API 调用

- **接口地址**：`POST https://redfox.hk/story/api/dy/search/hotContentRank`
- **认证方式**：请求头 `X-API-KEY`，值从环境变量 `REDFOX_API_KEY` 获取
- **固定参数**：`source`（值见脚本）
- **可选参数**：`type`（赛道）、`startTime`（日期）

详见 [api-config.md](api-config.md)。

## 🔄 交互流程

### 1. 时间判断

| 用户输入 | 处理方式 |
|------|------|
| 今天 / 当前 / 最新 | 回复说明最新为昨日，提供截至昨日的七日数据 |
| 未来日期 | 回复提示，提供截至昨日的七日数据 |
| 30天内历史日期 | 直接查询对应日期 |
| 超过30天前 | 回复提示，提供最接近时间范围内的数据 |

时间提示语：
- 当日/未来：「非常抱歉🙏，我们最新的是截至昨日的七日数据，将为您提供最接近您需求的七日飙升榜。」
- 超出回溯：「非常抱歉🙏，目前榜单最多支持回溯「过去30天」，我将为您查询最接近您需求的时间范围~」

### 2. 赛道判断

将用户描述归类至以下支持赛道，未能匹配时明确告知并列出全部赛道，询问用户选择：

```
全部、小剧场、财富理财、二次元、身体锻炼、居家装修、数码科技、科学普及、
旅行、美食、动物、明星娱乐、汽车、亲子、人文、三农、潮流风尚、游戏、
生活记录、体育、舞蹈才艺、学习教育、休闲玩乐、影视、音乐、颜值造型、
健康医学、综艺、个人成长
```

### 3. 默认行为

无特殊说明时，默认返回截至昨日的七日全品类飙升榜。**所有查询（包括全品类和特定赛道）均默认展示 TOP20，用户明确要求查看完整榜单时再输出全部 50 条数据。**

## 📊 标准输出格式

榜单以 Markdown 表格呈现，**作品标题必须使用 `[标题](workUrl)` 格式输出为可点击的超链接**：

```markdown
💡 榜单说明：每日 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个赛道]
```

### 作品标题超链接规范

- 作品标题**必须**以 Markdown 链接格式输出：`[作品标题](workUrl)`
- `workUrl` 为接口返回的 `share_url` 字段
- **禁止**使用 HTML `<a>` 标签或终端 OSC 转义序列

### 数据字段说明

| 字段 | 来源字段 | 说明 |
|------|---------|------|
| 排名 | 数组位置 | 按七日新增点赞降序排列 |
| 作品标题 | aweme_desc + share_url | 展示为超链接格式，见上方规范 |
| 作者 | user_nickname | 账号名 |
| 赛道 | category | 仅全品类查询时展示 |
| 七日新增收藏 / 七日新增评论 / 七日新增分享 / 七日新增点赞 | add_collect_count / add_comment_count / add_share_count / add_digg_count | 七日新增互动数据（入库时间快照），**七日新增点赞列数值需加粗显示** |
| 发布时间 | create_time_str | 格式 MM-DD HH:00 |

## 📬 文件输出与订阅

- 默认展示 20 条；用户请求完整版时输出 Markdown 表格（含 50 条）
- 订阅：支持用户选择赛道和时间偏好，按每日 17:00 更新后自动推送

## 📚 其他资源

- API 配置与调用：[api-config.md](api-config.md)
- 赛道分类与交互示例：[interaction-guide.md](interaction-guide.md)