抖音每日TOP账号

概述

提供抖音全品类/分品类账号每日/每周/每月的表现榜单查询。

更新时间与回溯范围：

三大核心能力：

• 📊 排名查询 — 查日榜、周榜、月榜 TOP50
• 🎯 领域查询 — 按品类筛选（美食、旅行、科技、游戏等）
• 📥 报告下载 — 生成 HTML 可视化报告，支持导出 PDF/截图

鉴权

获取 API Key

1. 访问 RedFox 官网 了解服务详情
2. 前往 注册页面 注册账号
3. 新注册用户将获赠免费积分，可立即开始使用 API 服务
4. 注册登录后，在个人中心获取 API Key，格式为 ak_xxxxxxxx

配置 API Key

• REDFOX_API_KEY 从环境变量获取，格式 ak_xxxxxxxx
• 若未设置，提示用户自行配置：export REDFOX_API_KEY=\x3C你的apikey>；若用户不会配置，Agent应主动帮用户设置：
  • macOS/Linux：将 export REDFOX_API_KEY=\x3C值> 追加到 ~/.zshrc（zsh）或 ~/.bashrc（bash），然后 source 对应文件使其全局生效
  • Windows：使用 [Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "\x3C值>", "User") 设置用户级永久环境变量（需重启终端生效）
  • 配置完成后应验证：echo $REDFOX_API_KEY（macOS/Linux）或 echo %REDFOX_API_KEY%（Windows），确保换一个skill也能读取到

目标用户与使用场景

触发词与意图识别

执行流程

第一步：查询数据（默认展示 TOP 20）

python scripts/fetch_rank.py --query "用户原始问题" --limit 20 --output /path/to/data.json

脚本会自动解析：

• 时间：从用户文本识别日/周/月，未明确则默认日榜
• 日期：自动计算最新可用日期（日榜17:30更新，周榜周一17:30更新，月榜每月2号9点更新）
• 赛道：支持模糊匹配（如"美妆"→"化妆美容"）

脚本输出包含：

1. Markdown 格式榜单表格（最多20条）
2. "更多操作"引导模块
3. "订阅服务"引导模块（根据用户选择的赛道动态展示）

第二步：生成 HTML 报告（立即执行）

python scripts/generate_report.py --data /path/to/data.json --limit 20  # 自动生成文件名

重要：HTML 报告展示的数据条数必须与对话中展示的数量保持一致！

• 对话默认展示 20 条 → HTML 报告也只展示 20 条
• 用户要求查看全部 50 条 → 重新生成完整报告

使用 deliver_attachments 交付 HTML 文件。

用户查看全部数据时

python scripts/fetch_rank.py --query "用户原始问题" --limit 50 --output /path/to/data_full.json
python scripts/generate_report.py --data /path/to/data_full.json --limit 50  # 自动生成完整文件名

使用 deliver_attachments 交付完整 HTML 文件。

输出模板

Markdown 表格（对话输出）

📊 抖音{period_label} · {category_label}

数据日期：{date}
共 {total} 个账号上榜（展示 TOP {displayed} 条）

💡 榜单说明：{warning}{period_update_time}，与实时数据存在差异

> **时间边界处理**（warning 插入榜单说明开头）：
> - 查询当日/未来日期：「非常抱歉🙏，我们最新的是昨日/上周/上月的数据，将为您提供最接近您需求的昨日/上周/上月热榜。」
> - 查询早于回溯日期：「非常抱歉🙏，目前榜单最多支持回溯「过去7天/过去3周/过去3月」，我将为您查询最接近您需求的时间范围~」
> - 正常查询：warning 为空，直接展示更新时间

📐 综合评分：根据总粉丝数、新增粉丝增量、新增点赞/分享/评论加权计算，满分100

| 排名 | 账号名 | 综合评分 | 总粉丝数 | 新增粉丝 | 新增点赞 | 新增评论 | 新增分享 |
|:---:|--------|:-------:|:-------:|:-------:|:-------:|:-------:|:-------:|:-------:|
| 🥇 1 | [账号A](https://www.douyin.com/user/xxx) | 96 | 254.06w | 6919 | 24.64w | 6.68w | 13.39w |
| 🥈 2 | [账号B](https://www.douyin.com/user/xxx) | 89 | 113.55w | 1.91w | 7.90w | 4787 | 3.12w |
| 🥉 3 | [账号C](https://www.douyin.com/user/xxx) | 87 | 439.14w | 5859 | 16.51w | 993 | 687 |
| ... | ... | ... | ... | ... | ... | ... | ... |

⚡ 更多操作

⏺️ 本次榜单完整共 50 条数据，是否需要查看剩余 30 条？

📬 订阅服务

1️⃣ 是否需要订阅每日/周/月的抖音账号最新排名？

2️⃣ 是否需要订阅具体赛道的账号表现？我们支持：个人才艺、生活vlog、财富理财、二次元、居家装修、学习教育、小剧场、数码科技、旅行、美食、化妆美容、动物、亲子、汽车、情感、三农、健康医学、潮流风尚、舞蹈才艺、颜值造型、人文、音乐、影视、身体锻炼、体育、明星娱乐、游戏

生成 HTML 报告

• 执行脚本生成 HTML 报告文件
  • 脚本调用示例：python scripts/generate_report.py --data \x3Cfetch_rank输出> --limit 20 # 自动生成文件名
  • 文件名格式：{赛道}{周期}{YYYYMMDD}_{时间戳}.html（如 美食周榜20260511_时间戳.html）（如 20260511_美食.html）

⚠️ 字段说明：默认展示 TOP 20 条数据，最高互动 = 点赞 + 评论 + 分享

订阅服务

用户确认订阅后，使用 automation_update 工具创建自动化任务：

订阅排名更新推送

• 日榜：FREQ=DAILY;BYHOUR=19;BYMINUTE=30
• 周榜：FREQ=WEEKLY;BYDAY=MO;BYHOUR=19;BYMINUTE=30
• 月榜：FREQ=MONTHLY;BYMONTHDAY=1;BYHOUR=16;BYMINUTE=0

automation prompt 示例：查询抖音最新日榜（全品类），生成报告并推送给用户

订阅赛道账号表现

• automation prompt 示例：查询抖音最新日榜（美食赛道），生成报告并推送给用户

常见问题

Q: 日榜数据什么时候更新？ A: 每日 17:30 更新昨日数据。当前时间未到17:30时，脚本会自动取前天数据。

Q: 支持哪些赛道？ A: 支持27个赛道，完整列表见 references/category_map.md。

Q: 数据回溯范围？ A: 日榜可查过去7天，周榜可查过去3周，月榜可查过去3个月。

Q: 赛道识别失败怎么办？ A: 无法识别时，请列出完整赛道列表供用户选择。

资源索引

注意事项

• ⚠️ 时间边界处理（必须严格遵守）：
  • 查询当日及未来日期：在输出开头回复「非常抱歉🙏，我们最新的是昨日/上周/上月的数据，将为您提供最接近您需求的昨日/上周/上月热榜。」然后继续展示最近一期数据
  • 查询时间早于回溯日期：在输出开头回复「非常抱歉🙏，目前榜单最多支持回溯「过去7天/过去3周/过去3月」，我将为您查询最接近您需求的时间范围~」然后继续展示最接近的可查数据
• 严禁任何联网搜索
• ⚠️ 数据一致性：对话展示多少条，HTML 报告就展示多少条，两者必须一致
• 日榜默认展示 TOP 20，完整 50 条通过报告或追问查看
• HTML 报告账号名均可点击跳转抖音主页
• 生成报告前确保 workspace 有写权限