Social Media Metrics
Description
Fetch follower counts and metrics from 11+ social media platforms. Supports input via profile URL or account nickname. Platforms include Instagram, YouTube, TikTok, Douyin, WeChat Video, Kuaishou, iQiyi, Xiaohongshu, Bilibili, Toutiao, and Baijiahao.
When to Use
- When the user asks for follower counts or social media metrics
- When the user mentions "粉丝数", "粉丝量", "followers", "subscriber count"
- When the user provides a social media profile URL and wants to know the metrics
- When the user asks to compare follower counts across platforms
- NOT for posting content or managing social media accounts
Prerequisites
- Python 3.9+
- pip packages:
requests,playwright,beautifulsoup4(install viapip install -r requirements.txt) - Playwright browsers: run
playwright install chromiumafter installing the package - Recommended: Google Chrome installed on the system — Douyin, Kuaishou, and Xiaohongshu use Chrome's CDP (DevTools Protocol) mode for better anti-detection. If Chrome is not installed, Playwright's bundled Chromium will be used as an automatic fallback
- Optional:
YOUTUBE_API_KEYenvironment variable for YouTube Data API (falls back to browser scraping if not set)
Supported Platforms
| Platform | Input: URL | Input: Nickname | Method |
|---|---|---|---|
| Bilibili (哔哩哔哩) | space.bilibili.com/{uid} | Yes | API |
| YouTube | youtube.com/@{handle} | Yes | API / Browser |
| Douyin (抖音) | douyin.com/user/{id} | Yes | Browser |
| Kuaishou (快手) | kuaishou.com/profile/{id} | Yes | Browser |
| Xiaohongshu (小红书) | xiaohongshu.com/user/profile/{id} | Yes | Browser (requires login) |
| TikTok | tiktok.com/@{handle} | Yes | Browser |
instagram.com/{handle} | Yes | Browser | |
| WeChat Video (视频号) | channels.weixin.qq.com/{id} | No | Browser |
| Toutiao (头条号) | toutiao.com/c/user/token/{id} | Yes | Browser |
| Baijiahao (百家号) | baijiahao.baidu.com/u?app_id={id} | No | Browser |
| iQiyi (爱奇艺) | iqiyi.com/u/{id} | No | Browser |
Instructions
Step 1: Ensure dependencies are installed
Check if the required packages are available. If not, install them:
cd <skill_directory>
pip install -r requirements.txt
playwright install chromiumStep 2: Determine input type
From the user's message, determine:
- URL input: If the user provides a URL (e.g.,
https://space.bilibili.com/946974), use--url - Nickname input: If the user provides a name (e.g., "MrBeast"), use
--nicknameand--platform
Step 3: Run the script
Fetch by URL:
python <skill_directory>/scripts/main.py --url "https://space.bilibili.com/946974"Fetch by nickname (platform required):
python <skill_directory>/scripts/main.py --nickname "MrBeast" --platform bilibiliAvailable --platform values: bilibili, youtube, douyin, kuaishou, xiaohongshu, wechat_video, tiktok, instagram, toutiao, baijiahao, iqiyi
Step 4: Parse and present results
The script outputs JSON to stdout. Parse it and present the results in a user-friendly format.
Success response:
{
"platform": "bilibili",
"username": "MrBeast",
"uid": "946974",
"url": "https://space.bilibili.com/946974",
"metrics": {
"followers": 12345678
},
"fetched_at": "2026-03-13T12:00:00+00:00",
"success": true,
"error": null
}Error response:
{
"platform": "bilibili",
"username": null,
"uid": null,
"url": null,
"metrics": {},
"fetched_at": "2026-03-13T12:00:00+00:00",
"success": false,
"error": "Description of the error"
}Platform-Specific Notes
Xiaohongshu (小红书) — Login Required
Xiaohongshu requires an authenticated session to view search results and profile pages. The script uses a real Chrome instance (via CDP) with a persistent profile at ~/.playwright_cdp_profile.
First-time setup:
- Run any Xiaohongshu query (e.g.,
python scripts/main.py --nickname "test" --platform xiaohongshu) - A Chrome window will open showing a QR code login page
- Scan the QR code with the Xiaohongshu app on your phone
- The script will detect the login and proceed automatically (120-second timeout)
Subsequent runs: Cookies are persisted in the Chrome profile — no login needed until the session expires.
Error Handling
- Missing platform for nickname: Ask the user which platform they want to query
- Unsupported URL: Tell the user which platforms are supported
- Scraping failure: Some platforms may block headless browsers or require login. Inform the user and suggest trying a direct URL
- Xiaohongshu login required: The script will prompt the user to scan a QR code in the Chrome window. If the session has expired, re-run the script and scan again
- YouTube API key missing: The script automatically falls back to browser scraping — no action needed
- Timeout: Browser-based platforms may be slow. If timeout occurs, retry once
Examples
User: "帮我查一下MrBeast在B站的粉丝数" → Run: python scripts/main.py --nickname "MrBeast" --platform bilibili
User: "How many followers does MrBeast have on YouTube?" → Run: python scripts/main.py --nickname "MrBeast" --platform youtube
User: "查询 https://space.bilibili.com/946974 的粉丝数据" → Run: python scripts/main.py --url "https://space.bilibili.com/946974"
User: "查一下这个TikTok账号的粉丝 https://www.tiktok.com/@khaby.lame" → Run: python scripts/main.py --url "https://www.tiktok.com/@khaby.lame"
Feedback & Issues
GitHub repository: openclaw-social-metrics
If you encounter any problems or have feature requests, feel free to open an Issue.