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 via pip install -r requirements.txt)
Playwright browsers: run playwright install chromium after 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_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 <skill_directory>
pip install -r requirements.txt
playwright install chromium

Step 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 --nickname and --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 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:

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.