用途
抖音每日最具影响力账号榜单追踪分析工具，用于查询抖音全品类及分品类账号的每日、每周、每月表现榜单。
主要能力
- 排名查询：查询日榜、周榜、月榜 TOP50。
- 领域查询：按品类筛选，支持个人才艺、生活vlog、财富理财、二次元、居家装修、学习教育、小剧场、数码科技、旅行、美食、化妆美容、动物、亲子、汽车、情感、三农、健康医学、潮流风尚、舞蹈才艺、颜值造型、人文、音乐、影视、身体锻炼、体育、明星娱乐、游戏等27个赛道。
- 报告下载：生成 HTML 可视化报告，支持导出 PDF/截图，报告内账号名可点击跳转抖音主页。
更新时间与回溯范围
| 榜单类型 | 更新时间 | 回溯范围 |
|---|---|---|
| 日榜 | 每日17:30 | 过去7天 |
| 周榜 | 每周一17:30 | 过去3周 |
| 月榜 | 每月2号9点 | 过去3月 |
使用方式
第一步：查询数据（默认展示 TOP 20）
python scripts/fetch_rank.py --query "用户原始问题" --limit 20 --output /path/to/data.json
脚本会自动解析时间（日/周/月，未明确则默认日榜）、自动计算最新可用日期、支持赛道模糊匹配（如“美妆”→“化妆美容”）。输出包含 Markdown 格式榜单表格（最多20条）、“更多操作”引导模块和“订阅服务”引导模块。
第二步：生成 HTML 报告
python scripts/generate_report.py --data /path/to/data.json --limit 20 # 自动生成文件名
HTML 报告展示的数据条数必须与对话中展示的数量保持一致。使用 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 # 自动生成完整文件名
订阅服务：用户确认订阅后，使用 automation_update 工具创建自动化任务。日榜推送频率 FREQ=DAILY;BYHOUR=19;BYMINUTE=30；周榜 FREQ=WEEKLY;BYDAY=MO;BYHOUR=19;BYMINUTE=30；月榜 FREQ=MONTHLY;BYMONTHDAY=1;BYHOUR=16;BYMINUTE=0。
输出说明
榜单表格包含排名、账号名、综合评分、总粉丝数、新增粉丝、新增点赞、新增评论、新增分享。综合评分根据总粉丝数、新增粉丝增量、新增点赞/分享/评论加权计算，满分100。
适用场景
- 新手内容创作者/个体运营：查找赛道内优秀账号，了解自身水平位置。
- 品牌方/商务投放人员：查找达人，了解账号历史表现。
- MCN机构/内容团队：获取竞品账号情报，掌握市场动态。
- 行业分析师/咨询从业者：获取数据并生成可视化报告。
限制与注意事项
- 时间边界处理：查询当日及未来日期时，提示最新为昨日/上周/上月数据并提供最接近一期；查询早于回溯日期时，提示最多支持回溯范围并提供最接近可查数据。
- 严禁任何联网搜索。
- 数据一致性：对话展示多少条，HTML 报告就展示多少条。
- 日榜默认展示 TOP 20，完整50条通过报告或追问查看。
- 生成报告前确保 workspace 有写权限。
- 赛道识别失败时，需列出完整赛道列表供用户选择。
资源索引
| 文件 | 用途 |
|---|---|
| scripts/fetch_rank.py | 查询抖音榜单数据 |
| scripts/generate_report.py | 生成 HTML 可视化报告 |
| references/category_map.md | 赛道映射表与匹配规则 |
| references/update_rules.md | 更新规则与日期计算逻辑 |
| references/score_rules.md | 评分算法说明 |
| references/api_docs.md | API 接口详细文档（技术参考） |
常见问题
- 日榜数据什么时候更新？每日17:30更新昨日数据。当前时间未到17:30时，脚本会自动取前天数据。
- 支持哪些赛道？支持27个赛道，完整列表见 references/category_map.md。
- 数据回溯范围？日榜可查过去7天，周榜可查过去3周，月榜可查过去3个月。
- 赛道识别失败怎么办？无法识别时，请列出完整赛道列表供用户选择。