← Back to Skills Marketplace
Social Media Metrics
by
Bright Guo
· GitHub ↗
· v1.0.2
· MIT-0
344
Downloads
1
Stars
1
Active Installs
3
Versions
Install in OpenClaw
/install social-media-metrics
Description
Fetch follower counts and social media metrics from 11+ platforms using profile URLs or nicknames, including Bilibili, YouTube, TikTok, Instagram, and more.
Usage Guidance
This skill is coherent with its stated purpose and implements scraping for many platforms. Key things to consider before installing:
- It needs Playwright and will launch a real Chrome process for some sites; follow SKILL.md to install browsers.
- For Xiaohongshu (and some others) you'll be asked to log in by scanning a QR code; the script persists cookies to ~/.playwright_cdp_profile so future runs reuse the session. If you don't want persistent sessions, delete that folder between runs.
- The skill opens a local DevTools/remote-debugging port (19222) to connect Playwright to Chrome — the port is bound to localhost but avoid running this on untrusted or public servers.
- No hidden remote endpoints or secret-exfiltration code were found in the reviewed files, and no unexpected environment variables are required (YOUTUBE_API_KEY is optional and documented).
Recommendations: run the skill on a personal or isolated machine (not a shared CI/hosted environment), inspect the code yourself if you need stronger assurance, and remove ~/.playwright_cdp_profile when finished if you want to clear persisted sessions. If you prefer less browser interaction, supply a YOUTUBE_API_KEY for YouTube or run the tool in an isolated VM/container.
Capability Analysis
Type: OpenClaw Skill
Name: social-metrics
Version: 1.0.2
The skill is a functional social media scraper, but it is classified as suspicious due to high-risk operational requirements and browser configurations. Specifically, SKILL.md instructs the AI agent to execute shell commands (pip install, playwright install), and scripts/utils/browser.py launches a Chrome instance with a remote debugging port (19222) and a persistent user profile directory (~/.playwright_cdp_profile). While these capabilities are plausibly necessary to bypass anti-bot measures and maintain login sessions for platforms like Xiaohongshu, they grant the agent broad system access and create a significant attack surface without explicit sandbox constraints.
Capability Assessment
Purpose & Capability
The name/description (fetch follower counts from many platforms) matches the included code and SKILL.md. Platform modules implement browser scraping and API usage (YouTube API optional). No unrelated credentials or services are requested.
Instruction Scope
Instructions are focused on installing Python deps and Playwright, running the included scripts, and using URL/nickname inputs. They explicitly require running a real Chrome instance for some platforms and instruct the user to authenticate (QR scan) for Xiaohongshu. The instructions do not ask for unrelated system files or external endpoints beyond target platforms, but they do rely on interactive browser use and persistent cookies.
Install Mechanism
No opaque or network-download install is present; dependencies are standard Python packages (requests, playwright, beautifulsoup4) and Playwright's browser install. The repository includes the scraper code, and the SKILL.md documents the pip/playwright install steps. This is proportional to the task.
Credentials
The skill requires no secrets by default. An optional YOUTUBE_API_KEY is supported (documented) to use the YouTube API; otherwise the skill falls back to browser scraping. No unrelated environment variables or credentials are requested.
Persistence & Privilege
The BrowserManager launches a real Chrome process connected over CDP and uses a persistent profile at ~/.playwright_cdp_profile. That directory will store cookies/sessions (intended for Xiaohongshu login). The code also opens a local remote-debugging port (19222) and connects Playwright to it. These behaviors are necessary for reliable scraping on some Chinese platforms but increase persistence/sensitivity: cookies and sessions are written to disk and a local debugging port is exposed (bound to localhost).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install social-media-metrics - After installation, invoke the skill by name or use
/social-media-metrics - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Add recommendation to install Google Chrome for improved anti-detection on Douyin, Kuaishou, and Xiaohongshu.
- Clarify that Playwright's bundled Chromium is used as an automatic fallback if Chrome is not available.
- No changes to features, usage, or supported platforms.
v1.0.1
- Updated documentation to reflect a new ordering of supported platforms in descriptions.
- Clarified platform list in the main description section for improved consistency.
- No code changes; this is a documentation update only.
v1.0.0
Initial release. Support fetching follower counts from 11+ social media platforms (Bilibili, YouTube, Douyin, Kuaishou, Xiaohongshu, TikTok, Instagram, WeChat Video, Toutiao, Baijiahao, iQiyi). Supports URL and nickname input.
Metadata
Frequently Asked Questions
What is Social Media Metrics?
Fetch follower counts and social media metrics from 11+ platforms using profile URLs or nicknames, including Bilibili, YouTube, TikTok, Instagram, and more. It is an AI Agent Skill for Claude Code / OpenClaw, with 344 downloads so far.
How do I install Social Media Metrics?
Run "/install social-media-metrics" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Social Media Metrics free?
Yes, Social Media Metrics is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Social Media Metrics support?
Social Media Metrics is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Social Media Metrics?
It is built and maintained by Bright Guo (@guoming0000); the current version is v1.0.2.
More Skills