SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillsxiaohongshu-similar-account

xiaohongshu-similar-account

Marketing & growth

View repository

Updated 10-15 23:56

About this skill

Xiaohongshu Similar Account Recommendations

1. Introduction

Xiaohongshu creator benchmark account matching tool -- input a Xiaohongshu account ID or "track + follower count + account tier" to intelligently recommend same-tier benchmarks that can be directly copied (similar follower count) and higher-tier benchmarks for reference (3-5x follower count), helping creators quickly find account launch references and placement targets.

Applicable Users: Xiaohongshu creators, KOL operators, brands, and MCN agencies.

2. Features

Core Features：

  • Same-tier benchmark matching -- match similar accounts by follower level, with gameplay that can be directly copied
  • Higher-tier benchmark recommendations -- recommend higher-tier accounts with 3-5x follower count, providing a direction to catch up to
  • Account data analysis -- display key metrics such as follower count and interactions in the last 30 days
  • HTML report generation -- automatically generate visual benchmark reports

Highlights：

  • Dual-mode input: supports precise queries by account ID, and flexible filtering by track + follower count + tier
  • Intelligent track mapping: supports colloquial input (e.g., "cooking" is automatically mapped to "Delicious Cuisine")
  • 25 standard tracks + 7 standard account tiers, covering all Xiaohongshu categories
  • Intelligent follower count handling: a single value automatically sets maxFans=that value / minFans=0, while ranges are passed according to the actual parameters
  • Subscription service: supports subscribing to daily benchmark account pushes by query criteria

3. One-click Installation

Authentication

Get API Key

Please go to RedFox Hub to get the API KEY

Configure API Key

Option 1: Using OpenClaw as an example, add REDFOX_API_KEY to ~/.openclaw/openclaw.json

{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }

Option 2: Terminal configuration: export REDFOX_API_KEY="ak_xxxx..."

export REDFOX_API_KEY="ak_xxxx..."

Dependency Installation

No third-party dependencies need to be installed; the Python standard library (json, argparse, os, sys, urllib, ssl) is sufficient.

4. Usage Guide

Basic Usage

Input Method A: Query by Xiaohongshu account ID：

Example user input: "My ID is 27493135897"

python scripts/xiaohongshu_account_recommender.py --red_id "27493135897"

Input Method B: Query by track + follower count + account tier：

Example user input: "cooking, 3000 followers, amateur"

python scripts/xiaohongshu_account_recommender.py --track "美味佳肴" --min_fans 0 --max_fans 3000 --level "素人"

Operation flow (execute strictly in order)

Step 1: Receive user input and parse parameters

  • Input Method A: Xiaohongshu account ID, the parameter is redId
  • Input Method B: track + follower count + account tier (optional), parameter mapping:
    • track: track type (automatically mapped, e.g., "cooking" -> "Delicious Cuisine")
    • maxFans / minFans: follower count handling rules are below
    • level: account tier (automatically mapped, e.g., "newbie" -> "amateur")

Follower count handling rules (important)：

  • Single follower count (e.g., "3000 followers"): maxFans=3000, minFans=0(do not pass an empty string)
  • Follower range (e.g., "1000-3000 followers"): maxFans=3000, minFans=1000
  • Fans not specified: pass empty strings for both maxFans and minFans

Step 2: Call the script to query benchmark accounts

API endpoint:POST https://redfox.hk/story/api/xhsUser/querySimilarAccounts

Step 3: Output results according to the standard template

Output order:

  1. Opening statement (only show groups with data)
  2. Same-tier benchmark table (show only if there is data)
  3. High-tier benchmark table (show only if there is data)
  4. Analysis summary (show only if there is data)
  5. Subscription service (must be output, regardless of whether there is data)
  6. Display HTML file (read the html_path output by the script and display it)

Output format when there is data：

✨ 为你匹配到【可直接抄的同阶对标（10个）】和【可追赶的高阶标杆（10个）】的2组对标，可按需参考：
| 数据说明：数据获取时间为xxx，和实时数据存在差别。

👉 【可直接抄的同阶对标（10个）】（可直接复制玩法）
| 账号名 | 粉丝数 | 近30天互动数 | 推荐理由 |
| --- | --- | --- | --- |
| [账号名](账号链接) | 粉丝数 | 总互动数 | 推荐理由 |

👉 【可追赶的高阶标杆（10个）】（模式成熟可参考）
| 账号名 | 粉丝数 | 近30天互动数 | 推荐理由 |
| --- | --- | --- | --- |
| [账号名](账号链接) | 粉丝数 | 总互动数 | 推荐理由 |

📬 **订阅服务**
       1️⃣ 是否订阅"现查询条件"的对标账号推送，每日下午7点更新最新数据。你可选择推送频率和时间~
       2️⃣ 暂不需要

Output format when there is no data：

✨ 暂未匹配到符合条件的对标账号，请尝试调整筛选条件。
| 数据说明：数据获取时间为入库时刻，和实时数据存在差别。

📬 **订阅服务**
       1️⃣ 是否订阅"现查询条件"的对标账号推送，每日下午7点更新最新数据。你可选择推送频率和时间~
       2️⃣ 暂不需要

