douyin-top-account

# 抖音热门账号推荐 ## 1. 简介 抖音每日最具影响力账号榜单追踪分析工具 -- 基于红狐数据 API，提供抖音全品类 / 分品类账号每日 / 每周 / 每月的表现榜单查询，支持排名查询、赛道筛选、HTML 可视化报告下载与定时订阅推送。 **适用对象**：新手内容创作者、品牌方 / 商务投放人员、MCN 机构 / 内容团队、行业分析师 / 咨询从业者。 --- ## 2. 功能特性 **核心功能**： - 排名查询 -- 查日榜、周榜、月榜 TOP50，支持全品类和分品类 - 赛道筛选 -- 按品类筛选（美食、旅行、科技、游戏等 27 个赛道） - 报告下载 -- 生成 HTML 可视化报告，支持导出 PDF / 截图 - 定时订阅 -- 设置自动化定时推送，支持日 / 周 / 月频率 **特色亮点**： - 日榜每日 17:30 更新 / 回溯 7 天，周榜每周一 17:30 更新 / 回溯 3 周，月榜每月 2 号 9 点更新 / 回溯 3 月 - 综合评分算法：根据总粉丝数、新增粉丝增量、新增点赞 / 分享 / 评论加权计算，满分 100 - 赛道模糊匹配：支持自然语言输入（如 "美妆" 自动映射到 "化妆美容"） - 数据一致性保障：对话展示的数据条数与 HTML 报告严格一致 --- ## 3. 一键安装 ### 鉴权 #### 获取 API Key 请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取API KEY #### 配置 API Key 方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中 ```bash { "env": { "REDFOX_API_KEY": "ak_xxxx..." } } ``` 方案2: 终端配置：export REDFOX_API_KEY="ak_xxxx..." ```bash export REDFOX_API_KEY="ak_xxxx..." ``` ### 依赖安装 无需安装第三方依赖，使用 Python 标准库即可运行。 --- ## 4. 使用指南 ### 基础使用 **查询榜单数据（默认展示 TOP 20）**： ```bash python scripts/fetch_rank.py --query "用户原始问题" --limit 20 --output /path/to/data.json ``` 脚本会自动解析： - **时间**：从用户文本识别日 / 周 / 月，未明确则默认日榜 - **日期**：自动计算最新可用日期（日榜 17:30 更新，周榜周一 17:30 更新，月榜每月 2 号 9 点更新） - **赛道**：支持模糊匹配（如 "美妆" 映射为 "化妆美容"） **生成 HTML 报告**： ```bash python scripts/generate_report.py --data /path/to/data.json --limit 20 ``` > 重要：HTML 报告展示的数据条数必须与对话中展示的数量保持一致。使用 `deliver_attachments` 交付 HTML 文件。 **查看全部 50 条数据**： ```bash python scripts/fetch_rank.py --query "用户原始问题" --limit...