Douyin Weekly Surge logo

Douyin Weekly Surge

Community
redfox-data
douyin-weekly-surge

抖音七日点赞飙升榜查询工具。周度收录全平台抖音作品,输出七日新增点赞TOP50榜单,支持按赛道分类查询、历史日期回溯(最多30天)。当用户查询抖音七日飙升榜、抖音周榜飙升、抖音七日点赞飙升、抖音周度飙升榜时使用。触发词:抖音七日飙升榜、七日点赞飙升、周度飙升排名、周榜飙升、抖音七日新增、抖音周榜飙升。当接口返回积分不足(code=3210)时,自动唤起支付宝完成充值后继续查询。

Overview

Publisherredfox-data
Repositoryredfox-community
Skill namedouyin-weekly-surge
Stars
449
Forks
59
Bundled files
5
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 5 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by redfox-data on GitHub. Read the source before you install it.

Installation

Install the Douyin Weekly Surge AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/redfox-data/redfox-community/tree/main/skills/douyin-weekly-surge
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/redfox-data/redfox-community.git /tmp/redfox-community
mkdir -p .claude/skills
cp -r /tmp/redfox-community/skills/douyin-weekly-surge .claude/skills/douyin-weekly-surge
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Douyin Weekly Surge in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Douyin Weekly Surge on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Douyin Weekly Surge is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

抖音七日点赞飙升榜

📝 简介

周度内容飙升监测工具,每日收录核验全平台万级抖音作品,输出七日新增点赞 TOP50 榜单。

  • 更新时间:每日 17:00 更新过去七日数据
  • 回溯范围:最多回溯过去 30 天
  • 每个分类最多返回 50 条

✨ 功能特性

功能模块能力描述核心价值
周度飙升每日输出七日新增点赞 TOP50 榜单发现七日持续增长的作品
赛道筛选支持 28 个赛道分类查询精准定位垂直领域飙升内容
历史回溯支持回溯过去 30 天数据追溯往期飙升趋势
可点击链接作品标题以超链接格式输出一键跳转查看原作品
分页展示默认 TOP20,可查看完整 TOP50按需获取全量或摘要数据
订阅推送支持赛道和时间偏好订阅定时获取飙升动态

🔑 鉴权

前往 红狐hub 获取 API Key,通过以下方式配置:

bash
# 方式一:配置文件(如 OpenClaw 的 ~/.openclaw/openclaw.json)
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }

# 方式二:终端环境变量
export REDFOX_API_KEY="ak_xxxx..."

📡 API 调用

  • 接口地址:POST https://redfox.hk/story/api/dy/search/hotContentRank
  • 认证方式:请求头 X-API-KEY,值从环境变量 REDFOX_API_KEY 获取
  • 固定参数:source(值见脚本)
  • 可选参数:type(赛道)、startTime(日期)

详见 api-config.md。

💳 积分不足充值(支付宝接管)

当脚本 scripts/douyin_weekly_surge.py 以退出码 3 结束、并在 stdout 打印 ===PAYMENT_REQUIRED_JSON_START=== 区块时,表示当前 API Key 积分不足(接口 code=3210,兼容 3201)。响应体 data 内含结构化支付信息:cashierUrl(支付宝收银台链接)、amount(订单金额,元)、goodsName(商品名称)、outTradeNo(订单号)。

脚本退出码说明:0 正常返回(含"暂无数据");1 参数/鉴权/接口错误;3 积分不足,需要充值 —— 按 references/alipay-recharge.md 唤起支付宝充值,到账后自动用原始参数重跑脚本。

完整的前置检查、alipay-bot trigger-payment-signal → submit-payment → poll-payment-status 编排步骤、钱包绑定处理、支付接管规则与失败处理,统一见 references/alipay-recharge.md(通用流程,可被其他 skill 复用)。submit-payment 后由 Agent 用 poll-payment-status --out-shake-no <查询单号> 自动监听支付回调到账,无需用户再手动确认;到账(outcome=success)后自动用用户原始的查询参数重新运行 scripts/douyin_weekly_surge.py 输出结果。

🔄 交互流程

1. 时间判断

用户输入处理方式
今天 / 当前 / 最新回复说明最新为昨日,提供截至昨日的七日数据
未来日期回复提示,提供截至昨日的七日数据
30天内历史日期直接查询对应日期
超过30天前回复提示,提供最接近时间范围内的数据

