SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillsdouyin-hot-trend

douyin-hot-trend

General & other

View repository

Updated 10-15 23:47

About this skill

Douyin Hot List

Overview

Douyin Hot List is a data tool for real-time tracking of trending topics on the Douyin platform, integrated with Honghu Hub data API, updating hot list content hourly, and providing in-depth analysis from a creator's perspective.

Through simple natural language commands, you can:

  • 📊 Real-time hot list query: scraper Douyin TOP 50 list every 60 minutes, synchronizing popularity scores and jump links
  • 📅 Historical hot list backtracking: covers historical data from the past 7 days and past 30 days, supports searching by date and keywords
  • 🔀 Hot list data comparison: compare hot list changes between any two points in time (e.g., yesterday vs. today)
  • 💡 In-depth insight analysis: provides topic selection opportunities, title patterns, and trend predictions from a creator's perspective
  • 🔔 Personalized subscription: supports hourly or daily scheduled pushes of hot list data

Suitable for content creators, short video operators, MCN agencies, brand marketers, and others who need to track Douyin hot topics, find creative inspiration, and formulate content strategies.

Technical foundation：Python 3.x + requests library, obtaining data through the Honghu Hub APIKey.

Features

🎯 Core features

  • 📊 Real-time hot list: get the current Douyin TOP 50 hot list, refreshed hourly, displaying ranking, popularity score, topic title, and jump link
  • 📅 Historical backtracking: supports querying historical hot lists from the past 7 days or past 30 days, covering up to 30 days
  • 💡 Creator insights: automatically generates topic selection opportunity analysis, title pattern breakdowns, trend predictions, and action recommendations
  • 📄 Visual report: one-click generation of a purple minimalist-style HTML page, supports PDF export, each record can be clicked to jump
  • 🔔 Subscription push: supports hourly or daily scheduled pushes, automatically tracking hot topic changes

✨ Highlights

  • ⚡ Natural language interaction: just enter "Today's Hot List", "Past 7 Days Hot List", etc. to query, no need to memorize command parameters
  • 🔒 Three-level authentication fallback: API Key is preferentially read from environment variables, automatically falling back to Shell configuration files
  • ✅ Data consistency: tables, insights, HTML, and PDF data are consistent across the entire chain, with no processing or beautification
  • 🎬 Creator perspective: every insight answers "how to use it", providing actionable recommendations

One-click installation

