wechat-top-account

Popular WeChat Official Account Recommendations

Overview

Popular WeChat Official Account Recommendations is a WeChat Official Account comprehensive strength ranking query tool that helps users quickly obtain reading and engagement data for top accounts in the same track, supporting operational benchmarking and competitor tracking.

Through dialogue or the command line, you can:

📊 Query the TOP50 rankings of 23 vertical categories, supporting switching between daily, weekly, and monthly rankings
📈 View comprehensive scores (out of 100) and metrics such as post count, reading distribution, likes, Wow, and shares
🔍 Obtain three types of data interpretations: content ecosystem, hot topic impact, and blue ocean tracks
📄 Export HTML visual reports (supporting images/PDF)
🔔 Subscribe to daily/weekly/monthly rankings, automatically pushed according to update time

Suitable for WeChat Official Account operators, MCN agencies, brand marketers, and content teams that need to track the competitive landscape of WeChat Official Accounts.

Features

🎯 Core Features

📊 Multi-dimensional ranking query: Query TOP50 of 23 categories by daily, weekly, and monthly rankings; entering keywords automatically matches the category
📈 Comprehensive scoring system: Calculate a comprehensive score based on metrics such as reads, likes, Wow, and shares, out of 100
🔍 In-depth analysis: Provide three interpretation perspectives: content ecosystem changes, quantification of hot topic impact, and blue ocean track discovery
📄 HTML report: Generate a visual ranking page, supporting export to images and PDF
🔔 Scheduled subscription: Support subscribing to daily, weekly, and monthly rankings, automatically pushed according to update time

✨ Highlights

⚡ Scheduled updates: Daily rankings refresh automatically at 17:30 every day, weekly rankings at 17:30 every Monday, and monthly rankings at 23:00 on the 3rd of each month
📅 Limited lookback: Daily rankings cover the past 7 days, weekly rankings the past 3 weeks, and monthly rankings the past 3 months; out-of-range requests are automatically adjusted with a prompt
🔗 Data consistency: The ranking table and HTML report share the same API, with fully consistent order and content
🔒 API access: Called via the Honghu Hub API Key

Authentication

Get API Key

Visit the Honghu Hub official website to learn about service details
Go to the 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, obtain the API Key in the personal center, in the format ak_xxxxxxxx

Configure API Key

REDFOX_API_KEY Obtained from environment variables, in the format ak_xxxxxxxx. The script uses a three-level authentication fallback:

Priority	Source	Description
1	Environment variable `REDFOX_API_KEY`	Directly read the environment variable of the current session
2	Shell configuration file	Automatically read `~/.zshrc` / `~/.bashrc` / `~/.bash_profile` / Configuration in PowerShell Profile
3	User input	If none of the above is detected, prompt the user to configure manually

macOS / Linux：

echo 'export REDFOX_API_KEY=<你的apikey>' >> ~/.zshrc
source ~/.zshrc

Windows（PowerShell）：

