maogeigei
a6a34794ca
红狐官方 EZTwMSse 涨粉榜技能补齐本地技能集（三榜 tab 最后一块）：
- 本地化：脚本 gzh_growth_fetcher.py→douyin_rise_fans.py，去自动写盘缓存/--from_cache（纯 stdout，落盘归执行层）
- SKILL.md 精简式重写（对齐 daily-hot），落盘规范 `抖音涨粉榜_{赛道}_{日期}.json`
- core_workflow.md：缓存描述改落盘规范、查看更多读本地 JSON、删子任务冲突声明
- 主 SKILL.md：清单 11→12、落盘表涨粉榜 ❌→✅、目录树/更新记录同步
- dsh 副本 diff=0 同步；真实 API 冒烟通过（美食周榜 TOP3）
313 lines
17 KiB
Markdown
313 lines
17 KiB
Markdown
---
|
||
name: third-party-skills-index
|
||
description: |
|
||
抖音数据获取技能集（原 Third-party Skills 百宝箱）— 红狐数据系列抖音榜单/搜索/诊断/作品技能 + 短剧信息源。
|
||
本文件为技能索引，说明各技能的安装位置、触发方式与安全约束。
|
||
当用户询问「有哪些技能可用」「抖音相关技能」「抖音榜单/热点/数据」「短剧信息源」等时参考。
|
||
---
|
||
|
||
# 抖音数据获取技能集（Third-party Skills 百宝箱）
|
||
|
||
> 本目录收录红狐数据系列抖音数据获取技能与短剧信息源（技能注册名 third-party-skills-index 沿用旧称）。
|
||
> 所有技能已通过安全加固：路径沙箱、API Key 环境变量保护、禁止系统文件读取。
|
||
|
||
---
|
||
|
||
## 技能清单
|
||
|
||
| # | 技能名称 | 目录 | 来源 | 核心能力 | 文件数 |
|
||
|---|---------|------|------|---------|--------|
|
||
| 1 | **douyin-account-diagnosis** | `subskills/douyin-account-diagnosis/` | [redfox-community](https://github.com/redfox-data/redfox-community) | 抖音账号六维度量化诊断，输出100分制评分+风险预警 | 10 |
|
||
| 2 | **douyin-daily-hot** | `subskills/douyin-daily-hot/` | [redfox-community](https://github.com/redfox-data/redfox-community) | 抖音每日点赞TOP50榜单，28赛道分类+30天回溯 | 6 |
|
||
| 3 | **douyin-hot-trend** | `subskills/douyin-hot-trend/` | [redfox-community](https://github.com/redfox-data/redfox-community) | 抖音热榜神器：实时/历史热榜、创作者洞察、HTML可视化报告、订阅推送 | 6 |
|
||
| 4 | **douyin-works-crawler** | `subskills/douyin-works-crawler/` | [redfox-community](https://github.com/redfox-data/redfox-community) | 抖音账号作品爬取，最多50条+互动TOP3分析 | 5 |
|
||
| 5 | **douyin-ai-feed** | `subskills/douyin-ai-feed/` | [redfox-community](https://github.com/redfox-data/redfox-community) | AI抖音信息源日报，抖音AI助手对话精选+HTML可视化报告 | 11 |
|
||
| 6 | **douyin-prohibited-word** | `subskills/douyin-prohibited-word/` | [redfox-community](https://github.com/redfox-data/redfox-community) | 抖音违禁词检测，加粗标记+智能替换建议+优化文案输出 | 5 |
|
||
| 7 | **douyin-content-surge** | `subskills/douyin-content-surge/` | [redfox-community](https://github.com/redfox-data/redfox-community) | 抖音每日点赞飙升榜：单日新增点赞TOP50，28赛道+30天回溯+订阅 | 6 |
|
||
| 8 | **douyin-weekly-surge** | `subskills/douyin-weekly-surge/` | [redfox-community](https://github.com/redfox-data/redfox-community) | 抖音七日点赞飙升榜：七日新增点赞TOP50，28赛道+30天回溯+订阅 | 6 |
|
||
| 9 | **douyin-search** | `subskills/douyin-search/` | [redfox-community](https://github.com/redfox-data/redfox-community) | 抖音作品查询：关键词搜爆款+日期范围筛选 | 3 |
|
||
| 10 | **douyin-top-account** | `subskills/douyin-top-account/` | [redfox-community](https://github.com/redfox-data/redfox-community) | 抖音账号影响力榜单追踪（日/周/月榜+回溯） | 11 |
|
||
| 11 | **playlet-douyin-feed** | `subskills/playlet-douyin-feed/` | [redfox-community](https://github.com/redfox-data/redfox-community) | 短剧抖音信息源：每日短剧爆款日报+题材聚类洞察 | 4 |
|
||
| 12 | **douyin-rise-ranking** | `subskills/douyin-rise-ranking/` | [redfox-community](https://github.com/redfox-data/redfox-community) | 抖音涨粉账号推荐（涨粉榜）：日/周/月涨粉TOP50（总粉丝数/涨粉率/粉丝增量），27赛道+回溯+三维分析 | 6 |
|
||
|
||
> 各子技能完整触发词与用法见对应目录内 SKILL.md（标准 Skill 结构）。
|
||
|
||
---
|
||
|
||
## 共享前置条件
|
||
|
||
### API Key（红狐数据服务）
|
||
|
||
本技能集各数据获取技能依赖红狐数据 API，共用同一把 Key：
|
||
|
||
- **环境变量名**：`REDFOX_API_KEY`
|
||
- **获取地址**：[红狐hub 密钥管理页](https://redfox.hk/settings/api-keys?source=github)
|
||
- **配置方式**：设置系统环境变量即可，所有技能自动读取
|
||
- **一键配置（推荐，部署到新电脑后运行一次）**：`python scripts/setup_redfox_key.py` 交互式输入自己的 Key（自动写入用户级环境变量，一次配置全部技能生效）；`--check` 可检查配置状态
|
||
- **Key 已存储**：记录在 `~/.workbuddy/MEMORY.md` 中，供跨会话使用
|
||
- **未配置 Key 时**：技能脚本会报错退出并提示「获取地址 + 运行 setup_redfox_key.py 输入 Key」，此时引导用户输入**自己的** Key，禁止硬编码
|
||
|
||
```bash
|
||
# 一键配置（推荐）
|
||
python scripts/setup_redfox_key.py
|
||
|
||
# 检查是否已配置
|
||
python scripts/setup_redfox_key.py --check
|
||
|
||
# 手动设置（临时）
|
||
# Windows PowerShell
|
||
$env:REDFOX_API_KEY="ak_xxx..."
|
||
|
||
# macOS / Linux
|
||
export REDFOX_API_KEY="ak_xxx..."
|
||
```
|
||
|
||
---
|
||
|
||
## 安全约束（所有技能统一执行）
|
||
|
||
> **🔴 路径引用铁律**：技能内一切文件引用必须用**相对路径**（md 链接相对自身文件解析、代码用 `__file__` 推导技能根；绝对路径随部署机器变化失效，禁止越级出技能根）→ [路径引用规范.md](references/规则/路径引用规范.md)
|
||
|
||
> 以下规则在安装时已写入各技能的 SKILL.md / core_workflow.md / Python 脚本中：
|
||
|
||
| 规则 | 说明 |
|
||
|------|------|
|
||
| **路径沙箱** | 所有文件操作仅限技能自身目录内，禁止读写技能目录外的任何路径 |
|
||
| **API Key 保护** | 仅从环境变量 `os.getenv("REDFOX_API_KEY")` 读取；禁止硬编码、禁止 .env/dotenv/配置文件读取、禁止在输出/日志中暴露 |
|
||
| **无系统命令** | 脚本不调用 subprocess / eval / exec / os.system 等 |
|
||
| **stdout 限定** | 脚本输出仅限 stdout（Markdown/JSON），不创建、修改或删除技能目录外的文件 |
|
||
| **禁止网络搜索降级** | API 查询失败时严禁联网搜索或从第三方渠道估算/补充数据 |
|
||
| **榜单数据落盘（白名单例外）** | 榜单查询产物落盘到 `抖音榜单/` 业务数据目录（详见下表），属「stdout 限定/路径沙箱」白名单例外 |
|
||
|
||
---
|
||
|
||
## 榜单数据落盘规范（白名单例外详则，09-03 定稿）
|
||
|
||
> 背景：红狐 API 按调用计费，榜单数据属「同日期固定」快照，重复查询=重复花钱。本规范强制「查询即缓存」，避免后续会话/任务为同一份榜单重复调用 API。
|
||
|
||
### 落盘目标（按运行环境 + 数据源分层）
|
||
|
||
> 桌面 `MCNSkill项目\` 顶层先分「业务账号层 / 三方数据层」：账号产出（分析、脚本等）直挂账号文件夹，**三方数据统一下 `三方数据\{数据源}\`**——后续数据获取不止一个数据源，每个数据源一个文件夹（当前红狐数据源=`红狐数据\`），其下再按数据类型分（抖音榜单/信息源数据/作品数据…）。**文件名不加数据源前缀**（保持 `抖音周榜_` 等榜名开头，兼容 dsh 工作台 RANKING_DIR 正则 `^抖音周榜_`）。
|
||
|
||
| 环境 | 落盘目录 |
|
||
|---|---|
|
||
| ①③ 用户环境 / 开发机（本机无 `.dsh`） | `C:\Users\maidou\Desktop\MCNSkill项目\三方数据\红狐数据\抖音榜单\` |
|
||
| ② dsh 环境（本机有 `.dsh`） | `D:\dshworkspace\抖音榜单\`（兼容工作台 RANKING_DIR 现有读取） |
|
||
|
||
### 文件命名（按工作台榜单 tab 对齐，09-03 截图实证）
|
||
|
||
`{榜名}_{赛道}_{数据日期}.json`——所有榜单一律此格式，按榜名区分：
|
||
|
||
| 工作台 tab | 类别 | 文件名（榜名部分） | 状态 |
|
||
|---|---|---|---|
|
||
| 1 账号周榜 | 账号影响力周榜 | `抖音周榜_{赛道}_{日期}.json` | ✅ 已实现（旧名保留，dsh 正则兼容） |
|
||
| 2 视频热榜 | 作品维热榜 | `抖音视频热榜_{赛道}_{日期}.json` | ❌ 预留 |
|
||
| 3 点赞榜 | 作品维点赞榜 | `抖音点赞榜_{赛道}_{日期}.json` | ❌ 预留 |
|
||
| 4 涨粉榜 | 账号维涨粉榜 | `抖音涨粉榜_{赛道}_{日期}.json` | ✅ 已实现（2026-09-03 补技能 douyin-rise-ranking） |
|
||
| 扩展 | 账号日榜/月榜、七日飙升榜、AI信息源等 | 同构命名追加 | ❌ 预留 |
|
||
|
||
### 查询幂等铁律（防重复花 API 钱）
|
||
|
||
1. **查询前先 `ls`** 本地 `抖音榜单/` 下对应文件 → **命中直接读本地输出（0 API 成本）**，回复中注明「缓存命中·本地读取」
|
||
2. **未命中**：调红狐 API 取数 → 立即按命名规则写入本地 → 输出（Markdown 表格对话回复 + JSON 落盘同步）
|
||
3. **同榜名+赛道+数据日期**只允许调一次 API；后续所有会话/任务均走本地缓存
|
||
4. 数据日期采用 API 返回的「榜单对应日期」（非获取时刻），与 `references/规则/抖音数据规则.md` §2.2 命名规则保持一致
|
||
5. 榜单缓存文件**不入技能包 git**（纯本地业务数据）；同包内 ai-feed/hot-trend HTML 日报等同原则——根目录新增 `.gitignore` 忽略 `subskills/*/output/` 及 `subskills/*/*.json` 缓存产物
|
||
|
||
---
|
||
|
||
## 各技能触发说明与使用示例
|
||
|
||
### 1. douyin-account-diagnosis — 抖音账号诊断
|
||
|
||
**触发词**：诊断抖音账号、抖音账号分析、抖音体检、抖音账号评估、分析这个抖音号
|
||
|
||
**使用示例**：
|
||
|
||
```
|
||
用户：帮我诊断一下抖音账号「桔桔的茶园小动物」
|
||
用户：分析这个抖音号 66456544107
|
||
用户：给 XX 做个抖音体检
|
||
用户：评估一下这个抖音账号值不值得合作
|
||
```
|
||
|
||
**输出**：100分制综合评分 + 六维度得分明细 + 六类风险预警 + 近期作品明细 + 优化建议
|
||
|
||
**脚本**：`scripts/douyin_diagnosis.py`（纯标准库，无外部依赖）
|
||
|
||
---
|
||
|
||
### 2. douyin-daily-hot — 抖音每日热门作品榜
|
||
|
||
**触发词**：抖音热榜、抖音日榜、抖音排名、抖音爆款、抖音最热、抖音TOP榜、抖音赛道榜单
|
||
|
||
**使用示例**：
|
||
|
||
```
|
||
用户：今天抖音什么最火？
|
||
用户：看看美食赛道排名
|
||
用户：5月20号的抖音榜单
|
||
用户：查看全部50条
|
||
```
|
||
|
||
**输出**：单日点赞TOP50榜单（Markdown表格），作品标题为可点击超链接
|
||
|
||
**脚本**：`scripts/douyin_daily_hot.py`（纯标准库 urllib，零外部依赖）
|
||
|
||
---
|
||
|
||
### 3. douyin-hot-trend — 抖音热榜神器
|
||
|
||
**触发词**：抖音热榜、今日热榜、历史热榜、热搜、热点趋势、订阅推送
|
||
|
||
**使用示例**：
|
||
|
||
```
|
||
用户：今日热榜
|
||
用户：近7天热榜
|
||
用户：对比昨天和今天的热榜
|
||
用户：订阅每日热榜推送
|
||
用户：5月15日热榜
|
||
```
|
||
|
||
**输出**：热榜表格（TOP20）+ 创作者洞察报告 + HTML 可视化页面（支持导出PDF）
|
||
|
||
**脚本**：`scripts/hotspot_fetcher.py`（数据获取）+ `scripts/gen_douyin_hot_html.py`（HTML生成）
|
||
|
||
---
|
||
|
||
### 4. douyin-works-crawler — 抖音作品爬取
|
||
|
||
**触发词**：爬取抖音作品、抖音作品列表、查看抖音视频、抖音内容采集、抓取抖音作品
|
||
|
||
**使用示例**：
|
||
|
||
```
|
||
用户：爬取"周幺姑家常菜"的抖音作品
|
||
用户：帮我查询抖音号 cdjjc028 的作品
|
||
用户：抖音内容采集 XXX
|
||
```
|
||
|
||
**输出**：账号基础信息（粉丝数/获赞/红狐指数）+ 近期作品列表（最多50条）+ 互动TOP3分析 + 账号特征总结
|
||
|
||
**脚本**：`scripts/douyin_works_fetcher.py`（纯标准库，零外部依赖）
|
||
|
||
---
|
||
|
||
### 5. douyin-ai-feed — AI抖音信息源
|
||
|
||
**触发词**：抖音AI助手、AI抖音日报、抖音AI信息流、抖音AI精选、AI信息源、AI抖音每日对话
|
||
|
||
**使用示例**：
|
||
|
||
```
|
||
用户：看看今天抖音AI助手有什么热门内容
|
||
用户：生成一份抖音AI信息源日报
|
||
用户：最近抖音AI都在聊什么？
|
||
用户：抓取抖音AI信息流，最近7天的
|
||
```
|
||
|
||
**输出**：抖音AI助手对话精选（标题+点赞+直达链接）+ 深色主题HTML可视化报告（技能目录 `output/` 下）
|
||
|
||
**脚本**：`scripts/fetch_douyin_ai.py`（依赖 requests 库，HTML 模板在 `assets/report_template.html`）
|
||
|
||
**注意**：原始订阅功能（launchctl/crontab）已因安全风险禁用，建议使用 WorkBuddy automation 替代定时执行。
|
||
|
||
---
|
||
|
||
### 6. douyin-prohibited-word — 抖音违禁词检测
|
||
|
||
**触发词**：抖音违禁词、抖音敏感词、抖音审核、限流词、脚本合规、口播文案合规
|
||
|
||
**使用示例**：
|
||
|
||
```
|
||
用户：帮我看下这段抖音脚本有没有违禁词：这款美白神器真的太有效了，用了三天就白了一个度
|
||
用户：[上传 script.docx] 帮我检查这个文档
|
||
用户：检测图片里的文字有没有违禁词 [上传字幕截图.png]
|
||
用户：帮我检测这个网页 https://example.com/article
|
||
```
|
||
|
||
**输出**：三个固定板块 — 🔍违禁词检测结果（加粗标记） → 💡修改建议（替换词+更换理由表格） → ✏️建议优化文案（替换后完整文案）；同时自动生成可下载的纯文本文件
|
||
|
||
**脚本**：`scripts/check_sensitive_words.py`（依赖 python-docx、beautifulsoup4、playwright 可选，有 requests 静态回退）
|
||
|
||
---
|
||
|
||
### 7. douyin-content-surge — 抖音每日点赞飙升榜
|
||
|
||
**触发词**：抖音飙升榜|点赞飙升|飙升排名|飙升榜|抖音飙升|内容飙升|抖音新增
|
||
|
||
**使用示例**：
|
||
|
||
```
|
||
用户：看看今天的抖音飙升榜
|
||
用户：美食赛道这几天什么在飙升
|
||
用户：给我 5 月 28 号的飙升榜
|
||
用户：帮我订阅美食赛道的每日飙升榜
|
||
```
|
||
|
||
**输出**：Markdown 表格格式 TOP20 榜单（作品标题可点击链接），含新增点赞/评论/分享/收藏数据；支持 --full 输出完整 50 条
|
||
|
||
**脚本**：`scripts/douyin_daily_increment.py`（仅 Python 标准库，零外部依赖）
|
||
|
||
---
|
||
|
||
### 8. douyin-weekly-surge — 抖音七日点赞飙升榜
|
||
|
||
**触发词**：抖音七日飙升榜|七日点赞飙升|周度飙升排名|周榜飙升|抖音七日新增|抖音周榜飙升
|
||
|
||
**使用示例**：
|
||
|
||
```
|
||
用户：看看今天的抖音七日飙升榜
|
||
用户：美食赛道七日飙升榜
|
||
用户：给我 5 月 28 号的七日飙升榜
|
||
用户：帮我订阅美食赛道的七日飙升推送
|
||
```
|
||
|
||
**输出**：Markdown 表格格式 TOP20 七日新增点赞榜单（作品标题可点击链接），含七日新增点赞/评论/分享/收藏数据
|
||
|
||
**脚本**：`scripts/douyin_weekly_surge.py`（仅 Python 标准库，零外部依赖）
|
||
|
||
---
|
||
|
||
## 目录结构总览
|
||
|
||
```
|
||
mcn-data-insight/（技能包根，随 短视频脚本创作/V1.0/subskills/ 分发）
|
||
├── SKILL.md ← 本文件（技能索引 / 百宝箱入口）
|
||
├── references/
|
||
│ └── 规则/
|
||
│ └── 抖音数据规则.md ← Key 配置 + 赛道过滤 + 技能存放路径 统一规则
|
||
├── scripts/ ← 共享脚本（以技能包根为工作目录执行）
|
||
│ ├── setup_redfox_key.py ← 一键配置 REDFOX_API_KEY（推荐）
|
||
│ ├── fetch_filtered_data.py ← 日榜赛道过滤抓取
|
||
│ └── fetch_meishi_30days.py ← 美食赛道 30 天回溯抓取
|
||
├── subskills/ ← 12 个数据获取子技能（标准 Skill 结构）
|
||
│ ├── douyin-account-diagnosis/ ← 抖音账号诊断（六维度量化评分）
|
||
│ ├── douyin-daily-hot/ ← 抖音每日热门作品榜（点赞 TOP50）
|
||
│ ├── douyin-hot-trend/ ← 抖音热榜神器（实时/历史热榜+HTML报告）
|
||
│ ├── douyin-works-crawler/ ← 抖音作品爬取（最多50条+互动TOP3）
|
||
│ ├── douyin-ai-feed/ ← AI抖音信息源日报
|
||
│ ├── douyin-prohibited-word/ ← 抖音违禁词检测
|
||
│ ├── douyin-content-surge/ ← 抖音每日点赞飙升榜
|
||
│ ├── douyin-weekly-surge/ ← 抖音七日点赞飙升榜
|
||
│ ├── douyin-search/ ← 抖音作品查询（关键词搜爆款+日期筛选）
|
||
│ ├── douyin-top-account/ ← 抖音账号影响力榜单（日/周/月榜）
|
||
│ ├── playlet-douyin-feed/ ← 短剧抖音信息源（短剧日报）
|
||
│ └── douyin-rise-ranking/ ← 抖音涨粉榜（日/周/月涨粉 TOP50，27 赛道）
|
||
```
|
||
|
||
每个子技能内部为标准 Skill 结构（SKILL.md + references/ + scripts/ 等），
|
||
README 中「安装到 ~/.workbuddy/skills/」为独立安装指引，不影响随包分发使用。
|
||
|
||
---
|
||
|
||
## 更新记录
|
||
|
||
| 日期 | 操作 |
|
||
|------|------|
|
||
| 2026-09-03 | 新增第 12 个子技能 **douyin-rise-ranking**（抖音涨粉榜，skillCode 官方 EZTwMSse）：日/周/月涨粉 TOP50、27 赛道、三维涨粉分析；本地化：脚本改名 douyin_rise_fans.py 去官方自动写盘缓存（纯 stdout）、查看更多改读本地落盘 JSON、落盘规范状态 ✅ 已实现（`抖音涨粉榜_{赛道}_{日期}.json`） |
|
||
| 2026-09-03 | 并入 短视频脚本创作/V1.0/subskills/mcn-data-insight/（去 git）：`.workbuddy/skills` → `subskills/`、scripts 上移、全量相对路径化；清理 `.workbuddy/` 历史存档与安全审计报告引用、去除同名嵌套；移除非数据获取技能（nuwa-skill 删除、multi-copywrite-alchemy 移至桌面），现为 11 个数据获取子技能 |
|