wx-channel-engagement

Scrapes WeChat Channels post engagement metrics into a SQLite tracking database.

8.5k|1.4k|Updated Apr 24, 2024
One-click install
npx skills add https://github.com/TeamWiseFlow/wiseflow --skill wx-channel-engagement
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wx-channel-engagement
Source: https://github.com/TeamWiseFlow/wiseflow/tree/main/crews/main/skills/expert-wx-channel/tools/wx-channel-engagement
Command: npx skills add https://github.com/TeamWiseFlow/wiseflow --skill wx-channel-engagement

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires camoufox-cli, and includes scripts (resource) components.

What problem does it solve?

It automates the collection of engagement data (plays, likes, comments, shares, favorites) for videos you have published on WeChat Channels, eliminating manual checking of the Channels Assistant backend and keeping your published-content tracking database up to date.

Core Features & Use Cases

  • Backend Scraping via Browser Automation: Uses camoufox-cli with a persistent wechat-channel session to open the Channels Assistant post management page and parse engagement numbers from the wujie micro-frontend shadow DOM.
  • Single and Batch Fetch Modes: Fetch metrics for one published row by ID, or run fetch-all to refresh every tracked video visible on the first page of the management list.
  • QR Code Login Flow: Self-managed login and login-confirm commands capture a QR code screenshot for WeChat scanning, sharing the session profile with the publishing tool so re-login is rarely needed.
  • Use Case: After publishing a video to WeChat Channels, run a daily fetch-all so the pub_wx_channel table always has current play and like counts for your daily performance review.

Quick Start

Ask the agent to refresh engagement metrics for all tracked WeChat Channels videos using the wx-channel-engagement fetch-all command.

Frequently Asked Questions about wx-channel-engagement

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scrape WeChat Channels video engagement data?

Use the fetch command with a row ID to scrape one video, or fetch-all to refresh every tracked video. The tool opens the Channels Assistant post management page with camoufox-cli, parses the innerText, matches rows by title, and writes plays, likes, comments, shares, and favorites to the database.

How do I log in to the WeChat Channels Assistant backend?

Run the login command to capture a QR code screenshot, scan it with WeChat, then run login-confirm after confirming on your phone. The session profile is shared with the publishing tool, so either tool's login works for both.

Can I scrape engagement data for competitor WeChat Channels accounts?

No. The tool only works for accounts you own and can log into via WeChat QR scan, because data comes from the Channels Assistant backend. Competitor account metrics are not accessible through this approach.

Why does the scraper fail to find elements on the Channels Assistant page?

The backend uses the wujie micro-frontend, so all content lives inside a shadow DOM that standard selectors and document.body.innerText cannot reach. The tool works around this by evaluating JavaScript against wujie-app.shadowRoot to read the inner text.

What does exit code 3 mean when running the engagement fetch?

Exit code 3 means the shared wechat-channel session is busy, typically because the publishing tool is running. This is expected fail-first behavior; wait for the current operation to finish and retry rather than closing the active session.

How often can I refresh WeChat Channels metrics without risking restrictions?

Limit full fetches to at most once per 24 hours per account, with single-video fetches on demand. The tool only reads the first page of recent posts and deliberately avoids pagination to reduce risk-control exposure.