bilibili-subtitle-fetcher-skill_suyuan2022_skill

Overview

This skill searches Bilibili (bilibili.com) for videos, downloads Chinese subtitles, and converts them into Markdown with timestamps. It supports keyword search, single-video processing, and concurrent batch downloads with intelligent file naming. The tool is designed to streamline subtitle extraction for analysis, summarization, or documentation workflows.

How this skill works

The skill queries Bilibili search and video APIs to retrieve video metadata, then fetches subtitle tracks via the player subtitle endpoint. Subtitles are parsed, cleaned, and emitted as UTF-8 Markdown files that include timestamps and text. For batch jobs it runs up to three concurrent downloads with randomized delays and timeout handling to reduce request throttling.

When to use it

• You need to extract readable transcripts from Bilibili videos for research or notes.
• You want to bulk-download subtitles from multiple BV IDs for corpus creation.
• You want Markdown-formatted subtitles ready for summarization or editing.
• You need to pull subtitles before running topic extraction, QA, or timeline analysis.
• You need to automate subtitle retrieval as part of a content pipeline.

Best practices

• Provide valid SESSDATA, bili_jct, and DedeUserID cookies in the config file to authenticate subtitle requests.
• Limit batch runs to under 10 videos at once and respect the built-in 1–3s randomized delay.
• Store outputs in the default subtitles directory or set OUTPUT_DIR to a controlled location.
• Re-check cookie values every ~30 days as SESSDATA can expire and cause failures.
• Validate subtitle quality after download because auto-generated captions may contain errors.

Example use cases

• Search for Python tutorial videos, download subtitles, then summarize content with a summarizer skill.
• Download subtitles for a set of BV IDs into Markdown for annotations and lecture notes.
• Run a batch job to collect transcripts for NLP keyword extraction and topic modeling.
• Fetch a single video’s subtitles to create a time-stamped study guide or script.
• Pipeline subtitles to document conversion tools to produce PDFs or DOCX meeting notes.