Prerequisites

  • Python 3.x and requests library installed
  • Registered Honghu Hub official website account and obtained API Key (format ak_xxxxxxxx）
  • Newly registered users will receive free credits and can start using immediately

Installation method

Method 1: WorkBuddy (Lobster) skill installation (recommended)

  1. Copy the douyin-hot-trend skill folder to WorkBuddy's skills directory
  2. In the WorkBuddy conversation, directly say "Douyin Hot List" or "Today's Hot List", and the Agent will automatically load this skill
  3. Configure API Key (see "Environment Variable Configuration" below)
  4. Install Python dependencies:
pip install requests

Method 2: Manual installation in Cursor / other Agent environments

  1. Place the skill folder into the skills directory of the corresponding environment
  2. Ensure the Agent can read SKILL.md and references/core_workflow.md
  3. Configure the REDFOX_API_KEY environment variable
  4. Run pip install requests

Environment Variable Configuration

Variable Name Required Description
REDFOX_API_KEY Yes RedFox Hub API access key, format ak_xxxxxxxx

Configuration Method(choose one):

# 方式一：直接设置环境变量（推荐）
export REDFOX_API_KEY=ak_xxxxxxxx

# 方式二：写入 Shell 配置文件（~/.bashrc / ~/.bash_profile / ~/.zshrc）
echo 'export REDFOX_API_KEY=ak_xxxxxxxx' >> ~/.bashrc
source ~/.bashrc

If the environment variable is not configured, the skill will automatically read from the Shell configuration file; if it still cannot be obtained, it will prompt for configuration at runtime.

Configure the Key in WorkBuddy: You can set it in the system environment variables as REDFOX_API_KEY, or write it into the Shell configuration file and restart WorkBuddy; there is no need to pass it manually in each conversation.

Usage Guide

Basic Usage

1. View Real-Time Trending List

Tell the assistant you want to view current Douyin trending topics:

User: Douyin trending list Assistant: Showing you the Douyin real-time trending list TOP 20 (including ranking, popularity value, and topic links), along with a creator insights report.

2. View Historical Trending Lists

Query historical data for a specified time range:

User: Trending list for the past 7 days Assistant: Showing you the Douyin historical trending list for the past 7 days, supporting tracing the evolution of hot topics by date.

User: Trending list for April 15 Assistant: Querying the trending list data for April 15 for you.

3. Load the Full List

By default, TOP 20 is displayed; you can continue loading up to TOP 50:

User: Continue loading Assistant: Showing you TOP 21–50 and generating an HTML report containing the full TOP 50.

Advanced Usage

1. Creator Insights

After the trending list is displayed, in-depth analysis is automatically output:

User: Today's trending list Assistant: (After displaying the table) Output viral topic opportunities, title formula breakdowns, trend predictions, and action recommendations.

2. Trending List Comparison

Compare trending list changes between two points in time:

User: Compare yesterday's and today's trending lists Assistant: Comparing the rankings and popularity changes of the two days' trending lists for you, marking newly entered and dropped topics.

3. Subscription Push

Set up scheduled automatic push:

User: Subscribe to daily trending list push Assistant: Daily push has been set up; the full TOP 50 trending list data will be automatically pushed at the specified time.

User: Unsubscribe Assistant: Scheduled push has been canceled.

4. Generate Reports

A visual report is automatically generated for each query:

User: Today's trending list Assistant:(After the query is complete) An HTML page and PDF file have been generated. The data and table display are completely consistent, and clickable navigation is supported.

Common Commands Quick Reference

Command Function
Douyin Hot List / Today's Hot List Query the real-time hot list TOP 20
Yesterday's Hot List Query yesterday's hot list
Hot List for the Past 7 Days Query the historical hot list for the past 7 days
Hot List for the Past 30 Days Query the historical hot list for the past 30 days
Hot List for X Month X Day Query the hot list for a specified date
Continue Loading / Load More Load the complete TOP 21–50 list
Subscribe to Daily/Hourly Push Notifications Set scheduled push notifications
Unsubscribe Stop scheduled push notifications

Use Cases

Use Case 1: Content creators finding topics

Role: Douyin short video creator

Needs: Quickly understand platform hot topics every day and find creative directions suitable for one's own niche

How to Use：

  1. Say "Today's Hot List" every morning to get the latest hot topics
  2. View the creator insights report to get topic suggestions and title formulas
  3. Directly apply transferable topics to quickly produce content

Expected Benefits: Shorten topic selection time and improve content hit rate

Use Case 2: MCN agency operations management

Role: MCN operations staff

Needs: Monitor platform hot topic trends and provide topic guidance and content strategies for affiliated influencers

How to Use：

  1. Subscribe to daily hot list push notifications to automatically get the latest hot topics
  2. View historical hot lists to analyze the patterns of hot topic evolution
  3. Share insight reports with the influencer team to guide content creation

Expected Benefits: Improve the timeliness and precision of the team's content strategy

Use Case 3: Brand marketing leveraging hot topics

Role: Brand marketing manager

Needs: Timely discover hot topics that can be leveraged and formulate marketing plans that ride hot topics

How to Use：

  1. Follow the daily hot list and filter hot topics that match the brand's tone
  2. Analyze trend predictions and plan content in advance
  3. Export HTML/PDF reports for team communication and proposal presentations

Expected Benefits: Improve the response speed and leveraging effect of brand hot topics

Use Case 4: Short video operations learning and research

Role: Short video operations beginner

Needs: Learn the creation patterns of viral content and improve operational capabilities

How to Use：

  1. Regularly view the hot list and creator insights
  2. Learn title formulas and emotional trigger words
  3. Imitate transferable topics for practice

Expected Benefits: Quickly build content sense and master viral creation methodologies

Project Architecture

Directory Structure

douyin-hot-trend/
├── SKILL.md                          # 技能说明文档（当前文件）
├── references/
│   └── core_workflow.md              # Agent 核心工作流指令
├── scripts/
│   ├── hotspot_fetcher.py            # 热榜数据获取脚本
│   └── gen_douyin_hot_html.py        # HTML 可视化报告生成脚本
└── assets/
    └── douyin_hot_trend_template.html # HTML 页面模板

Core Module Description

Module File Responsibilities
Data Retrieval hotspot_fetcher.py Call the RedFox Hub API to retrieve Douyin trending list JSON, supporting real-time and historical queries
Report Generation gen_douyin_hot_html.py Render the trending list data into a purple minimalist-style HTML, supporting PDF export
Page Template douyin_hot_trend_template.html Standalone HTML template, supporting quick replacement of placeholders for generation

Tech Stack

Category Description
Runtime Environment Python 3.x
HTTP Requests Native requests library
Authentication Method X-API-KEY request header, three-level fallback (environment variable → Shell config → prompt config)
Data Source RedFox Hub API
Deployment Platform Agent environments such as WorkBuddy / Cursor

FAQ

Installation-related Questions

Q1: What should I do when the runtime reports "Missing REDFOX_API_KEY configuration"?

A: Please troubleshoot by following these steps:

  1. Confirm that you have registered a RedFox Hub account and obtained an API Key in the personal center
  2. Set the environment variable:export REDFOX_API_KEY=ak_xxxxxxxx
  3. Or write it to the Shell configuration file and then run source ~/.bashrc to make it take effect
  4. Confirm that the API Key format is correct, starting with ak_ starts with

Q2: Which Python dependencies need to be installed?

A: Only the requests library is needed:pip install requests

Q3: How do I enable this skill in WorkBuddy (Lobster)?

A: Place the skill folder into WorkBuddy's skills directory, configure REDFOX_API_KEY and then say "Douyin trending list" in the conversation to trigger it. The Agent will follow references/core_workflow.md to execute the complete workflow.

Usage-related Questions

Q4: How often is the trending list data updated?

A: It is updated once per hour. Each query calls the API to retrieve the latest data and does not rely on local cache.

Q5: How far back can historical data be queried?

A: Historical trending lists from the past 30 days are supported at most. Data older than 30 days is not currently supported.

Troubleshooting

Q6: What should I do if the API call fails?

A: Please troubleshoot in the following order:

  1. Check the network connection and confirm that you can access https://redfox.hk?source=github
  2. Confirm that the API Key has not expired and whether the account has sufficient credits
  3. Check the environment variable:echo $REDFOX_API_KEY
  4. Retry later; the API service may be experiencing temporary fluctuations

Q7: What should I do if I do not receive subscription push notifications?

A: Confirm that the subscription has been set up successfully. If you need to set it up again, say "Unsubscribe" and then subscribe again. If the problem persists, check whether automated tasks in systems such as WorkBuddy are running normally.

Q8: What should I do if the HTML report preview is unsuccessful or displays blank?

A: Please handle it as follows:

  1. Confirm that the HTML file has been generated successfully (the script will output ✅ 已生成 prompt)
  2. Directly double-click to open the delivered HTML file and view it in a Chrome/Edge browser; do not rely on built-in previews in systems such as WorkBuddy
  3. If the file has been delivered but the built-in preview is blank, this is a known limitation—Chinese username paths on Windows may cause compatibility issues with the preview component; opening it directly in a browser will display it normally

Security and Licensing

Q9: How should the API Key be stored securely?

A: It is recommended to store it via environment variables or a shell configuration file; do not write the Key into a code repository or share it publicly. This skill supports a three-level authentication fallback, prioritizing reading from environment variables to avoid passing it in plaintext during conversations.

Q10: Data sources and usage permissions?

A: The trending data comes from the Red Fox Hub official API. When using it, you must comply with the Red Fox Hub platform terms of service and the relevant regulations of the Douyin platform. This skill is only for data display and analysis assistance and does not guarantee the compliance of the data for commercial use.

Get Help

If you have other questions, you can get help through the following methods:

  • 📖 Consult the Agent Execution Reference:references/core_workflow.md
  • 🌐 Red Fox Hub official website:https://redfox.hk?source=github
  • 📧 Contact Red Fox Hub platform customer service for support on API-related issues

Agent Execution Reference: For complete execution-level instructions such as operation steps, output formats, and data rules, please consult references/core_workflow.md。