[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<你的apikey>", "User")

Or write the following content into the PowerShell Profile:

$env:REDFOX_API_KEY = "<你的apikey>"

After configuration, restart the terminal. Verify:echo $REDFOX_API_KEY(macOS/Linux) or $env:REDFOX_API_KEY（Windows PowerShell）。

One-click installation

Prerequisites

Python 3.8 or later
requests Library:pip install requests
RedFox Hub API Key, format ak_xxxxxxxx

Installation method

SkillHub

Go to SkillHub
Search wechat-top-account or Recommended popular WeChat official account accounts
Installation instructions

Can be installed via "Install through conversation"
If the SkillHub store is not installed, install the store first, then install the skill
Supports downloading the Zip package locally and installing via local import

ClawHub

Go to ClawHub
Search wechat-top-account or Recommended popular WeChat official account accounts
Installation instructions

Supports installation using CLI commands:openclaw skills install wechat-top-account or clawhub install wechat-top-account
Supports downloading the skill package locally and importing it for installation
After successful installation, it can be used directly in the corresponding client

After installation is complete, please first complete Authentication Configure the API Key, restart the terminal, and you can initiate queries in the conversation.

Method 2: Standalone command-line use

No need to install the skill package; after configuring the API Key, you can directly run scripts/ the script under:

pip install requests
python scripts/gzh_growth_fetcher.py --list_categories

Environment variable configuration

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

For detailed acquisition and configuration steps, see the above Authentication section.

Usage guide

Basic usage

1. Initiate a ranking query

Enter the query request in the conversation, and the system automatically identifies the ranking type and category:

User: Query the daily ranking of technology WeChat official accounts

Assistant: Output the TOP50 table of the technology and digital category daily ranking (including comprehensive score, reading and interaction metrics), and attach a feature inquiry message.

2. View ranking results

Ranking data is output directly without confirmation. Each result includes ranking, account name (clickable), comprehensive score, number of posts/articles, total reads, headline reads, highest reads, total likes, total Wow, total shares.

User: This week's food category WeChat official account rankings

Assistant: Output the TOP50 of the food and dining weekly ranking, marking the data time period and update time.

3. Choose extended features

After the ranking is output, you can choose follow-up services as needed:

User: 1

Assistant: Based on the TOP50 data, output three types of analysis: content ecosystem changes, hot topic impact, and blue ocean tracks.

Reply 1 to get analysis,2 to generate an HTML report,3 or "Subscribe to daily/weekly/monthly rankings" to enable scheduled push notifications.

Advanced usage

1. Specify category and date

Use --category or --keyword to precisely match the category,--rank_date to specify the query date (automatically adjusted if out of range):

# 首次查询时必须同时保存到临时文件（唯一一次API调用）
python scripts/gzh_growth_fetcher.py --rank_type week --category "美食餐饮" --top_n 50 > /tmp/gzh_result.json 2>/dev/null
python scripts/gzh_growth_fetcher.py --rank_type month --keyword "财经" --rank_date 2026-04-01 --top_n 50 > /tmp/gzh_result.json 2>/dev/null

2. Generate an HTML visualization report

After the user selects the HTML feature, use the saved data to generate a page that can be exported as an image/PDF (without calling the API):

python scripts/gen_gzh_html.py --input_json_file /tmp/gzh_result.json --top 50

3. Get in-depth analysis and interpretation

After the user confirms, output a three-part analysis based on the current full TOP50 data: content ecosystem changes, quantification of hot topic influence, and blue ocean track discovery.

4. Subscribe to scheduled push notifications

If the user replies "Subscribe to Daily Ranking," "Subscribe to Weekly Ranking," "Subscribe to Monthly Ranking," or "Subscribe to All," the system will push the latest rankings according to the corresponding update time.

For complete parameters, output templates, and date validation logic, see Core Workflow。

Common Commands Quick Reference

Command	Function
`python scripts/gzh_growth_fetcher.py --rank_type day --keyword "科技" --top_n 50 > /tmp/gzh_result.json 2>/dev/null`	Technology Daily Ranking TOP50 (first query, also save the file)
`python scripts/gzh_growth_fetcher.py --rank_type week --category "美食餐饮" --top_n 50 > /tmp/gzh_result.json 2>/dev/null`	Food and Dining Weekly Ranking TOP50 (first query, also save the file)
`python scripts/gzh_growth_fetcher.py --rank_type month --keyword "财经" --top_n 50 > /tmp/gzh_result.json 2>/dev/null`	Finance Monthly Ranking TOP50 (first query, also save the file)
`python scripts/gzh_growth_fetcher.py --list_categories`	List all available categories
`python scripts/gen_gzh_html.py --input_json_file /tmp/gzh_result.json --top 50`	Generate HTML using prefetched data (without calling the API)
`python scripts/gzh_growth_fetcher.py --input_json_file /tmp/gzh_result.json`	Re-analyze using prefetched data (without calling the API)

Use Cases

Scenario 1: Daily Operations Reference

Role: WeChat Official Account operator

Need: Understand the content output and engagement performance of leading accounts in the relevant track

How to Use：

Query the daily or weekly ranking for the relevant category
Compare publishing frequency, per-article reads, and engagement rate
Select the analysis feature to extract content strategy references

Expected Benefits: Clearly identify benchmark accounts and optimize topic selection and publishing rhythm

Scenario 2: Competitor Tracking

Role: Brand Marketing Manager

Need: Track competitor WeChat Official Account rankings and engagement changes

How to Use：

Query the category ranking where competitors are located on a weekly basis
Pay attention to ranking fluctuations and changes in reads/shares
Subscribe to the weekly ranking to receive updates on a schedule

Expected Benefits: Stay informed of competitors' content focus in a timely manner and adjust your own strategy

Scenario 3: Track Assessment

Role: Content Entrepreneur

Need: Evaluate the competitiveness and readership demand of candidate tracks

How to Use：

Query monthly ranking data for multiple candidate categories
Select the blue ocean track analysis feature
Compare the number of ranked accounts and average reads/score

Expected Benefits: Choose a direction with low competition and strong demand to enter

Scenario 4: Regular Data Reporting

Role: MCN Agency Operations Staff

Need: Provide visualized data for internal reviews or client reports

How to Use：

Subscribe to the daily and weekly rankings to keep data updated
Export HTML reports monthly (image/PDF)
Combine with the analysis feature to write review conclusions

Expected Benefits: Improve reporting efficiency, with unified and traceable data standards

Project Architecture

Directory Structure

wechat-top-account/
├── SKILL.md                      # 产品说明文档
├── references/
│   └── core_workflow.md          # 核心工作流程（模板、逻辑、步骤）
├── scripts/
│   ├── gzh_growth_fetcher.py     # 榜单数据抓取
│   └── gen_gzh_html.py           # HTML 可视化报告生成
└── assets/                       # 静态资源

Tech Stack

Project	Description
Runtime Environment	Python 3.8+
Core Dependencies	`requests`
Data Sources	RedFox Hub API
Deployment Methods	SkillHub / ClawHub / Command-Line Scripts

Core Modules

Module	Responsibility
`gzh_growth_fetcher.py`	Retrieve ranking data via the RedFox Hub API, supporting keyword matching for categories, date validation, and three-level authentication fallback
`gen_gzh_html.py`	Render ranking data into HTML pages that can be exported as images and PDFs
`core_workflow.md`	Output format templates, Checklist, date calculation logic, complete operation steps

Data Update Rules

Ranking	Update Time	Data Range
Daily Ranking	Daily at 17:30	Yesterday's data, last 7 days
Weekly Ranking	Every Monday at 17:30	Last week's data, last 3 weeks
Monthly Ranking	The 3rd of each month at 23:00	Last month's data, last 3 months

FAQ

Installation-Related Questions

Q1: What should I do if the API Key is not detected?

Follow the steps in the Authentication section to register for RedFox Hub and configure the REDFOX_API_KEY environment variable. Newly registered users receive free credits.

Q2: How do I verify that the configuration has taken effect?

Run echo $REDFOX_API_KEY, and confirm that the output format is ak_xxxxxxxx. If it has not taken effect, check whether the terminal has been restarted.

Q3: Which deployment methods are supported?

It supports installation via the SkillHub and ClawHub platforms, and you can also directly run the Python scripts under scripts/ for standalone invocation.

Usage-Related Questions

Q4: Which categories are supported?

23 categories in total: Overall Ranking, LOHAS Living, Humanities & Information, Corporate Brands, Sports & Entertainment, Health & Wellness, Venture & Business, Academic Research, Emotions & Psychology, Real Estate & Housing, Humor, Education & Exams, Digest Selections, Travel & Outings, Fashion Trends, Livelihood Information, Automotive & Transportation, Knowledge Encyclopedia, Technology & Digital, Beauty & Body Care, Food & Dining, Career Development, Wealth & Finance.

Q5: How far back can data be traced?

Daily rankings cover the last 7 days, weekly rankings the last 3 weeks, and monthly rankings the last 3 months. When out of range, the system automatically adjusts to the most recent available data.

Q6: Are the ranking and HTML report data consistent?

Both use the same API interface, so the data is completely consistent.

Q7: How often is the data updated?

Daily rankings update daily at 17:30, weekly rankings every Monday at 17:30, and monthly rankings on the 3rd of each month at 23:00.

Troubleshooting

Q8: The query returns empty data?

Confirm that the category name is accurate (you can use --list_categories to list all categories), and check that the query date is within the valid range.

Q9: HTML generation failed?

Confirm that the requests library is installed and the API Key is valid, and check the script error output to identify the cause.

Security and Licensing

Q10: How should the API Key be kept?

REDFOX_API_KEY It is read only through environment variables; do not write it into code repositories or share it publicly. A leaked Key may lead to credits being consumed.

Q11: Data sources and scope of use?

The ranking data is provided by the Honghu Hub platform and is intended only for lawful commercial purposes such as operational analysis and competitor tracking. Please comply with the platform's terms of service.

Core Workflow

For output format templates, data validation rules, date calculation logic, operation steps, and usage examples, see references/core_workflow.md。

When executing tasks, you must strictly follow the following in core_workflow.md:

Format priority declaration and phased output rules
Pre-output mandatory checklist
Standard ranking template and on-demand output template
Ranking type determination and category matching rules
Date validation logic for daily / weekly / monthly rankings
Data retrieval and formatted output process
API call limit (only 1 API call is allowed in the same query round)

Notes

The popular account recommendation ranking is output directly without confirmation; analysis, HTML, and subscription must be generated only after the user selects them
The ranking table and HTML report must use the same data source, and it is prohibited to modify the order returned by the interface
In the entire process of the same query round (ranking + analysis + HTML), only 1 API interface call is allowed, when retrieving data for the first time, it must be saved to a temporary file at the same time, and all subsequent operations must use --input_json_file for reading; repeated API calls are prohibited
When no explicit query instruction is received, it is prohibited to automatically call scripts or output ranking content
Collapsed output is prohibited
The script output's formatted_markdown field already contains the complete standard template format, so it can be output directly as is; assembling or modifying the format on your own is prohibited

About this skill

Overview

Features

🎯 Core Features

✨ Highlights

Authentication

Get API Key

Configure API Key

One-click installation

Prerequisites

Installation method

SkillHub

ClawHub

Method 2: Standalone command-line use

Environment variable configuration

Usage guide

Basic usage

1. Initiate a ranking query

2. View ranking results

3. Choose extended features

Advanced usage

1. Specify category and date

2. Generate an HTML visualization report

3. Get in-depth analysis and interpretation

4. Subscribe to scheduled push notifications

Common Commands Quick Reference

Use Cases

Scenario 1: Daily Operations Reference

Scenario 2: Competitor Tracking

Scenario 3: Track Assessment

Scenario 4: Regular Data Reporting

Project Architecture

Directory Structure

Tech Stack

Core Modules

Data Update Rules

FAQ

Installation-Related Questions

Usage-Related Questions

Troubleshooting

Security and Licensing

Core Workflow

Notes