douyin-weekly-surgelisted

# 抖音七日点赞飙升榜 ## 📝 简介 周度内容飙升监测工具，每日收录核验全平台万级抖音作品，输出七日新增点赞 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 条数