bilibili-to-doc

Bilibili Video to Document (B站视频提取文档)

Overview

Extract Bilibili video content into a structured Markdown document by: (1) downloading AI-generated subtitles via yt-dlp with browser cookies, (2) parsing the SRT subtitle file, (3) reorganizing the transcript into a logical, well-structured document with sections, tables, and code blocks.

When to Use

Trigger this skill when the user:

• Provides a bilibili.com video URL and asks to extract/converter it to a document
• "提取B站视频内容" / "B站视频转文档" / "将视频转成文章"
• "把这个B站视频整理成笔记"
• "generate document from Bilibili video"

Prerequisites

• yt-dlp must be installed: pip3 install yt-dlp
• Browser cookies are needed for Bilibili access (Chrome or other browser)
• Python 3.10+ for subtitle processing

Workflow

Step 1: Download Subtitles

Use yt-dlp with browser cookies to download the AI Chinese subtitles:

yt-dlp --cookies-from-browser chrome "<BILIBILI_URL>" \
  --write-subs --sub-lang ai-zh \
  --skip-download \
  -o "/tmp/bilibili_output"

Also get the video title:

yt-dlp --cookies-from-browser chrome "<BILIBILI_URL>" \
  --print "%(title)s" --skip-download 2>&1 | tail -1

If chrome browser cookies are not available, try safari, firefox, or edge.

Step 2: Parse SRT and Generate Document

Read the downloaded .ai-zh.srt file, then:

1. Strip SRT formatting: Remove sequence numbers, timestamps, empty lines
2. Merge consecutive lines: Combine fragmented subtitle lines into complete sentences
3. Identify logical sections: The AI should read through the full transcript and identify:
   • Topic/theme divisions
   • Step-by-step procedures
   • Key concepts and definitions
   • Configuration examples / code blocks
4. Structure the document with proper heading hierarchy

Step 3: Document Structure

Generate a Markdown document following this structure (from reference template):

# {Video Title}

> 来源：B站视频 {BV号} | 主讲：{author}

---

## 一、{Topic Overview}

{Summary of what the video covers}

## 二、{Main Content Sections}

{Organized by logical topic divisions}

## N、总结

{Key takeaways}