douyin-subscribe
抖音账号订阅追踪 — 通过抖音号订阅账号(最多20个),Agent 每日 9:00 自动拉取并生成 HTML 报告。账号 ID 直接内置于自动化命令中,无需文件存储。支持多抖音号批量订阅,自动生成精美 HTML 作品报告,终端/Markdown 表格按账号依次展示作品标题、收藏、评论、分享、点赞、发布时间等数据。当用户订阅抖音账号、追踪抖音作品更新、监控抖音竞品账号时使用。触发词:抖音订阅、抖音账号订阅、抖音订阅追踪、抖音作品订阅、抖音账号监控、抖音作品追踪、抖音每日推送、抖音日报。
Install
npx skills add https://github.com/redfox-data/redfox-community/tree/main/skills/douyin-subscribe
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install redfox-data-redfox-community@llmmart
git clone https://github.com/redfox-data/redfox-community.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole redfox-data/redfox-community collection as a plugin from our marketplace. Git is the plain clone.
README
抖音账号订阅追踪 / douyin-subscribe
简介
通过抖音号订阅竞对、同类和关注账号,每天自动获取最新作品数据,生成可视化报告,轻松掌握抖音动态。
核心价值
- 一键订阅:发送抖音号即可订阅,无需复杂配置,最多支持 20 个账号
- 每日自动推送:每天早上 9:00 自动拉取订阅账号的最新作品,无需手动操作
- 可视化报告:自动生成精美 HTML 报告,支持预览和分享,数据一目了然
- 全维度数据:收藏数、评论数、分享数、点赞数、发布时间,关键指标全覆盖
适用对象
- 📊 内容运营 — 追踪竞品账号动态,及时发现爆款内容趋势
- 🎬 短视频创作者 — 监控同赛道头部账号,获取创作灵感与数据参考
- 🏢 品牌 / MCN — 批量管理关注账号,每日自动收到作品日报
功能特性
核心功能
- 抖音号直接订阅:通过抖音号订阅账号,简单透明
- 每日自动拉取:订阅后每天 9:00 自动获取最新作品数据
- HTML 可视化报告:自动生成精美报告文件,含数据总结与爆款 TOP5
- 作品超链接:标题和账号名均可点击跳转详情页
- 智能日期策略:默认查前一天,无数据自动回溯近 7 天,也支持自定义日期范围
- 多账号分组展示:按账号依次分组,同账号内按分享数降序排列
密钥获取与安全说明
- 本技能需要使用环境变量:
REDFOX_API_KEY。 REDFOX_API_KEY由 红狐 hub (https://redfox.hk)提供。- 请前往 红狐 hub 注册账号,获取
REDFOX_API_KEY。 - 配置设备环境变量
REDFOX_API_KEY后使用本技能。 - 在提供密钥前,请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。
- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。
使用指南
直接用自然语言说出你想订阅的抖音号即可,无需记忆命令。
常用说法速查
| 意图 | 示例话术 | 效果 |
|---|---|---|
| 订阅账号 | 「订阅 Fish688688」 | 自动验证并订阅,展示最新作品数据 |
| 批量订阅 | 「订阅 abc123, def456, ghi789」 | 一次订阅多个账号 |
| 查看特定日期 | 「查一下 2026-06-01 到 2026-06-05 的作品」 | 按日期范围拉取历史作品 |
| 取消订阅 | 「取消订阅 Fish688688」 | 从订阅列表中移除该账号 |
输出示例
订阅成功后,你将收到:
- Markdown 作品表格:按账号分组展示,含收藏数、评论数、分享数、点赞数
- HTML 可视化报告:自动保存至
report/目录,含数据总结与爆款 TOP5 - 总结统计:突出账号表现 + 高频话题 TOP5
使用场景
| 场景 | 角色 | 示例问法 | 收益 |
|---|---|---|---|
| 竞品监控 | 内容运营 | 「订阅竞品的抖音号,每天看他们的作品」 | 每日自动获取竞品动态,不错过爆款 |
| 赛道追踪 | 短视频创作者 | 「订阅这几个头部账号,追踪他们的内容」 | 及时掌握赛道趋势,获取创作灵感 |
| 批量管理 | MCN / 品牌 | 「把这些账号都订阅上,统一管理」 | 最多 20 个账号批量订阅,日报自动推送 |
| 历史回溯 | 内容分析师 | 「查一下上周这些账号的作品数据」 | 支持自定义日期范围查询历史数据 |
Skill manifest
抖音账号订阅追踪
📝 简介
通过抖音号订阅竞对、同类和关注账号(最多 20 个),自动抓取最新作品。账号 ID 直接传入命令行参数,不依赖任何本地文件存储,自动化任务中硬编码所有已订阅的抖音号。
✨ 功能特性
| 功能模块 | 能力描述 | 核心价值 |
|---|---|---|
| 账号直传 | 通过 --accounts 参数直接传入抖音号,无需文件存储 |
简单透明,命令即文档 |
| 每日自动推送 | 自动化任务内置账号 ID,每天早上 9:00 自动执行 | 定时获取,无需手动操作 |
| HTML 报告 | fetch 时自动生成精美 HTML 报告文件,支持预览和分享 | 可视化浏览,一目了然 |
| 作品数据 | 收藏数、评论数、分享数、点赞数、发布时间 | 全维度数据,一目了然 |
| 按账号展示 | 终端表格按账号依次分组展示 | 清晰直观,便于对比 |
| 日期回溯 | 支持指定历史日期查询 | 追溯往期作品数据 |
🔑 鉴权
获取 API Key
请前往 红狐hub 获取API KEY
配置 API Key
方案1: 以OpenClaw为例,将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中:
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
方案2: 终端配置
export REDFOX_API_KEY="ak_xxxx..."
⚙️ 使用方式
拉取作品(核心命令)
# 基础用法:直接传入抖音号列表
python3 "$SKILL_PATH/scripts/subscribe.py" fetch --accounts "YuZhouXiaoLi1220,Fish688688"
# 生成 HTML 报告(自动保存到 report/ 目录)
python3 "$SKILL_PATH/scripts/subscribe.py" fetch --accounts "YuZhouXiaoLi1220,Fish688688" --html
# 指定 HTML 报告输出路径
python3 "$SKILL_PATH/scripts/subscribe.py" fetch --accounts "YuZhouXiaoLi1220,Fish688688" --html --html-path ~/Desktop/report.html
# Markdown 格式输出(供 Agent 展示)
python3 "$SKILL_PATH/scripts/subscribe.py" fetch --accounts "YuZhouXiaoLi1220,Fish688688" --markdown
# 指定单日日期
python3 "$SKILL_PATH/scripts/subscribe.py" fetch --accounts "YuZhouXiaoLi1220,Fish688688" --html --date 2026-06-01
# 指定日期范围
python3 "$SKILL_PATH/scripts/subscribe.py" fetch --accounts "YuZhouXiaoLi1220,Fish688688" --html --date-start 2026-06-01 --date-end 2026-06-05
参数说明
| 命令 | 参数 | 说明 |
|---|---|---|
fetch |
--accounts |
抖音号列表(必填或核心参数),逗号分隔,如 "id1,id2,id3" |
--date |
指定单日日期 YYYY-MM-DD | |
--date-start |
指定日期范围开始 YYYY-MM-DD | |
--date-end |
指定日期范围结束 YYYY-MM-DD | |
--markdown |
输出 Markdown 格式表格 | |
--html |
生成 HTML 报告文件(保存到 report/ 目录) | |
--html-path |
自定义 HTML 报告输出路径 | |
| 全局 | --api-key |
指定 API Key |
依赖
| 依赖 | 安装命令 |
|---|---|
requests |
pip3 install requests |
🤖 每日自动推送
用户订阅账号后,Agent 会创建一个每日定时任务,每天早上 9:00 自动执行。任务命令中直接包含所有已订阅的抖音号 ID:
# 自动化任务中的实际命令(账号已内置)
python3 subscribe.py fetch --accounts "YuZhouXiaoLi1220,Fish688688" --html
工作原理
- 用户发送抖音号 → Agent 将其写入自动化命令的
--accounts参数 - 每天 9:00 定时触发 → 命令自带账号 ID → 直接调 API 拉数据
- 自动生成 HTML 报告 → 保存至
report/目录 - 不依赖任何本地 JSON 文件
🔧 账号管理规则(Agent 必须遵守)
核心原则:所有订阅状态 = 自动化命令中的
--accounts参数。无文件存储。
订阅新账号流程
当用户提供新的抖音号时,Agent 必须按以下步骤操作:
Step 1:查询现有自动化任务
使用 automation_update mode=list 获取所有「抖音订阅」相关的自动化任务,读取每个任务的 --accounts 参数中的账号列表。
Step 2:判断是否追加 / 新建
| 条件 | 操作 |
|---|---|
| 现有账号数 + 新账号数 ≤ 20 | 追加到现有自动化任务的 --accounts 参数(去重后用逗号拼接) |
| 现有账号数 + 新账号数 > 20 | 创建新的自动化任务,将超出部分放入新任务的 --accounts |
| 用户明确要求取消某账号 | 从对应自动化任务的 --accounts 中移除该 ID |
Step 3:更新/创建自动化任务
- 追加场景:调用
automation_update mode=update,修改现有任务的prompt字段中的--accounts值 - 新建场景:调用
automation_update mode=create,新建一个独立的每日定时任务(同样 9:00 执行),名称可加序号如「抖音订阅作品日报 #2」
Step 4:立即拉取一次
无论追加还是新建,都必须立即执行一次 fetch(带 --html)展示最新结果给用户。
多任务示例
假设已有 18 个账号,用户又提供了 5 个新账号:
现有任务 #1: --accounts "id1,id2,...,id18" (18个)
新增 5 个: id19,id20,id21,id22,id23
→ 任务 #1 更新为: --accounts "id1,...,id18,id19,id20" (20个 ✅)
→ 新建任务 #2: --accounts "id21,id22,id23" (3个 ✅)
每个独立任务都会在每天 9:00 各自执行,各自生成 HTML 报告。
取消订阅
从对应任务的 --accounts 中移除该 ID 即可。如果移除后某个任务剩余 0 个账号,则删除该自动化任务。
📋 交互规范
订阅流程
静默执行原则:所有中间步骤(fetch 验证、add 订阅、automation_update)均不得向用户输出任何过程性提示(如「正在验证账号」「账号验证通过」「自动订阅中」等)。仅向用户展示最终结果。
- 用户发送抖音号 → Agent 静默执行
fetch --accounts "抖音号" --html --markdown验证账号 - 判断账号状态(规则 1):
- 接口返回正常数据:
- 静默执行 add 订阅(见下一步)
- 近 30 天无数据,自动回溯半年后仍无数据:
- 告知用户:「抱歉您订阅的“xxx”账号近半年都未发布过作品,如果需要数据核查可联系工作人员邮箱 redfoxdata@proton.me 处理」
- 询问用户:「是否订阅明日推送?」
- 用户回答「订阅」→ 静默执行 add 订阅
- 用户未确认 → 不订阅
- 接口返回正常数据:
- 静默查询现有自动化任务的
--accounts列表,判断追加 or 新建:- 现有账号数 + 新账号数 ≤ 20 → 追加到现有任务的
--accounts - 现有账号数 + 新账号数 > 20 → 新建一个自动化任务放溢出部分
- 现有账号数 + 新账号数 ≤ 20 → 追加到现有任务的
- 静默更新/创建自动化任务
- 若 fetch 返回了作品数据:
- 自动打开 HTML 报告预览(
preview_url) - 对话中展示 Markdown 作品表格
- 提示:「如需查看特定时间段的作品,可以告诉我,如“查一下 2026-06-01 到 2026-06-05 的作品”」
- 自动打开 HTML 报告预览(
- 若 fetch 无作品数据(账号存在但时段内无更新):仅告知用户无更新,不生成 HTML 报告
- 输出顺序:先按账号名升序分组,同账号内按分享数降序排列
- 若某个账号在指定时间范围内无更新作品,直接告知用户:「账号名:该时间段内无更新作品」
重要:仅当 fetch 返回实际作品数据时,才需要三输出——Markdown 表格 + HTML 报告预览 + HTML 报告文件。无作品数据时不生成 HTML 报告。
对话输出格式(订阅/拉取时必须遵循)
Agent 执行 fetch 后,必须在对话回复中按以下格式输出数据(不是只依赖脚本终端输出):
格式一:账号概览表
## 📊 订阅报告
| 项目 | 值 |
|------|-----|
| 新订阅 | `新账号名`(粉丝量) |
| 当前总账号 | N 个 |
| 本次拉取作品 | N 条 |
| 自动化任务 | 已更新 ✅ 每天 9:00 自动执行 |
### 账号概览
| 账号 | 粉丝量 | 领域 | 代表作数据 |
|------|--------|------|-----------|
| AccountA | xxx | 领域 | 🏆 代表作:收藏x / 点赞x / 分享x |
格式二:每个账号的详细作品表(Markdown)
### ▸ AccountName(粉丝: xxx)
| 作品标题 | 收藏数 | 评论数 | 分享数 | 点赞数 | 发布时间 |
|---------|--------|--------|--------|--------|---------|
| 标题1 | 10.8w | 2.8k | 10.3w | 19.3w | 06-08 |
要求:
- 每个账号一个子标题 + 一个完整 Markdown 表格
- 标题列使用 API 返回的
content字段完整原文(脚本内部映射为title),不截断 - 数值列使用
format_number后的可读格式(如 10.8w、2.3k) - 发布时间截取到
MM-DD HH:mm - 按分享数降序排列
格式三:总结统计(必须附加在所有表格之后)
### 对上述作品的总结
> 1. **突出的账号表现**:...
> 2. **高频事件 TOP5**:...
输出完整性清单
每次订阅/拉取,对话中必须包含以下全部内容:
- 账号概览表(含总览信息)
- 每个账号一个 Markdown 作品详情表
- 无更新账号提示(如有)
- 总结统计分析
- 规则 2 适用:已订阅账号昨日无数据时,结尾附加邮箱核查提示
- 规则 3 适用:被频率限制拒绝的账号提示
- 仅当有作品数据时:自动打开 HTML 报告预览(preview_url)+ HTML 报告文件已生成说明(附文件路径)
抖音号要求
接口通过 uniqueName(抖音展示ID)查询,脚本将用户提供的抖音号统一按 uniqueName 传入,userId 和 shortId 固定为空字符串。订阅时必须提供抖音号。
重要: 若用户只输入账号名称(如"李佳琦""老高與小茉")而未提供抖音号,必须提示:
"抖音账号名称存在多个重名情况,请提供准确的抖音号以便精准订阅。"
并附上获取抖音号的示例图供用户参考:

数据规则
- 每个自动化任务最多 20 个账号(超限时 Agent 自动创建新任务,详见「账号管理规则」)
- 规则 1:未订阅账号(首次验证查询):
- 默认查询近 30 天数据
- 若近 30 天无数据,自动回溯近半年(180 天)
- 若近半年仍无数据,告知用户:「抱歉您订阅的“xxx”账号近半年都未发布过作品,如果需要数据核查可联系工作人员邮箱 redfoxdata@proton.me 处理」
- 规则 2:已订阅账号(日常拉取):
- 默认查前一天数据(T-1)
- 若昨日无数据,告知用户:「昨日该账号暂未发布作品」
- 结尾固定提示:「如果需要数据核查可联系工作人员邮箱 redfoxdata@proton.me 处理」
- 规则 3:失败阈值保护:
- 同一抖音号在 6 小时内累计 3 次 API 调用失败后,后续请求将被拒绝
- 拒绝时提示:「当前账号订阅已超过失败阈值,请联系客服邮箱 redfoxdata@proton.me 处理」
- 距上次失败超过 6 小时 / 同一账号查询成功,计数归零,恢复正常调用
- 用户指定日期不回溯:若用户明确指定了日期或日期范围,查不到数据时直接告知用户,不自动回溯
- 支持日期范围查询:用户可指定起止日期(
--date-start YYYY-MM-DD --date-end YYYY-MM-DD)拉取历史作品 - 每账号最多返回 10 条作品
- 排序方式:账号名升序 → 同账号内分享数降序
- 无数据提示:若某个账号在指定时间范围内无更新作品,脚本会输出「账号名:该时间段内无更新作品」,Agent 需将此信息原样转达给用户
- 接口不支持多账号同时查询,脚本自动拆分后逐账号调用并整合数据
输出表格结构(脚本终端格式,仅供参考)
脚本终端输出原始格式如下,但 Agent 对话中必须使用「对话输出格式」中的 Markdown 表格重新排版:
▸ Fish688688(粉丝: 249w+)
──────────────────────────────────────────────────────────────
作品标题 收藏数 评论数 分享数 点赞数 发布时间
──────────────────────────────────────────────────────────────
今晚图省事... 10.8w 2.8k 10.3w 19.3w 05-21 21:40
作品标题使用 API content 字段(脚本内部映射为 title),链接使用 opusUrl 字段(脚本内部映射为 workUrl)。Markdown 输出中标题自动渲染为可点击超链接:[标题](workUrl)。
注意:当前广域库 API 不返回
followerCount(粉丝数),账号概览中粉丝量显示为-。
总结统计
表格展示完毕后,必须严格按以下格式附加总结:
对上述作品的总结:
- 突出的账号表现:指出数据最亮眼的账号及其代表作品
- 高频事件 TOP5:提炼所有作品中提到次数最多的 5 个事件/话题,并归纳每个事件对应的不同观点(不足 5 个可提炼的,按实际数量呈现,禁止虚构)
Files (redfox-community)
-
references
-
test_api_params.json 1.1 KB
Loading…
-
-
scripts
-
subscribe.py 54.4 KB
Loading…
-
-
README.en.md 4.1 KB
Loading… -
README.md 3.5 KB
# 抖音账号订阅追踪 / douyin-subscribe --- ## 简介 通过抖音号订阅竞对、同类和关注账号,每天自动获取最新作品数据,生成可视化报告,轻松掌握抖音动态。 **核心价值** - **一键订阅**:发送抖音号即可订阅,无需复杂配置,最多支持 20 个账号 - **每日自动推送**:每天早上 9:00 自动拉取订阅账号的最新作品,无需手动操作 - **可视化报告**:自动生成精美 HTML 报告,支持预览和分享,数据一目了然 - **全维度数据**:收藏数、评论数、分享数、点赞数、发布时间,关键指标全覆盖 **适用对象** - 📊 **内容运营** — 追踪竞品账号动态,及时发现爆款内容趋势 - 🎬 **短视频创作者** — 监控同赛道头部账号,获取创作灵感与数据参考 - 🏢 **品牌 / MCN** — 批量管理关注账号,每日自动收到作品日报 --- ## 功能特性 ### 核心功能 - **抖音号直接订阅**:通过抖音号订阅账号,简单透明 - **每日自动拉取**:订阅后每天 9:00 自动获取最新作品数据 - **HTML 可视化报告**:自动生成精美报告文件,含数据总结与爆款 TOP5 - **作品超链接**:标题和账号名均可点击跳转详情页 - **智能日期策略**:默认查前一天,无数据自动回溯近 7 天,也支持自定义日期范围 - **多账号分组展示**:按账号依次分组,同账号内按分享数降序排列 --- ## 密钥获取与安全说明 - 本技能需要使用环境变量:`REDFOX_API_KEY`。 - `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=github) (`https://redfox.hk`)提供。 - 请前往 [红狐 hub](https://redfox.hk?source=github) 注册账号,获取 `REDFOX_API_KEY`。 - 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。 - 在提供密钥前,请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。 - 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。 --- ## 使用指南 直接用自然语言说出你想订阅的抖音号即可,无需记忆命令。 ### 常用说法速查 | 意图 | 示例话术 | 效果 | | ---- | -------- | ---- | | 订阅账号 | 「订阅 Fish688688」 | 自动验证并订阅,展示最新作品数据 | | 批量订阅 | 「订阅 abc123, def456, ghi789」 | 一次订阅多个账号 | | 查看特定日期 | 「查一下 2026-06-01 到 2026-06-05 的作品」 | 按日期范围拉取历史作品 | | 取消订阅 | 「取消订阅 Fish688688」 | 从订阅列表中移除该账号 | ### 输出示例 订阅成功后,你将收到: - **Markdown 作品表格**:按账号分组展示,含收藏数、评论数、分享数、点赞数 - **HTML 可视化报告**:自动保存至 `report/` 目录,含数据总结与爆款 TOP5 - **总结统计**:突出账号表现 + 高频话题 TOP5 --- ## 使用场景 | 场景 | 角色 | 示例问法 | 收益 | | ---- | ---- | -------- | ---- | | 竞品监控 | 内容运营 | 「订阅竞品的抖音号,每天看他们的作品」 | 每日自动获取竞品动态,不错过爆款 | | 赛道追踪 | 短视频创作者 | 「订阅这几个头部账号,追踪他们的内容」 | 及时掌握赛道趋势,获取创作灵感 | | 批量管理 | MCN / 品牌 | 「把这些账号都订阅上,统一管理」 | 最多 20 个账号批量订阅,日报自动推送 | | 历史回溯 | 内容分析师 | 「查一下上周这些账号的作品数据」 | 支持自定义日期范围查询历史数据 | --- -
SKILL.md 14.4 KB
--- name: douyin-subscribe display_name: 抖音账号订阅追踪 display_name_en: Douyin Account Subscribe description: 抖音账号订阅追踪 — 通过抖音号订阅账号(最多20个),Agent 每日 9:00 自动拉取并生成 HTML 报告。账号 ID 直接内置于自动化命令中,无需文件存储。支持多抖音号批量订阅,自动生成精美 HTML 作品报告,终端/Markdown 表格按账号依次展示作品标题、收藏、评论、分享、点赞、发布时间等数据。当用户订阅抖音账号、追踪抖音作品更新、监控抖音竞品账号时使用。触发词:抖音订阅、抖音账号订阅、抖音订阅追踪、抖音作品订阅、抖音账号监控、抖音作品追踪、抖音每日推送、抖音日报。 description_zh: 抖音账号订阅追踪工具,订阅后每日9点自动拉取最新作品并生成HTML报告。 description_en: Subscribe to Douyin accounts and get their latest works pulled automatically at 9:00 every day with a polished HTML report. category: data version: 1.1.0 author: 红狐数据 --- # 抖音账号订阅追踪 ## 📝 简介 通过抖音号订阅竞对、同类和关注账号(最多 20 个),自动抓取最新作品。**账号 ID 直接传入命令行参数,不依赖任何本地文件存储**,自动化任务中硬编码所有已订阅的抖音号。 --- ## ✨ 功能特性 | 功能模块 | 能力描述 | 核心价值 | |---------|---------|---------| | 账号直传 | 通过 `--accounts` 参数直接传入抖音号,无需文件存储 | 简单透明,命令即文档 | | 每日自动推送 | 自动化任务内置账号 ID,每天早上 9:00 自动执行 | 定时获取,无需手动操作 | | HTML 报告 | fetch 时自动生成精美 HTML 报告文件,支持预览和分享 | 可视化浏览,一目了然 | | 作品数据 | 收藏数、评论数、分享数、点赞数、发布时间 | 全维度数据,一目了然 | | 按账号展示 | 终端表格按账号依次分组展示 | 清晰直观,便于对比 | | 日期回溯 | 支持指定历史日期查询 | 追溯往期作品数据 | --- ## 🔑 鉴权 ### 获取 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: 终端配置 ```bash export REDFOX_API_KEY="ak_xxxx..." ``` --- ## ⚙️ 使用方式 ### 拉取作品(核心命令) ```bash # 基础用法:直接传入抖音号列表 python3 "$SKILL_PATH/scripts/subscribe.py" fetch --accounts "YuZhouXiaoLi1220,Fish688688" # 生成 HTML 报告(自动保存到 report/ 目录) python3 "$SKILL_PATH/scripts/subscribe.py" fetch --accounts "YuZhouXiaoLi1220,Fish688688" --html # 指定 HTML 报告输出路径 python3 "$SKILL_PATH/scripts/subscribe.py" fetch --accounts "YuZhouXiaoLi1220,Fish688688" --html --html-path ~/Desktop/report.html # Markdown 格式输出(供 Agent 展示) python3 "$SKILL_PATH/scripts/subscribe.py" fetch --accounts "YuZhouXiaoLi1220,Fish688688" --markdown # 指定单日日期 python3 "$SKILL_PATH/scripts/subscribe.py" fetch --accounts "YuZhouXiaoLi1220,Fish688688" --html --date 2026-06-01 # 指定日期范围 python3 "$SKILL_PATH/scripts/subscribe.py" fetch --accounts "YuZhouXiaoLi1220,Fish688688" --html --date-start 2026-06-01 --date-end 2026-06-05 ``` ### 参数说明 | 命令 | 参数 | 说明 | |------|------|------| | `fetch` | **`--accounts`** | **抖音号列表(必填或核心参数),逗号分隔,如 `"id1,id2,id3"`** | | | `--date` | 指定单日日期 YYYY-MM-DD | | | `--date-start` | 指定日期范围开始 YYYY-MM-DD | | | `--date-end` | 指定日期范围结束 YYYY-MM-DD | | | `--markdown` | 输出 Markdown 格式表格 | | | `--html` | 生成 HTML 报告文件(保存到 report/ 目录) | | | `--html-path` | 自定义 HTML 报告输出路径 | | 全局 | `--api-key` | 指定 API Key | ### 依赖 | 依赖 | 安装命令 | |------|----------| | `requests` | `pip3 install requests` | --- ## 🤖 每日自动推送 用户订阅账号后,Agent 会创建一个**每日定时任务**,**每天早上 9:00** 自动执行。任务命令中**直接包含所有已订阅的抖音号 ID**: ```bash # 自动化任务中的实际命令(账号已内置) python3 subscribe.py fetch --accounts "YuZhouXiaoLi1220,Fish688688" --html ``` ### 工作原理 1. 用户发送抖音号 → Agent 将其写入自动化命令的 `--accounts` 参数 2. 每天 9:00 定时触发 → 命令自带账号 ID → 直接调 API 拉数据 3. 自动生成 HTML 报告 → 保存至 `report/` 目录 4. **不依赖任何本地 JSON 文件** --- ## 🔧 账号管理规则(Agent 必须遵守) > **核心原则:所有订阅状态 = 自动化命令中的 `--accounts` 参数。无文件存储。** ### 订阅新账号流程 当用户提供新的抖音号时,Agent **必须**按以下步骤操作: #### Step 1:查询现有自动化任务 使用 `automation_update mode=list` 获取所有「抖音订阅」相关的自动化任务,读取每个任务的 `--accounts` 参数中的账号列表。 #### Step 2:判断是否追加 / 新建 | 条件 | 操作 | |------|------| | 现有账号数 + 新账号数 **≤ 20** | **追加到现有自动化任务的 `--accounts` 参数**(去重后用逗号拼接) | | 现有账号数 + 新账号数 **> 20** | **创建新的自动化任务**,将超出部分放入新任务的 `--accounts` | | 用户明确要求取消某账号 | 从对应自动化任务的 `--accounts` 中移除该 ID | #### Step 3:更新/创建自动化任务 - **追加场景**:调用 `automation_update mode=update`,修改现有任务的 `prompt` 字段中的 `--accounts` 值 - **新建场景**:调用 `automation_update mode=create`,新建一个独立的每日定时任务(同样 9:00 执行),名称可加序号如「抖音订阅作品日报 #2」 #### Step 4:立即拉取一次 无论追加还是新建,**都必须立即执行一次 fetch**(带 `--html`)展示最新结果给用户。 ### 多任务示例 假设已有 18 个账号,用户又提供了 5 个新账号: ``` 现有任务 #1: --accounts "id1,id2,...,id18" (18个) 新增 5 个: id19,id20,id21,id22,id23 → 任务 #1 更新为: --accounts "id1,...,id18,id19,id20" (20个 ✅) → 新建任务 #2: --accounts "id21,id22,id23" (3个 ✅) ``` 每个独立任务都会在每天 9:00 各自执行,各自生成 HTML 报告。 ### 取消订阅 从对应任务的 `--accounts` 中移除该 ID 即可。如果移除后某个任务剩余 0 个账号,则删除该自动化任务。 --- ## 📋 交互规范 ### 订阅流程 > **静默执行原则:所有中间步骤(fetch 验证、add 订阅、automation_update)均不得向用户输出任何过程性提示(如「正在验证账号」「账号验证通过」「自动订阅中」等)。仅向用户展示最终结果。** 1. **用户发送抖音号** → Agent **静默执行 `fetch --accounts "抖音号" --html --markdown`** 验证账号 2. **判断账号状态**(规则 1): - **接口返回正常数据**: - **静默执行** add 订阅(见下一步) - **近 30 天无数据,自动回溯半年后仍无数据**: - 告知用户:「抱歉您订阅的“xxx”账号近半年都未发布过作品,如果需要数据核查可联系工作人员邮箱 redfoxdata@proton.me 处理」 - **询问用户**:「是否订阅明日推送?」 - 用户回答「订阅」→ **静默执行** add 订阅 - 用户未确认 → 不订阅 3. **静默查询现有自动化任务**的 `--accounts` 列表,判断追加 or 新建: - 现有账号数 + 新账号数 ≤ 20 → 追加到现有任务的 `--accounts` - 现有账号数 + 新账号数 > 20 → 新建一个自动化任务放溢出部分 4. **静默更新/创建自动化任务** 5. **若 fetch 返回了作品数据**: - 自动打开 HTML 报告预览(`preview_url`) - 对话中展示 Markdown 作品表格 - 提示:「如需查看特定时间段的作品,可以告诉我,如“查一下 2026-06-01 到 2026-06-05 的作品”」 6. **若 fetch 无作品数据**(账号存在但时段内无更新):仅告知用户无更新,不生成 HTML 报告 7. 输出顺序:**先按账号名升序**分组,同账号内按**分享数降序**排列 8. 若某个账号在指定时间范围内无更新作品,直接告知用户:「**账号名**:该时间段内无更新作品」 > **重要:仅当 fetch 返回实际作品数据时,才需要三输出——Markdown 表格 + HTML 报告预览 + HTML 报告文件。无作品数据时不生成 HTML 报告。** ### 对话输出格式(订阅/拉取时必须遵循) Agent 执行 fetch 后,**必须在对话回复中按以下格式输出数据**(不是只依赖脚本终端输出): #### 格式一:账号概览表 ```markdown ## 📊 订阅报告 | 项目 | 值 | |------|-----| | 新订阅 | `新账号名`(粉丝量) | | 当前总账号 | N 个 | | 本次拉取作品 | N 条 | | 自动化任务 | 已更新 ✅ 每天 9:00 自动执行 | ### 账号概览 | 账号 | 粉丝量 | 领域 | 代表作数据 | |------|--------|------|-----------| | AccountA | xxx | 领域 | 🏆 代表作:收藏x / 点赞x / 分享x | ``` #### 格式二:每个账号的详细作品表(Markdown) ```markdown ### ▸ AccountName(粉丝: xxx) | 作品标题 | 收藏数 | 评论数 | 分享数 | 点赞数 | 发布时间 | |---------|--------|--------|--------|--------|---------| | 标题1 | 10.8w | 2.8k | 10.3w | 19.3w | 06-08 | ``` 要求: - 每个账号一个子标题 + 一个完整 Markdown 表格 - 标题列使用 API 返回的 `content` 字段完整原文(脚本内部映射为 `title`),不截断 - 数值列使用 `format_number` 后的可读格式(如 10.8w、2.3k) - 发布时间截取到 `MM-DD HH:mm` - 按**分享数降序**排列 #### 格式三:总结统计(必须附加在所有表格之后) ```markdown ### 对上述作品的总结 > 1. **突出的账号表现**:... > 2. **高频事件 TOP5**:... ``` #### 输出完整性清单 每次订阅/拉取,对话中**必须包含**以下全部内容: - [ ] 账号概览表(含总览信息) - [ ] 每个账号一个 Markdown 作品详情表 - [ ] 无更新账号提示(如有) - [ ] 总结统计分析 - [ ] **规则 2 适用**:已订阅账号昨日无数据时,结尾附加邮箱核查提示 - [ ] **规则 3 适用**:被频率限制拒绝的账号提示 - [ ] **仅当有作品数据时**:自动打开 HTML 报告预览(preview_url)+ HTML 报告文件已生成说明(附文件路径) ### 抖音号要求 接口通过 `uniqueName`(抖音展示ID)查询,脚本将用户提供的抖音号统一按 `uniqueName` 传入,`userId` 和 `shortId` 固定为空字符串。订阅时**必须提供抖音号**。 **重要:** 若用户只输入账号名称(如"李佳琦""老高與小茉")而未提供抖音号,必须提示: > "抖音账号名称存在多个重名情况,请提供准确的**抖音号**以便精准订阅。" 并附上获取抖音号的示例图供用户参考:  ### 数据规则 - **每个自动化任务最多 20 个账号**(超限时 Agent 自动创建新任务,详见「账号管理规则」) - **规则 1:未订阅账号(首次验证查询)**: - 默认查询近 30 天数据 - 若近 30 天无数据,自动回溯近半年(180 天) - 若近半年仍无数据,告知用户:「抱歉您订阅的“xxx”账号近半年都未发布过作品,如果需要数据核查可联系工作人员邮箱 redfoxdata@proton.me 处理」 - **规则 2:已订阅账号(日常拉取)**: - 默认查前一天数据(T-1) - 若昨日无数据,告知用户:「昨日该账号暂未发布作品」 - 结尾固定提示:「如果需要数据核查可联系工作人员邮箱 redfoxdata@proton.me 处理」 - **规则 3:失败阈值保护**: - 同一抖音号在 6 小时内累计 3 次 API 调用失败后,后续请求将被拒绝 - 拒绝时提示:「当前账号订阅已超过失败阈值,请联系客服邮箱 redfoxdata@proton.me 处理」 - 距上次失败超过 6 小时 / 同一账号查询成功,计数归零,恢复正常调用 - **用户指定日期不回溯**:若用户明确指定了日期或日期范围,查不到数据时直接告知用户,不自动回溯 - **支持日期范围查询**:用户可指定起止日期(`--date-start YYYY-MM-DD --date-end YYYY-MM-DD`)拉取历史作品 - 每账号最多返回 **10 条**作品 - 排序方式:账号名升序 → 同账号内**分享数降序** - **无数据提示**:若某个账号在指定时间范围内无更新作品,脚本会输出「**账号名**:该时间段内无更新作品」,Agent 需将此信息原样转达给用户 - 接口不支持多账号同时查询,脚本自动拆分后逐账号调用并整合数据 ### 输出表格结构(脚本终端格式,仅供参考) 脚本终端输出原始格式如下,但 **Agent 对话中必须使用「对话输出格式」中的 Markdown 表格重新排版**: ``` ▸ Fish688688(粉丝: 249w+) ────────────────────────────────────────────────────────────── 作品标题 收藏数 评论数 分享数 点赞数 发布时间 ────────────────────────────────────────────────────────────── 今晚图省事... 10.8w 2.8k 10.3w 19.3w 05-21 21:40 ``` 作品标题使用 API `content` 字段(脚本内部映射为 `title`),链接使用 `opusUrl` 字段(脚本内部映射为 `workUrl`)。Markdown 输出中标题自动渲染为可点击超链接:`[标题](workUrl)`。 > **注意**:当前广域库 API 不返回 `followerCount`(粉丝数),账号概览中粉丝量显示为 `-`。 ### 总结统计 表格展示完毕后,必须严格按以下格式附加总结: > 对上述作品的总结: > 1. **突出的账号表现**:指出数据最亮眼的账号及其代表作品 > 2. **高频事件 TOP5**:提炼所有作品中提到次数最多的 5 个事件/话题,并归纳每个事件对应的不同观点(不足 5 个可提炼的,按实际数量呈现,禁止虚构)
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.