时间提示语:

  • 当日/未来:「非常抱歉🙏,我们最新的是截至昨日的七日数据,将为您提供最接近您需求的七日飙升榜。」
  • 超出回溯:「非常抱歉🙏,目前榜单最多支持回溯「过去30天」,我将为您查询最接近您需求的时间范围~」

2. 赛道判断

将用户描述归类至以下支持赛道,未能匹配时明确告知并列出全部赛道,询问用户选择:

全部、小剧场、财富理财、二次元、身体锻炼、居家装修、数码科技、科学普及、
旅行、美食、动物、明星娱乐、汽车、亲子、人文、三农、潮流风尚、游戏、
生活记录、体育、舞蹈才艺、学习教育、休闲玩乐、影视、音乐、颜值造型、
健康医学、综艺、个人成长

3. 默认行为

无特殊说明时,默认返回截至昨日的七日全品类飙升榜。所有查询(包括全品类和特定赛道)均默认展示 TOP20,用户明确要求查看完整榜单时再输出全部 50 条数据。

📊 标准输出格式

榜单以 Markdown 表格呈现,作品标题必须使用 [标题](workUrl) 格式输出为可点击的超链接:

markdown
💡 榜单说明:每日 17:00 更新过去七日数据,[如有时间偏差提示则插入]。飙升数据为七日新增统计,与累计总量存在差异。

📊 抖音七日点赞飙升TOP20(截至 YYYY-MM-DD)[查询全部时含"赛道"列,查询特定赛道时不含]

| 排名 | 作品标题 | 作者 | 赛道* | 七日新增收藏 | 七日新增评论 | 七日新增分享 | **七日新增点赞** | 发布时间 |
|------|---------|------|-------|---------|---------|---------|------------|---------|
| 1 | [红烧肉的教程](https://www.douyin.com/video/xxx) | 美食达人 | 美食 | 10w+ | 10w+ | 10w+ | **10w+** | 05-28 12:00 |

*查询特定赛道时去掉"赛道"列

⚡ 更多操作
• 本次榜单完整共50条数据,是否需要查看剩余30条?

📬 订阅服务
1️⃣ 我们每日 17:00 更新过去七日数据,是否需要订阅每日的抖音作品七日飙升排行,订阅后定时推送给您
2️⃣ 是否需要订阅具体赛道的作品表现?我们支持:[列出28个赛道]

作品标题超链接规范

  • 作品标题必须以 Markdown 链接格式输出:[作品标题](workUrl)
  • workUrl 为接口返回的 share_url 字段
  • 禁止使用 HTML <a> 标签或终端 OSC 转义序列

数据字段说明

字段来源字段说明
排名数组位置按七日新增点赞降序排列
作品标题aweme_desc + share_url展示为超链接格式,见上方规范
作者user_nickname账号名
赛道category仅全品类查询时展示
七日新增收藏 / 七日新增评论 / 七日新增分享 / 七日新增点赞add_collect_count / add_comment_count / add_share_count / add_digg_count七日新增互动数据(入库时间快照),七日新增点赞列数值需加粗显示
发布时间create_time_str格式 MM-DD HH:00

📬 文件输出与订阅

  • 默认展示 20 条;用户请求完整版时输出 Markdown 表格(含 50 条)
  • 订阅:支持用户选择赛道和时间偏好,按每日 17:00 更新后自动推送

📚 其他资源

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Douyin Weekly Surge AI skill do?

抖音七日点赞飙升榜查询工具。周度收录全平台抖音作品,输出七日新增点赞TOP50榜单,支持按赛道分类查询、历史日期回溯(最多30天)。当用户查询抖音七日飙升榜、抖音周榜飙升、抖音七日点赞飙升、抖音周度飙升榜时使用。触发词:抖音七日飙升榜、七日点赞飙升、周度飙升排名、周榜飙升、抖音七日新增、抖音周榜飙升。当接口返回积分不足(code=3210)时,自动唤起支付宝完成充值后继续查询。

Why use Douyin Weekly Surge on TypingMind?

Because you install it once and use it with any model. Douyin Weekly Surge is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Douyin Weekly Surge in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/redfox-data/redfox-community/tree/main/skills/douyin-weekly-surge. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Douyin Weekly Surge?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Douyin Weekly Surge?

As many as you like. As long as a model supports skills, you can use Douyin Weekly Surge with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Douyin Weekly Surge AI skill free?

It is published on GitHub by redfox-data. Check the repository for licensing terms. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