bilibili-viral-topic

Bilibili Viral Topic

Use this skill to find B站 videos that significantly outperform the UP主's follower base.

Quick Start

Run the bundled script from this skill directory:

python3 scripts/search_bilibili_viral_topic.py --topic "AI工具,大模型,AI编程" --days 30 --max-followers 100000 --min-play 10000 --limit 50 --format markdown

No API key is required. The script uses public Bilibili JSON endpoints with browser-like headers, conservative rate limits, retries, and a local follower cache.

Optional environment:

export BILIBILI_COOKIE="..."

Only set BILIBILI_COOKIE if public requests are repeatedly rate-limited. Never write cookies into skill files or output artifacts.

Workflow

1. Convert the user's niche into focused Chinese and product-name keywords.
2. Search B站 videos through x/web-interface/search/type with order=pubdate and order=click.
3. Optionally supplement with x/web-interface/ranking/v2 when the user asks for broader platform signals.
4. Deduplicate by bvid.
5. Filter to the requested recent window using pubdate.
6. Enrich each unique mid through x/relation/stat?vmid=<mid> and cache follower counts.
7. Filter:
   • follower_count <= --max-followers
   • view_count >= --min-play
   • view_count / follower_count >= --min-play-follower-ratio
8. Rank by breakout_score, then play_follower_ratio, then view_count.
9. Return JSON for automation or Markdown for topic review.

Output Contract

Each result must preserve source and UP主 evidence:

{
  "platform": "bilibili",
  "content_id": "",
  "url": "",
  "title": "",
  "author_id": "",
  "author_name": "",
  "follower_count": 0,
  "published_at": "",
  "view_count": 0,
  "like_count": 0,
  "comment_count": 0,
  "share_count": 0,
  "save_count": 0,
  "coin_count": 0,
  "danmaku_count": 0,
  "hot_score": 0,
  "breakout_score": 0,
  "evidence": []
}

Read references/scoring.md before changing thresholds or combining B站 results with other platforms. Read references/rate_limits.md before increasing pages, ranking rids, or request speed.

Guardrails

• Do not scrape B站 HTML pages when the JSON endpoints are enough.
• Use browser-like headers. Naked script user agents can trigger -352 or HTTP 412.
• Keep request speed conservative. Default --request-sleep 0.6 is intentional.
• Cache follower counts for at least 24 hours. Re-querying the same mid repeatedly increases risk and adds little value.
• Do not call a video confirmed low-fan if follower count is missing unless the user explicitly allows unknown followers.
• Use videos as topic signals, hook references, title structures, and format references. Do not copy full scripts or captions wholesale.