Introduction
All-platform content going global information sourceis an all-platform viral content tracking tool designed specifically for content going global creators, referencing the functionality and style design of the AI-Bilibili information source.
Through the Red Fox Hub API (queryContentExportTop), you can:
- 📊 Automatically scan all-platform (WeChat Official Accounts/Douyin/WeChat Channels/Xiaohongshu/Kuaishou/Bilibili) content going global Top 50 works daily
- 🏷️ Intelligently cluster topic directions based on the
topicfield returned by the API - 📈 Generate a visualized HTML daily report containing platform tags, cover images, engagement data, and creative insights
- 🔍 Support targeted queries by platform, keyword, and time range
Suitable for scenarios such as content going global creators, operations personnel, and MCN agencies that need to grasp traffic trends in all-platform content going global.
⚠️ Important: Data is updated daily at 15:00 with the previous day's data. When there is no data for the target date,automatically calling the interface is prohibited, and you must first inform the user and wait for confirmation.
⛔ Output specification: After the daily report is generated, the conversation replymust strictly follow the output template to output md content, and any free-form, omitted, or colloquial text is prohibited. See references/core_workflow.md for the terminal output format specification.
Features
🎯 Core Features
| Feature Module | Capability Description | Core Value |
|---|---|---|
| 📊 Viral Discovery | Obtain the Top 50 works by like count from all-platform content going global | Precisely locate high-heat content on each platform |
| 🏷️ Topic Clustering | Automatically cluster based on the topic field returned by the API; topic classification is entirely determined by the data | No predefined keywords required; dynamic categorization |
| 🌐 All-platform Coverage | Supports 6 major platforms: WeChat Official Accounts/Douyin/WeChat Channels/Xiaohongshu/Kuaishou/Bilibili | One-stop access to all-platform data |
| 🔍 Intelligent Query | Queries all platforms by default, and supports targeted queries by keyword and platform | Flexibly covers any niche direction |
| 📈 Creative Insights | Analyze content styles on each platform, cross-platform topic comparisons, and platform differentiation strategies | Deeply uncover platform characteristics and creative patterns |
| 🎨 Visualized Daily Report | White-themed HTML, platform tags + cover images + engagement data + direct work links | Intuitively display daily hot topics |
| 🔔 One-click Subscription | --subscribe Enable automatic daily output |
Daily reports are automatically accumulated in a local folder |
✨ Highlights
- ⚡ Intelligent Date Detection: The script has built-in
DATA_UPDATE_HOUR = 15constants, and automatically detects whether the target date is in a no-data interval before calling the interface - 🌐 All-platform Adaptation:The API returns the Top 50 for each platform. Official accounts are sorted by read count, and the rest by like count; for work links, directly use the url field returned by the API
- 🏷️ Platform Tags:In the HTML daily report, each work displays a colored platform tag (green for Official Accounts / black for Douyin / red for Xiaohongshu, etc.)
- 🔒 Safe and Reliable:The API Key is obtained through the environment variable
REDFOX_API_KEYand hardcoding is prohibited
One-Click Installation
Prerequisites
- Python 3 runtime environment
- A registered Honghu Hub account with an API Key obtained
Installation Steps
1. Get the API Key
Go to Honghu Hub official website to register. After logging in, get it in the personal center. The format is ak_xxxxxxxx. Newly registered users receive free credits.
2. Configure Environment Variables
macOS/Linux:
echo 'export REDFOX_API_KEY=ak_xxxxxxxx' >> ~/.zshrc
source ~/.zshrc
Windows(PowerShell):
[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "ak_xxxxxxxx", "User")
After configuration, you need torestart the terminalfor the environment variables to take effect.
3. Verify Configuration
# macOS/Linux
echo $REDFOX_API_KEY
# Windows
echo %REDFOX_API_KEY%
Environment Variable Configuration
| Variable Name | Required | Description |
|---|---|---|
REDFOX_API_KEY |
Yes | Honghu Hub API access key, authenticated via the X-API-KEY request header |
Usage Guide
Basic Usage
1. Generate the Latest Daily Report
python3 assets/daily_report.py --latest
Execution Flow:
- Automatically calculate the latest available date (15:00 rule)
- Query the Top 50 across all platforms (Official Accounts + Douyin + Video Accounts + Xiaohongshu + Kuaishou + Bilibili)
- Topic clustering + generate HTML daily report
- Automatically open in browser
⚠️ Date Pre-check Rule:If there is no data for the target date, you must first inform the user and wait for confirmation before executing.
2. Query a Specified Date
python3 assets/daily_report.py --date 2026-06-10
Historical dates already have data, so no confirmation is needed; query directly.
3. Query by Keyword
python3 assets/daily_report.py --keyword "品牌出海" --latest
Advanced Usage
1. Query a Specified Platform
# 仅查小红书和抖音
python3 assets/daily_report.py --platforms "3,1" --latest
# 仅查公众号
python3 assets/daily_report.py --platforms "0" --latest
Platform Number:0=Official Accounts, 1=Douyin, 2=Video Accounts, 3=Xiaohongshu, 4=Kuaishou, 6=Bilibili
2. Custom Time Range
python3 assets/daily_report.py \
--start-time "2026-06-10 08:00:00" \
--end-time "2026-06-15 20:00:00"
3. Use Cached Data
python3 assets/daily_report.py --from-cache
Load from ~/.workbuddy/cache/content_export_top_data.json , cache validity is 1 hour, no credits deducted.
4. Enable Daily Subscription
python3 assets/daily_report.py --subscribe
The daily report is automatically saved to ~/Downloads/QoderReports/, filename:内容出海日报_YYYY-MM-DD.html。
Common Commands Quick Reference
| Command | Function |
|---|---|
--latest |
Automatically use the latest date with data, skipping intervals with no data |
--date YYYY-MM-DD |
Query a specified date (no confirmation needed for historical dates) |
--keyword "关键词" |
Search keywords (fuzzy match title or user name) |
--platforms "0,1,3" |
Specify platforms, comma-separated (default all platforms) |
--from-cache |
Use cached data, no credits deducted |
--subscribe |
Enable daily subscription |
--unsubscribe |
Disable daily subscription |
--start-time / --end-time |
Custom time range |
--output-dir |
Custom output directory |
--api-key |
Specify API Key |
Use Cases
Use Case 1: Topic Reference for Content Going Global Creators
Role:Content going global creator
Needs:Understand popular topics and hit trends in the content going global market across all platforms, to guide topic selection decisions
How to Use:
- Execute daily
--latestto get the latest daily report - Analyze topic clustering results and focus on emerging volume signals
- Refer to viral title features and topic trend reports
Expected Benefits: Accurately grasp traffic trends across all platforms and improve topic selection hit rate
Scenario 2: Operations Team Competitor Monitoring
Role: Content globalization operations / MCN agencies
Needs: Track competitor accounts' performance on each platform and analyze viral content features
How to Use:
- Use
--keywordto query competitor keywords in a targeted way - Use
--platformsto follow core platforms - Enable
--subscribeto automatically compile daily reports
Expected Benefits: Stay informed of competitor developments in a timely manner and optimize your own operations strategy
Scenario 3: Content Trend Analysis
Role: Content planners / data analysts
Needs: Analyze content trends for content globalization across all platforms and provide data support for content planning
How to Use:
- Combine
--start-timeand--end-timeto analyze data for a time range - Use creative trend analysis to deeply uncover patterns
- Pay attention to cross-topic comparison suggestions and discover opportunities for topic fusion
Expected Benefits: Produce structured trend reports to support content strategy decisions
Project Architecture
Directory Structure
multi-content-feed/
├── SKILL.md # Skill主文档(本文件)
├── scripts/ # 脚本源码
│ └── playlet_xhs_daily.py # 日报生成脚本(开发版)
├── assets/ # Skill运行时资源
│ ├── daily_report.py # 日报生成脚本(运行时使用)
│ └── default_cover.png # 默认封面图(加载失败时的fallback)
└── references/ # 参考文档
├── core_workflow.md # 核心执行流程、格式模板、日期判断逻辑
└── examples.md # 使用示例与常见用法组合
Tech Stack
| Component | Technology | Description |
|---|---|---|
| Runtime Environment | Python 3 | Scripting Language |
| Data Source | RedFox Hub API | X-API-KEY request header authentication |
| API Endpoint | https://redfox.hk/story/api/parseWork/queryContentExportTop |
POST request |
| Supported Platforms | 0=WeChat Official Account, 1=Douyin, 2=WeChat Channels, 3=Xiaohongshu, 4=Kuaishou, 6=Bilibili | Top 50 per platform |
| Sorting Rules | WeChat Official Account sorted by readCount descending, others by likeCount descending | API built-in sorting |
| Data Storage | JSON cache | ~/.workbuddy/cache/content_export_top_data.json |
| Output Format | HTML + terminal Markdown | White theme, colored platform tags |
| Output Directory | ~/Downloads/QoderReports |
Customizable |
Core Module Description
| Module | File | Responsibility |
|---|---|---|
| API Call | fetch_content_export_top() |
Call the queryContentExportTop interface, parse platformGroups, deduplicate and sort |
| Topic Clustering | cluster_by_topic() |
Automatically cluster based on the topic field returned by the API |
| HTML Generation | generate_html_report() |
White-theme daily report, platform tags + hide when interaction data is 0 |
| Date Calculation | calculate_latest_date() |
Automatically calculate available dates using the 15:00 rule |
| Cache Management | load_cache()/save_cache() |
1-hour validity, deduplicate based on photoId |
Data Flow
用户请求 → 日期预检(15:00规则) → 用户确认
↓
API调用(queryContentExportTop全平台+去重+排序)
↓
题材聚类(基于topic字段自动归类)
↓
HTML日报生成 + 终端摘要输出
↓
深度分析(漏斗结构,3个层级)
FAQ
Installation-Related Questions
Q1: What should I do if I see "REDFOX_API_KEY environment variable not found" during installation?
A: Please check according to the following steps:
- Confirm that the API Key is configured correctly (Windows:
[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "ak_xxx", "User")) - After configuration,Restart the terminalMake the environment variables take effect
- Verify:
echo %REDFOX_API_KEY%should output your Key value
Q2: How do I obtain an API Key?
A: Go to Red Fox Hub official website to register an account. After logging in, obtain it in the personal center. The format is ak_xxxxxxxx. Newly registered users receive free credits.
Usage-related questions
Q3: How often is the data updated?
A: The previous day's data is updated daily at 15:00.
- Before 15:00: latest available date = the day before yesterday (T-2)
- After 15:00: latest available date = yesterday (T-1)
Q4: What should I do if I cannot query any data?
A: Possible reasons:
- There is no data for the target date yet (the 15:00 update time has not arrived)
- Insufficient API Key permissions or exhausted credits
- Network connection issue
It is recommended to first use --from-cache to check the cache, or try a different date.
Troubleshooting
Q5: UnicodeEncodeError when executing in Windows PowerShell?
A: The script output contains emoji, so UTF-8 encoding must be set:
$env:PYTHONIOENCODING='utf-8'
python assets/daily_report.py --latest
Q6: Images fail to load in the HTML daily report?
A: The script has a built-in fallback mechanism. When loading fails, it automatically displays the default cover image (assets/default_cover.png). Some cover image URLs use the HEIF format, and the script automatically converts them to JPG format to improve compatibility.
Security and licensing
Q7: How is data security ensured?
A:
- The API Key is obtained only through environment variables; hardcoding is prohibited
- Single data source: only the Red Fox Hub API is used; independent collection is prohibited
- Cache files are stored locally
~/.workbuddy/cache/
📚 Reference documentation
- core_workflow.md — core execution flow, output format templates, date judgment logic, field mapping, parameter descriptions
- examples.md — usage examples and common usage combinations