SuperAPI AI Directory

xiaohongshu-cover

General & other

View repository

Updated 10-16 06:16

About this skill

Xiaohongshu Viral Cover Generation

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

  1. Visit Red Fox Hub official website to learn about service details
  2. Go to registration page to register an account
  3. Newly registered users will receive free credits, and can immediately start using the API service
  4. 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:

  1. Describe the outfit niche and style preferences
  2. Get viral cover style analysis for the same niche
  3. 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:

  1. Input brand product keywords and target audience
  2. Analyze the visual patterns of competitors' viral covers
  3. 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:

  1. Query viral data separately by influencer niche
  2. Match different style cover plans for each influencer
  3. 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:

  1. Describe your own content direction and target audience
  2. Refer to successful cover cases from low-follower, high-like bloggers
  3. 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:

  1. Visit Redfox Hub to register an account and obtain an API Key
  2. Windows users: run [Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "你的API Key", "User")in PowerShell, then restart the terminal
  3. macOS/Linux users: append export REDFOX_API_KEY=你的API Key to the shell configuration file, then run source to make it take effect
  4. Verify the configuration: run echo %REDFOX_API_KEY%(Windows) or echo $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:

  1. Confirm whether the API Key is configured correctly (refer to Q1)
  2. Confirm that the network connection is normal
  3. The script has 3 built-in automatic retries; if it still fails, please try again later
  4. 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:

  1. 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
  2. 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.