📝 Introduction
A Weibo hot search list query tool that obtains Weibo's current hot search list and displays it by ranking, while summarizing and distilling the creative inspiration and topic directions behind hot search topics.
✨ Features
| Feature Module | Capability Description | Core Value |
|---|---|---|
| Hot Search List | Obtain Weibo's current hot search list | Grasp real-time hotspots across the entire platform in one place |
| Ranking Display | Display from 1 to N by hot search ranking | Intuitively understand the heat gradient |
| Inspiration Analysis | Summarize and conclude hot search content | Distill topic directions and spark creative inspiration |
| One-click Jump | Each hot search comes with a Weibo search link | Click to go directly to the search results page |
🔑 Authentication
Get API Key
Please go to Redfox Hub to get the API KEY
Configure API Key
Option 1: Taking Qoder 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..."
🔄 Workflow
Step 1: Call the hot search script
python3 ~/.agents/skills/weibo-hot-search/scripts/fetch_weibo_hot.py
The script outputs in JSON format:
| Field | Description |
|---|---|
items |
List of hot search entries |
Each hot search:
| Field | Description |
|---|---|
rank |
Ranking (starting from 1) |
title |
Hot search title |
url |
Jump link |
hot_score |
Heat value (raw numeric value) |
hot_score_display |
Heat value (formatted for display) |
tag_text |
Tag text (New/Hot/Boiling/Warm) |
Step 2: Determine the result and display it
Case A: items count > 0 (has data)
A1. Inform the user
🔥 Weibo's current hot search list, N itemshot searches in total:
A2. Render a Markdown table
| # | 热搜标题 | 热度 | 标签 |
| --- | ---------------------------- | ------- | ---- |
| 1 | [热搜标题](https://s.weibo.com/weibo?q=热搜标题) | 305.2w | 热 |
Number formatting rules (heat):
< 10000: raw number≥ 10000:x.xwformat
A3. Creative inspiration analysis summary (⚠️ must be output after the table, cannot be omitted)
Summarize, categorize, and distill topic ideas from the hot search content, and output according to the following structure:
💡 Creative Inspiration Analysis
🔥 Hotspot Track Distribution
Categorize hot searches by theme (such as entertainment/sports/society/technology/policy, etc.), and list representative hot searches under each category.
📈 Content Topic Suggestions
Based on hot search directions, distill 3-5 actionable creative topic suggestions, each including:
- Topic Direction: summarize in 2-6 characters
- Entry Point: explain in one sentence from what angle content can be created
⚠️ Risk Warning
Give avoidance suggestions for trending searches involving sensitive topics (if any).
Example:
💡 Creative inspiration analysis
🔥 Trending track distribution
- 🎬 Entertainment celebrities(7 items): TNT concert, Yang Mi has a strong chance of winning, Xue Zhiqian Beijing concert...
- ⚽ Sports events(5 items): Haaland roasts Mbappe, Mbappe injured, no matter who wins the championship they all come to Mengniu...
- 🌪️ Natural disasters/weather(4 items): Typhoon Bavi changed its route again, Guangxi floods, heavy rainstorms in 5 districts of Beijing...
- 🏛️ Current affairs and policy(3 items): Xi Jinping encourages science and technology workers, disaster prevention and relief responsibilities, Xu Jingwan investigated for tax evasion...
📈 Content topic suggestions
- Typhoon weather science popularization: Combining Bavi's route change and the Guangxi floods, create a typhoon safety guide or extreme weather survival strategy
- Concert roundup: Organize recent popular concerts, create viewing guides or cost-performance analyses
- Sports hot topic review: In-depth analysis of the Mbappe injury incident, combined with football topics for technical interpretation
- Film and television popularity tracking: Baihua Sha popularity exceeds 24,000, so you can make horizontal comparisons with similar dramas or a binge-watching guide
⚠️ Risk warnings
- For trending searches related to policies/leaders, only repost objectively and do not express subjective comments
- Disaster-related trending searches require verifying the information source to avoid spreading unverified casualty data
- For trending searches such as tax evasion and negative social events, pay attention to wording and do not make subjective determinations
A4. Subscription prompt
📩 Subscribe to "Weibo trending searches" daily push notifications? After subscribing, the latest trending search list will be automatically pushed every day at 09:00. Reply "Confirm subscription" to create a scheduled task.
⚠️ A1~A4 are all indispensable and must be completed consecutively in the same round of output.
Case B: items count = 0 (no data)
😔 Sorry, Weibo trending search data cannot be obtained temporarily. Please try again later.
Step 3: Create a scheduled task (execute when the user replies "Confirm subscription" or specifies a push time)
Prefer using the platform's built-in scheduled task capability.
Determine the push time:
- If the user specifies a time (such as "every day 08:00", "every day 18:00"), use the time specified by the user
- If the user only says "Confirm subscription" without specifying a time, use the default every day at 09:00
- Supports 24-hour time formats, such as 06:00, 09:00, 14:30, 18:00, 21:00, etc.
Create a scheduled task:
- Task name:
微博热搜订阅 - Execution frequency: every day [user-specified time or default 09:00]
- Execution content: run the script and push the results to the current conversation in the Step 2 format (including the full A1~A4 process)
After successful creation, inform the user: "You have successfully subscribed to Weibo trending search push notifications. Every day at [actual push time], the trending search list will be automatically queried and you will be notified."