Introduction
Xiaohongshu Viral Cover Generation is an AI cover design tool built specifically for Xiaohongshu content creators. Based on 2,000+ viral post data continuously collected across the entire web every day, it deeply captures the visual elements of viral covers in the same niche, uses AI intelligent analysis to summarize high-conversion visual patterns, and generates actionable cover design plans that fit the post content and match the platform's traffic aesthetics.
With a simple topic description, you can:
- 🔍 Automatically parse creative intent and accurately extract key information
- 📊 Obtain real viral cover images in the target field, with AI analysis summarizing style characteristics
- 🎨 Combine user needs with viral data to generate actionable design plans (including examples + image generation prompts)
Suitable for scenarios such as Xiaohongshu bloggers, content operations, brands, and MCN agencies that need to increase post cover click-through rates.
Features
🎯 Core Features
- 🧠 Intelligent Intent Parsing: Automatically parses user copy intent and extracts content topic, type, style preferences, and core keywords
- 📊 Viral Data Query: Calls the Honghu Data API to obtain four-dimensional viral data: low followers with high likes, most likes, single-day interaction explosion, and 7-day continuous growth
- 🖼️ AI Image Analysis: Identifies visual elements such as text, scene, color tone, and composition in viral cover images one by one, and categorizes and summarizes style patterns
- 🎨 Custom Plan Generation: Combines user needs with viral style characteristics to output three differentiated cover design plans (including image generation prompts)
✨ Highlights
- 📈 Data-Driven: Based on 2,000+ real viral post data updated daily, rejecting guesswork design
- ⚡ Full-Process Automation: From intent parsing to plan generation, a 7-step standard process completed with one click
- 🎯 Precise Matching: Intelligent scoring and filtering mechanism ensures recommended content is highly relevant to user needs
- 📱 Platform Adaptation: All plans are adapted to the Xiaohongshu 3:4 vertical cover specification (1080x1440 pixels)
⚠️ Trigger Rules
The task process is executed only in the following situations:
- The user provides a specific content topic or niche (such as "help me design a beauty tutorial cover" or "how to design a workplace outfit cover")
- The user explicitly requests the generation of a cover plan
- The user uploads copy or images for analysis
In the following situations, only introduce the skill and do not execute the task:
- The user asks "what can this skill do" or "how to use it"
- The user is only learning about the feature and has not raised a specific need
- The user has not provided a clear creative topic or direction
⚠️ Terminology Standards (Mandatory)
This skill uniformly uses the term "viral cover". The following words are prohibited:
| ❌ Prohibited | ✅ Correct Expression |
|---|---|
| Explosive Cover | Viral Cover |
| Explosive Data | Viral Data |
| Scrape Data | Get/Query Data |
| Scrape Cover | Get Cover |
⚠️ Mandatory Requirement: During execution, all externally output text must use "Viral Cover"-related expressions, including but not limited to:
- Titles, paragraphs, step descriptions
- Conversation replies
- Generated analysis reports
- Generated prompts
One-Click Install
Prerequisites
- Python 3.8+ runtime environment
- Red Fox Data API Key obtained
Get API Key
- Visit Red Fox Hub official website to learn about service details
- Go to registration page to register an account
- Newly registered users will receive free credits, and can immediately start using the API service
- After registering and logging in, get the API Key in the personal center, in the format
ak_xxxxxxxx
Configure API Key
REDFOX_API_KEY obtained from environment variables, format ak_xxxxxxxx
If not set, prompt the user to configure it themselves; if the user does not know how to configure it, the Agent should proactively help the user set it up:
| Operating System | Configuration Command |
|---|---|
| macOS/Linux(zsh) | Append export REDFOX_API_KEY=<值> to ~/.zshrc, then source ~/.zshrc |
| macOS/Linux(bash) | Append export REDFOX_API_KEY=<值> to ~/.bashrc, then source ~/.bashrc |
| Windows | Execute [Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<值>", "User")(requires restarting the terminal to take effect) |
After configuration is complete, verify:echo $REDFOX_API_KEY(macOS/Linux) or echo %REDFOX_API_KEY%(Windows), to ensure it can be read even when switching to another skill
Dependency Installation
pip install requests>=2.28.0
Usage Guide
Basic Usage
1. Describe your cover requirements
Tell the assistant the cover theme you want to design:
User: Help me design an outfit-themed cover
Assistant: Sure! I will analyze the viral cover data in the outfit niche for you and generate an exclusive cover design plan.
2. Wait for the analysis to complete
The assistant will automatically execute a 7-step workflow (intent parsing → data query → intelligent filtering → image analysis → style summary → plan generation → self-check), taking about 1-2 minutes in total.
3. Choose your preferred plan
View three cover plans in different styles, get image generation prompts, and use them directly for cover production.
Advanced Usage
Custom Time Range
User: Help me analyze the outfit viral covers from the past 7 days
Specify a Sub-Niche
User: Design a cover for petite commuting outfits, with a Korean style leaning
Upload Images for Combined Analysis
User: [Upload image] Combine my photo with the viral plan to generate an exclusive cover
Complete Workflow
The core workflow includes 7 standard steps, for detailed execution specifications please refer to references/core_workflow.md:
| Step | Name | Description |
|---|---|---|
| Step 1 | User Intent Parsing | Structurally parse the requirements, extract theme/type/style/keywords |
| Step 2 | Viral Data Query | Call the script to retrieve four-dimensional viral data |
| Step 3 | Intelligent Matching and Filtering | Comprehensively score and filter the 20 most relevant data entries |
| Step 4 | AI Image Analysis | Identify cover visual elements one by one, categorize and summarize |
| Step 5 | Style Summary | Output a viral cover style summary table (including real images) |
| Step 6 | Plan Generation | Output three differentiated cover design plans |
| Step 7 | Output Self-Check | Check output completeness item by item |
⚠️ Important: When executing the task, the Agent must strictly follow the process defined in core_workflow.md and execute step by step, without skipping any steps.
Use Cases
Scenario 1: Blogger Cover Design
Role: Xiaohongshu fashion blogger
Needs: Design high-click-through-rate covers for weekly outfit collection posts
How to Use:
- Describe the outfit niche and style preferences
- Get viral cover style analysis for the same niche
- Choose a suitable plan and use image generation prompts to create the cover
Expected Benefits: Eliminate the cumbersome design process and significantly increase cover click-through rate
Scenario 2: Brand Content Marketing
Role: Brand content operator
Needs: Design covers that match the platform's tone for brand recommendation posts
How to Use:
- Input brand product keywords and target audience
- Analyze the visual patterns of competitors' viral covers
- Generate customized cover plans based on the brand's tone
Expected Benefits: Brand content better fits the platform's aesthetics and improves recommendation conversion rate
Scenario 3: MCN Influencer Matrix Operations
Role: MCN operations manager
Needs: Produce differentiated cover plans in batches for multiple influencers under management
How to Use:
- Query viral data separately by influencer niche
- Match different style cover plans for each influencer
- Keep plans differentiated to avoid homogenization
Expected Benefits: Efficiently produce covers in batches, with differentiated content across matrix accounts
Scenario 4: Cold-Start Account Breaking Zero
Role: New Xiaohongshu blogger
Needs: The account has just started, and they do not know how to design attractive covers
How to Use:
- Describe your own content direction and target audience
- Refer to successful cover cases from low-follower, high-like bloggers
- Use image generation prompts to quickly create professional covers
Expected Benefits: Lower the design barrier so new accounts can also produce professional covers
Project Architecture
Directory Structure
xiaohongshu-cover/
├── SKILL.md # 技能主文档(入口)
├── references/
│ ├── core_workflow.md # 核心工作流程(7步执行规范)
│ └── xhs_trend_data_format.md # 数据格式说明
├── scripts/
│ └── fetch_explosive_covers.py # 爆款数据查询脚本
Tech Stack
| Component | Technical Description |
|---|---|
| Runtime Environment | Python 3.8+ |
| Data Source | Redfox Data API (redfox.hk) |
| HTTP Request | requests >= 2.28.0 |
| Image Analysis | Agent-native image understanding capability |
| Data Format | JSON input/output |
Core Module Description
| Module | Responsibility |
|---|---|
SKILL.md |
Skill entry point, defining the introduction, features, installation, and usage, referencing the workflow |
references/core_workflow.md |
Defines the 7-step standard execution process, including scoring formula, output template, and self-check list |
references/xhs_trend_data_format.md |
Defines the API return data format specification, including field descriptions and examples |
scripts/fetch_explosive_covers.py |
Calls the Redfox Data interface to obtain four-dimensional viral content data, supporting multi-keyword queries |
FAQ
Installation-related Questions
Q1: What should I do if it says "REDFOX_API_KEY environment variable not found"?
A: Please configure it by following these steps:
- Visit Redfox Hub to register an account and obtain an API Key
- Windows users: run
[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "你的API Key", "User")in PowerShell, then restart the terminal - macOS/Linux users: append
export REDFOX_API_KEY=你的API Keyto the shell configuration file, then runsourceto make it take effect - Verify the configuration: run
echo %REDFOX_API_KEY%(Windows) orecho $REDFOX_API_KEY(macOS/Linux)
Q2: Which platforms are supported for deployment?
A: This skill is in Agent Skill format and supports all AI Agent platforms compatible with the SKILL.md specification.
Usage-related Questions
Q3: What is the time range of the queried data?
A: The database only contains data from yesterday to 30 days ago, and the default query is for the past 30 days. If you need a custom time range, you can specify "the past N days" in the request.
Q4: Can multiple keywords be queried at the same time?
A: Yes. Up to 5 keywords, separated by commas (e.g.,职场穿搭,通勤穿搭,面试穿搭), with a total length not exceeding 200 characters.
Q5: Can the generated cover plans be used directly?
A: Each plan includes an image generation prompt, which can be used directly in AI drawing tools to generate cover images. The prompt already includes the 3:4 vertical ratio (1080x1440 pixels) requirement.
Troubleshooting
Q6: What should I do if the API call fails?
A: Please troubleshoot by following these steps:
- Confirm whether the API Key is configured correctly (refer to Q1)
- Confirm that the network connection is normal
- The script has 3 built-in automatic retries; if it still fails, please try again later
- Confirm whether the API Key still has balance
Q7: What should I do if the returned data is empty?
A: Possible reasons:
- The keyword is too niche or emerging, with little viral content accumulated
- The niche has had low popularity recently
- It is recommended to switch to more popular keywords, such as "early morning outfit" or "fat-loss meals"
Q8: What should I do if the note link or author link cannot be opened?
A: Possible reasons and solutions:
- Missing author link userId: If the author link is displayed as
https://www.xiaohongshu.com/user/profile/(with no ID at the end), it means the userId field was omitted during data extraction, which is an execution process issue; please rerun the analysis - Xiaohongshu risk control interception: Xiaohongshu has risk control policies for third-party redirect links; even if the link format is correct, it may not be possible to redirect directly. It is recommended to copy the work title and search for it within the Xiaohongshu App to view it.