viral-chaser

Analyzes Douyin, Bilibili, and Xiaohongshu videos via download, ASR transcription, and keyframe extraction.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

When you find a viral video on Douyin, Bilibili, or Xiaohongshu and want to understand why it works, manually rewatching and note-taking is slow and unstructured. This Skill automates the full breakdown: it downloads the video, transcribes the speech with timestamps, extracts key frames, and produces a structured viral-analysis report covering hooks, structure, and visual style.

Core Features & Use Cases

  • One-command video analysis: Pass a full URL or short link (v.douyin.com, b23.tv, xhslink.com) and get back metadata, a timestamped transcript via Volcano Engine ASR, and up to 8 key frames.
  • Structured viral report: Generates a Markdown report covering opening hook type, content structure table, virality element ratings, visual style analysis, and actionable takeaways.
  • Session resilience: Built-in login probing for Douyin, cookie fallback for Xiaohongshu, and clear exit codes that trigger re-login flows when sessions expire.
  • Use Case: A content creator shares a competitor's Douyin short link and asks for a breakdown; the Skill downloads the video, transcribes the audio, reads the key frames, and saves a full analysis report to the platform's reference folder.

Quick Start

Ask the agent to analyze this viral video and paste a Douyin, Bilibili, or Xiaohongshu video share link.

Frequently Asked Questions about viral-chaser

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

FAQPage Schema
How do I analyze a viral Douyin or Bilibili video from a link?

Run the viral-chaser command with the full URL or short link, such as a v.douyin.com or b23.tv share link. The script resolves the link, downloads the video, transcribes the audio, extracts key frames, and outputs a JSON result used to build a structured analysis report.

What platforms does this video analysis tool support?

It supports Douyin, Bilibili, and Xiaohongshu video notes. WeChat Channels and TikTok are not supported, and Xiaohongshu image-only notes are rejected since they contain no video.

Does Xiaohongshu video analysis require login cookies?

No, Xiaohongshu fetching uses a cookie-free SSR HTML route that parses the note page directly, requiring only a share link with an xsec_token. If a captcha or empty page occurs, it retries once with an optional xhs-browse cookie.

Why does the ASR transcription fail with a permission error?

The Volcano Engine speech model must be activated separately in the console under the speech models tab, even if you already have a Code Plan subscription. Enable the recording-file recognition turbo edition and provide the APP ID and Access Token as environment variables.

What happens when the Douyin session cookie expires?

The script exits with code 2 and a SESSION_EXPIRED error. The calling agent should run the login-manager flow to re-export cookies and the user agent, then retry the analysis once.

Can this skill generate a new video based on the analysis?

No, it only produces the analysis report. To create a video from the findings, you must separately delegate the task to the content-producer skill as a subagent.