Social Media Metrics
by @guoming0000
Fetch follower counts and social media metrics from 11+ platforms using profile URLs or nicknames, including Bilibili, YouTube, TikTok, Instagram, and more.
clawhub install social-media-metrics📖 About This Skill
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
Prerequisites
requests, playwright, beautifulsoup4 (install via pip install -r requirements.txt)playwright install chromium after installing the packageYOUTUBE_API_KEY environment 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 | 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
pip install -r requirements.txt
playwright install chromium
Step 2: Determine input type
From the user's message, determine:
https://space.bilibili.com/946974), use --url--nickname and --platformStep 3: Run the script
Fetch by URL:
python /scripts/main.py --url "https://space.bilibili.com/946974"
Fetch by nickname (platform required):
python /scripts/main.py --nickname "MrBeast" --platform bilibili
Available --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:
1. Run any Xiaohongshu query (e.g., python scripts/main.py --nickname "test" --platform xiaohongshu)
2. A Chrome window will open showing a QR code login page
3. Scan the QR code with the Xiaohongshu app on your phone
4. 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
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.
⚡ When to Use
💡 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"
⚙️ Configuration
requests, playwright, beautifulsoup4 (install via pip install -r requirements.txt)playwright install chromium after installing the packageYOUTUBE_API_KEY environment variable for YouTube Data API (falls back to browser scraping if not set)