A command-line interface for querying public Weibo data, including trending topics and user profiles, without requiring an API key.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install weibo-cli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install weibo-cli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Weibo CLI?
Weibo CLI is a specialized tool designed to interact with China's largest social media platform. It allows developers and data researchers to programmatically fetch trending hot searches, search for specific content, and analyze user feeds via the public mobile web API. By providing structured JSON output, it bridges the gap between raw social data and automated workflows, making it a valuable asset among Openclaw Skills for social listening and research.
This tool operates without the need for authentication or official API keys, utilizing auto-generated visitor cookies to access public information. Whether you are tracking real-time trends or performing deep-dive user analysis, Weibo CLI provides a streamlined, developer-friendly interface to Weibo's vast data ecosystem.
Weibo CLI Use Cases
- Monitoring real-time trending topics and hot searches (Weibo Hot Searches).
- Researching public sentiment or discourse on specific keywords and topics.
- Scraping public user profiles, followers, and historical feeds for data analysis.
- Automated tracking of post engagement metrics like reposts and comments.
How Weibo CLI Works
- The CLI initializes a connection to Weibo's public mobile web API.
- It automatically generates a visitor cookie session, removing the requirement for a manual login.
- The user executes a command (e.g., search, hot, user) with specific flags for filtering or pagination.
- The tool fetches the requested data and can output it as raw JSON for easy parsing.
- If rate limits are encountered, the tool employs an exponential backoff strategy to retry the request.
Weibo CLI Setup
Install the package globally or run it directly using npm or npx:
# Global installation
npm install -g @marvae24/weibo-cli
# Quick run for hot searches without installation
npx @marvae24/weibo-cli hot --json
To increase rate limits, you can optionally set the WEIBO_COOKIE environment variable with your own login credentials.
Weibo CLI Data Schema & Taxonomy
The skill returns structured data in JSON format, which can be easily mapped to the following schemas:
| Data Type | Key Fields | Description |
|---|---|---|
| Hot Search | description, trending |
The keyword name and its current heat/rank index. |
| User Profile | screen_name, followers_count, uid |
Core metadata for a specific user account. |
| Post Content | text, reposts_count, comments_count |
The post body and engagement statistics. |
| Search Result | type, stats, content |
Categorized results for topics, videos, or articles. |
Weibo CLI Advanced Features
- Support for multiple search types including video, image, article, and realtime trends.
- Structured JSON output mode optimized for piping into jq and other CLI data tools.
- Advanced user feed filtering, allowing for sorting by engagement or hotness.
- Automatic rate-limit handling with built-in retry logic.
- Support for custom environment variables to bypass public visitor limits.
SKILL.md
Loading
Related Openclaw Skills
Recipe: Save Gmail to Google Docs
A specialized automation recipe designed to seamlessly transfer and archive Gmail message content directly into Google Docs for permanent reference.
QGIS Geospatial Automation
A powerful GIS automation skill that leverages the qgis_process CLI to perform repeatable vector and raster data transformations.
Pump Tokenized Agent Payments
A comprehensive SDK for building on-chain payment flows for AI agents linked to pump.fun tokens.
Quality Report Agent
A specialized quality management tool that automates the generation of comprehensive daily, weekly, and monthly quality reports in both Excel and PowerPoint formats.
SenseAudio Voice Picker
An intelligent recommendation engine that maps specific emotional tones and scenarios to the ideal SenseAudio voice IDs.
Frontend Architecture Analyzer
A professional AI diagnostic tool for auditing frontend project architecture, tech stack health, and engineering configurations.
Featured*