Step 4: Generate and display the HTML report (must be executed)

After the account recommendation output ends, the script automatically:

  1. Save all data to a temporary JSON file:./{账号名/对标账号}_{时间戳}.json
  2. Read the JSON to generate the HTML file:./{账号名/对标账号}_{时间戳}.html
  3. Output JSON marker:{"status": "success", "html_path": "..."}

AI must read html_path and display the HTML file at the end of the conversation.

Advanced usage

Track mapping examples：

User input Matching result
Beauty, makeup Makeup and beauty
Skincare, beauty Personal care
Outfit, fashion Fashion and outfit
Food, cooking, shop visits Delicious food
Travel, tourism Travel and vacation
Home, renovation, remodeling Home renovation
Fitness, sports, weight loss Physical exercise
Maternal and infant, parenting Parent-child parenting
Pets, cats, dogs Pet world
Digital, mobile phones, technology, internet, AI Digital technology
Education, learning Education and learning
Emotions, romance Astrology and emotions
Workplace, work Career development

Account level mapping examples：

User input Matching result
Celebrity, artist, idol, idol Celebrity
Brand, label Brand
Enterprise, company, merchant, official account Enterprise
Top KOL, top, top influencer, big V, big account, million followers Top KOL
Mid-tier KOL, mid-tier, mid-tier influencer, medium account, 100k followers Mid-tier KOL
Tail KOL, tail, tail influencer, small account, 10k followers Tail KOL
Ordinary person, regular person, novice, beginner, newcomer, personal account Ordinary person

Standard track categories (25)：

All Categories | Transportation & Commuting | Leisure & Hobbies | Film & Entertainment | Digital Tech | Healthcare | General & Miscellaneous | Astrology & Relationships | Fashion & Outfits | Weddings & Celebrations | Photography & Recording | Study & Education | Makeup & Beauty | Home & Renovation | Travel & Vacation | Parenting & Childcare | Personal Care | Delicious Food | Career Development | Pets | Trendy Shoes & Bags | Daily Life | Scientific Exploration | News & Information | Sports & Fitness

Standard Account Tiers (7)：

Celebrity | Brand | Enterprise | Top KOL | Mid-tier KOL | Tail-end KOL | Regular User

Number Formatting: < 10000 displays the original value directly, >= 10000 formatted as "X.Xw"

Recommendation Reason: Conversational description, comprehensively analyzing content direction, update frequency, engagement performance, and viral post cases

5. Use Cases

  1. Newcomers Finding Benchmarks for Account Launch: Input "cooking, 3000 followers, regular user" to get benchmark accounts at the same tier as a reference for account launch, and directly replicate proven playbook models.
  2. Creators Finding Benchmarks for Advancement: Input your Xiaohongshu ID to get higher-tier benchmark recommendations, and find catch-up targets with 3-5 times the follower count.
  3. Brands Screening KOLs for Campaigns: Input niche + follower range + account tier to quickly get a list of qualifying influencers, reducing the cost of campaign decision-making.
  4. MCNs Mining Potential Accounts at Scale: Batch query by different niches and follower tiers to systematically uncover potential signing targets.

6. Project Architecture

Directory Structure

xiaohongshu-similar-account/
├── SKILL.md                                    # 本文件
├── scripts/
│   └── xiaohongshu_account_recommender.py      # 调用API查询对标账号，支持赛道和等级映射，自动生成HTML报告
└── references/
    └── account_template.html                   # HTML报告模板

Tech Stack

Technology Purpose
Python Standard Library (urllib, json, ssl) HTTP Requests and Data Parsing
RedFox API Xiaohongshu Similar Account Data Source
HTML / CSS Visual Benchmark Report Rendering

Core Module Description

  • xiaohongshu_account_recommender.py: Supports calling the RedFox Similar Account API in two ways: by account ID or by niche + follower count + tier, automatically handles niche and tier mapping, and generates an HTML report containing same-tier benchmarks and higher-tier benchmarks.

Resource Index

File Purpose
scripts/xiaohongshu_account_recommender.py Call the API to query benchmark accounts, support niche and account tier mapping, and automatically generate an HTML report
references/account_template.html HTML Report Template

7. FAQ

Installation

Q: What dependencies need to be installed? A: No third-party dependencies need to be installed; the Python Standard Library is sufficient.

Q: How do I configure the API Key? A: Please go to RedFox hub to get the API KEY, and configure it via the environment variable REDFOX_API_KEY .

Usage

Q: How do I pass the follower count? A: Single value (e.g. "3000 followers"): maxFans=that value, minFans=0; range (e.g. "1000-3000 followers"): pass parameters by range.

Q: What if the niche cannot be matched? A: Intelligent semantic fuzzy matching is supported; refer to the niche mapping table above. When it cannot be recognized, a complete niche list will be listed for selection.

Q: What if no benchmark accounts are matched? A: The system will prompt "No benchmark accounts matching the criteria were found for now, please try adjusting the filter conditions", and will still output the subscription service entry.

Troubleshooting

Q: Where does all data come from? A: All data comes from the Red Fox API interface; any online search is strictly prohibited.