2026-09-03 09:53:07 +08:00
|
|
|
|
# 抖音数据规则
|
|
|
|
|
|
|
|
|
|
|
|
> 本文件定义所有 douyin-* 技能获取数据时必须遵守的规则。
|
|
|
|
|
|
> 最后更新：2026-08-08
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 1. 赛道过滤规则
|
|
|
|
|
|
|
|
|
|
|
|
所有抖音榜单/数据获取时，按以下配置过滤赛道。
|
|
|
|
|
|
|
|
|
|
|
|
**保留赛道**（共 7 个）：
|
|
|
|
|
|
|
|
|
|
|
|
| # | 赛道 | | # | 赛道 |
|
|
|
|
|
|
|---|------|-|---|------|
|
|
|
|
|
|
| 1 | 生活 vlog | | 5 | 情感 |
|
|
|
|
|
|
| 2 | 小剧场 | | 6 | 颜值造型 |
|
|
|
|
|
|
| 3 | 亲子 | | 7 | 旅行 |
|
|
|
|
|
|
| 4 | 美食 | | | |
|
|
|
|
|
|
|
|
|
|
|
|
**排除赛道**（共 20 个）：
|
|
|
|
|
|
|
|
|
|
|
|
| # | 赛道 | | # | 赛道 |
|
|
|
|
|
|
|---|------|-|---|------|
|
|
|
|
|
|
| 1 | 动物 | | 11 | 健康医学 |
|
|
|
|
|
|
| 2 | 明星娱乐 | | 12 | 汽车 |
|
|
|
|
|
|
| 3 | 音乐 | | 13 | 个人才艺 |
|
|
|
|
|
|
| 4 | 游戏 | | 14 | 财富理财 |
|
|
|
|
|
|
| 5 | 人文 | | 15 | 学习教育 |
|
|
|
|
|
|
| 6 | 体育 | | 16 | 潮流风尚 |
|
|
|
|
|
|
| 7 | 影视 | | 17 | 身体锻炼 |
|
|
|
|
|
|
| 8 | 舞蹈才艺 | | 18 | 居家装修 |
|
|
|
|
|
|
| 9 | 数码科技 | | 19 | 化妆美容 |
|
|
|
|
|
|
| 10 | 三农 | | 20 | 二次元 |
|
|
|
|
|
|
|
|
|
|
|
|
> 保留赛道 JSON：`["生活 vlog", "小剧场", "亲子", "美食", "情感", "颜值造型", "旅行"]`
|
|
|
|
|
|
>
|
|
|
|
|
|
> 排除赛道 JSON：`["动物", "明星娱乐", "音乐", "游戏", "人文", "体育", "影视", "舞蹈才艺", "数码科技", "三农", "健康医学", "汽车", "个人才艺", "财富理财", "学习教育", "潮流风尚", "身体锻炼", "居家装修", "化妆美容", "二次元"]`
|
|
|
|
|
|
>
|
|
|
|
|
|
> 获取数据后，在输出表格中剔除赛道属于排除列表的作品，并重新排列名次。
|
|
|
|
|
|
> 赛道为空或 `-`（未分类）的作品保留。
|
|
|
|
|
|
>
|
|
|
|
|
|
> 赛道名体系更新于 2026-08-19（对齐红狐 API 27 赛道标准名；08-19 二次调整：剔除个人才艺/财富理财/学习教育/潮流风尚/身体锻炼/居家装修，保留 9 个；09-01 第三次调整：剔除化妆美容，保留 8 个；09-01 第四次调整：剔除二次元，保留 7 个）。
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 2. 数据归档规则
|
|
|
|
|
|
|
|
|
|
|
|
### 2.1 目录结构
|
|
|
|
|
|
|
|
|
|
|
|
数据按类型分两个子文件夹存放：
|
|
|
|
|
|
|
|
|
|
|
|
| 数据类型 | 归档目录 | 说明 |
|
|
|
|
|
|
|---------|---------|------|
|
|
|
|
|
|
| **榜单数据**（日榜、七日飙升榜、热榜等） | `RedFox数据\榜单数据\YYYY-MM\` | 按月分文件夹，文件名含具体日期 |
|
|
|
|
|
|
| **信息源数据**（AI信息源、短剧信息源等） | `RedFox数据\信息源数据\YYYY-MM\` | 按月分文件夹 |
|
|
|
|
|
|
| **作品数据**（单作品爬取、账号诊断等） | `RedFox数据\作品数据\YYYY-MM-DD\` | 按日分文件夹 |
|
|
|
|
|
|
|
|
|
|
|
|
### 2.2 日期命名规则
|
|
|
|
|
|
|
|
|
|
|
|
- 归档文件夹日期按 **数据实际日期** 命名，**不是获取日期**。
|
|
|
|
|
|
- 例：8月8日获取8月7日的日榜 → 存入 `RedFox数据\榜单数据\2026-08\抖音日榜TOP50_2026-08-07.json`
|
|
|
|
|
|
- 例：8月8日获取8天前的七日飙升榜 → 存入 `RedFox数据\榜单数据\2026-08\抖音七日飙升榜TOP50_2026-08-01.json`
|
|
|
|
|
|
- 例：8月8日获取AI信息源（数据日期8月7日）→ 存入 `RedFox数据\信息源数据\2026-08\抖音AI信息源_2026-08-07.json`
|
|
|
|
|
|
- 例：8月8日爬取某作品详情（作品发布于8月5日）→ 存入 `RedFox数据\作品数据\2026-08-05\作品详情_xxx.json`
|
|
|
|
|
|
|
|
|
|
|
|
### 2.3 格式
|
|
|
|
|
|
|
|
|
|
|
|
- 统一以 **JSON 格式**（`.json`）归档，保留 API 返回的完整结构化字段，便于后续入库与查询。
|
|
|
|
|
|
- 输出展示时可在对话中以表格形式呈现，但落盘文件必须为 `.json`。
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 3. API Key 安全规则
|
|
|
|
|
|
|
|
|
|
|
|
- 红狐Hub API Key 仅通过环境变量 `REDFOX_API_KEY` 读取（`os.getenv("REDFOX_API_KEY")`）。
|
|
|
|
|
|
- **禁止**硬编码到代码中。
|
|
|
|
|
|
- **禁止**从系统文件读取。
|
|
|
|
|
|
- **未配置 Key 时**：脚本报错退出，提示「获取地址 + 运行 `python scripts/setup_redfox_key.py` 交互式输入」；引导用户输入**自己的** Key，不要代填、不要硬编码。
|
|
|
|
|
|
- 一键配置（推荐）：`python scripts/setup_redfox_key.py`（交互式输入，自动写入用户级环境变量）；`--check` 检查配置状态。
|
|
|
|
|
|
- 临时设置（仅当前终端有效）：`REDFOX_API_KEY=xxx python script.py`
|
|
|
|
|
|
|
|
|
|
|
|
### 3.1 部署到新电脑：让用户输入自己的 key
|
|
|
|
|
|
|
|
|
|
|
|
技能分发/部署到其他用户电脑时，**必须由用户配置自己的 key**（每个账号的 key 不同，禁止共用/预置）：
|
|
|
|
|
|
|
|
|
|
|
|
1. **运行配置引导脚本**（推荐，自动写入用户级环境变量）：
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
python scripts/setup_redfox_key.py # 交互式输入自己的 key
|
|
|
|
|
|
python scripts/setup_redfox_key.py --key ak_xxx # 部署脚本/CI 直传
|
|
|
|
|
|
python scripts/setup_redfox_key.py --check # 检查是否已配置
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
- Windows：自动写入用户级环境变量（HKCU\Environment）并广播刷新，新开终端即可生效
|
|
|
|
|
|
- macOS/Linux：打印 `export REDFOX_API_KEY=...` 指引，由用户追加到 `~/.zshrc` 或 `~/.bashrc`
|
|
|
|
|
|
|
|
|
|
|
|
2. **手动配置**（等价做法）：Windows 用 `[Environment]::SetEnvironmentVariable("REDFOX_API_KEY","<自己的key>","User")`；macOS/Linux 把 export 追加到 shell 配置文件。
|
|
|
|
|
|
|
|
|
|
|
|
3. **申请 key**：https://redfox.hk/settings/api-keys
|
|
|
|
|
|
|
|
|
|
|
|
> 脚本不包含任何真实 key，可随仓库分发；key 仅写入当前系统用户环境，不落入技能目录/仓库文件。
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 4. 技能存放路径
|
|
|
|
|
|
|
2026-09-03 10:40:27 +08:00
|
|
|
|
- 11 个子技能统一存放在 `subskills/` 目录下（随 mcn-data-insight 技能包分发）。
|
2026-09-03 09:53:07 +08:00
|
|
|
|
- 技能包根目录结构：`SKILL.md`（技能索引）+ `references/`（统一规则）+ `scripts/`（共享工具）+ `subskills/`（子技能）。
|
|
|
|
|
|
- 共享工具以技能包根目录为工作目录执行，例如 `python scripts/setup_redfox_key.py`。
|
|
|
|
|
|
- 运行数据统一输出到 `RedFox数据/`（相对技能包根目录，不存在则创建）。
|
2026-09-03 10:40:27 +08:00
|
|
|
|
- 技能包不含 `.workbuddy/`（原项目历史工作日志已随 2026-09-03 并入时清理，不随包分发）。
|
