抖音赛道热门账号榜单
用户要找抖音赛道热门账号、日榜/周榜/月榜、账号表现对标或榜单报告时，按本技能执行。它查的是账号榜单，不是抖音视频搜索，也不制作视频。
能力范围
- 查询全品类或 27 个赛道的日榜、周榜、月榜，接口最多返回 50 条，默认展示 TOP 20。
- 从自然语言里识别赛道、榜单周期和日期；模糊赛道词按配置映射。
- 展示账号名、主页链接、粉丝量、新增粉丝、点赞、评论和分享等数据。
- 根据五项数据各 20% 计算本项目的综合分，并按分数排序。说明这是本项目的排序结果，不要称为抖音官方评分。
- 输出 Markdown 榜单和 JSON 数据；用户需要报告时，用 JSON 生成 HTML 文件。
- 用户明确要求定时订阅后，才使用当前运行环境支持的自动化功能创建任务。订阅不是查询脚本本身提供的能力。
运行前提
- 需要 Python 3.10 或更高版本、网络连接和红狐数据 API Key。
- API Key 从环境变量
REDFOX_API_KEY读取。不要索取用户在对话中粘贴密钥，也不要把密钥写入脚本、命令历史、提示词或输出文件。 - 用户尚未配置密钥时，说明需要在 WorkBuddy/运行环境的安全环境变量设置中配置，然后停止查询；不要代用户注册或代填密钥。
- 依赖 Python 标准库，无需安装第三方 Python 包。
- 用户在 Windows 本机终端运行时，可使用
scripts/run_windows.ps1安全提示输入密钥并串联查询/报告；不要在 WorkBuddy Bash 环境中调用 PowerShell 专用脚本。
查询流程
- 从用户问题识别赛道、周期、日期和输出条数。未指定周期按日榜；默认展示 20 条，最多 50 条。赛道识别不了时，列出支持赛道并询问用户。
- 依据更新时间和回溯规则计算可查询日期。日榜每日 17:30 更新、最多回溯 7 天；周榜周一 17:30 更新、最多回溯 3 周；月榜每月 2 日 9:00 更新、最多回溯 3 个月。数据非实时；查询落在未来或超出范围时，告知用户并使用脚本计算的最近可用日期。
- 用 Bash 执行查询脚本。
<SKILL_DIR>表示本技能安装目录，执行前替换为真实绝对路径；不要为了运行脚本而把工作目录切换到安装目录。将 JSON 保存到用户当前工作区中的明确路径。路径加引号，确保中文目录和空格路径可用：
bash
python "<SKILL_DIR>/scripts/fetch_rank.py" --query "上周抖音美食赛道账号榜单" --limit 20 --output "榜单数据.json"
如果用户明确指定日期或赛道，可用结构化参数：
bash
python "<SKILL_DIR>/scripts/fetch_rank.py" --period week --date 2026-04-20 --category 美食 --limit 20 --output "榜单数据.json"
- 将脚本返回的榜单按实际展示条数整理，不虚构或补齐 API 没返回的数据。解释数据日期、赛道、综合分口径和非实时限制。按用户需要链接账号主页。
- 用户要求报告时，使用同一份 JSON 生成 HTML；
--limit应与用户要看的条数一致：
bash
python "<SKILL_DIR>/scripts/generate_report.py" --data "榜单数据.json" --limit 20 --output "抖音榜单.html"
确认文件实际生成后再提供路径。HTML 可在浏览器查看，并可用页面按钮打印/导出 PDF 或保存图片；若运行环境不支持自动打开浏览器，只交付文件路径。
输出和准确性要求
- 标明数据日期与查询周期，不把历史榜单说成实时数据。
- 总粉丝数、涨粉和互动量来自红狐数据接口；综合分是脚本对当批结果重新计算的相对分数，排序不一定等于接口原始排名。
- 只报告脚本实际返回的账号数。默认显示 TOP 20，用户要求完整榜单时最多显示 50 条。
- 账号主页链接仅按接口返回值展示，不自行拼造账号链接。
- API 鉴权、接口错误或无数据时，说明查询未成功及可采取的下一步；不要展示密钥或把错误当作空榜单。
定时订阅
只有用户明确同意订阅后，才创建自动化任务。先确认赛道、榜单周期和推送时间；用运行环境的自动化工具设置任务，任务说明应调用本技能查询最新可用数据。创建失败时如实说明，不声称已经订阅。
参考资料
- 赛道及别名：@references/category_map.md、@assets/category_config.json
- 周期、更新时间和日期边界：@references/update_rules.md、@assets/period_config.json
- 综合分口径：@references/score_rules.md
- API 参数及响应字段：@references/api_docs.md
来源与许可
- 原作者/上游来源：
redfox-data，<https://github.com/redfox-data/redfox-community/tree/main/skills/douyin-top-account> - 本包保留了上游查询与报告脚本、配置及参考资料，并为 WorkBuddy 调整了入口说明、脚本路径调用和接口参数。
- 上游仓库 API 未识别到开源许可证（GitHub 仓库许可证字段为空）。因此
license: UNCONFIRMED仅表示许可未确认，不授予再发布或商用权利。发布到 SkillHub 或其他公开市场前，先取得原作者许可并填写获准的许可证信息。 - 不包含也不保存任何用户 API Key。
