bili-downloader
A cross-platform Bilibili downloader with 8K video support, batch downloads, AI-powered watermark removal, subtitles, and MCP integration for AI agents.
Install / Use
claude mcp add wangzi6224 -- npx -y github:wangzi6224/bili-downloaderIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
MarketingSupported Platforms
Tags
Our assessment of bili-downloader
bili-downloader scores 84/100 on our quality scale, 453rd of 646 Marketing skills we index.
Its MCP Server is 25 KB long, well organised into 21 sections with 4 code examples: a thorough specification that gives an agent plenty to work with.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated today, so bili-downloader is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-16. Automated pattern scan on 2026-11-15. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
bili-downloader compared with similar skills
All 4 of these similar skills score higher than bili-downloader; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| bili-downloader (this skill)by wangzi6224 | 84 | 10 | today | MCP Server |
| Agent-Reachby Panniantong | 100 | 112.7k | 9d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 82.0k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install bili-downloader?
- Run
claude mcp add wangzi6224 -- npx -y github:wangzi6224/bili-downloader. The install tabs above show the steps for each supported agent. - Which AI agents does bili-downloader work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is bili-downloader safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is bili-downloader still maintained?
- The repository was last updated today, so bili-downloader is actively maintained.
Skill content
View source on GitHubBili Downloader
Your favorite bilibili videos, saved to your own drive. Copy a link, paste it, hit download: videos, collections, anime and courses come down in one go, in up to 8K / Dolby Vision, with subtitles, danmaku and chapters saved alongside. Wipe watermarks with AI while you're at it, or let an AI agent do the legwork. Free and open source for Windows, macOS and Linux.
Website · Download · Get started · Let AI do it (MCP) · FAQ
English | 简体中文 | 日本語 | 한국어 | Français | Italiano | Русский | हिन्दी
<sub>The interface supports English, Simplified Chinese, Japanese, Korean, French, Italian, Russian and Hindi. It follows your system language by default, and you can change it in Settings → General → Language.</sub>
</div>See it first
AI watermark removal, before and after: the original download on the left, AI refine on the right.
https://github.com/user-attachments/assets/835dda86-4575-4311-808b-507c04bbd589
<sub>Source: “陈翔六点半:一念贪虚妄,半生困赌局” by the bilibili creator 陈翔六点半. Original video: https://www.bilibili.com/video/BV1vU446BEiU. All rights belong to the original creator; we encourage you to watch the original on bilibili.<br>This excerpt is used solely to demonstrate the software’s features, for personal study only, and may not be redistributed. If you believe it infringes your rights, please contact us via Issues and it will be removed promptly.</sub>
<p align="center"> <img src="docs/screenshots/queue.png" width="49%" alt="Download queue"> <img src="docs/screenshots/select.png" width="49%" alt="Choosing episodes, quality and extras"> </p>What you get
| | |
| --- | --- |
| Max out the quality <br> 8K, Dolby Vision, HDR: if your account can watch it, you can download it. Pick AVC / HEVC / AV1, get audio up to Dolby Atmos and Hi-Res FLAC, and keep the original streams with no re-encoding by default. | Just drop a link <br> Single videos, multi-part videos, collections, anime, movies, courses, favorites, Watch Later, uploader pages, audio, rankings… whole lists parse in one go, and b23.tv short links and share text work too. |
| AI watermark removal <br> Corner watermarks get spotted automatically, or draw a box yourself; turn on “AI refine” and it repaints what's underneath, frame by frame. | Subtitles, danmaku, the lot <br> CC subtitles as .srt or embedded in the video, danmaku as .ass / .xml, plus chapters, covers and NFO for Kodi / Jellyfin. |
| Queue it and walk away <br> Resumable, multi-threaded downloads with speed limits, auto-retry and naming templates; subscribe to uploaders, favorites or collections and new uploads download themselves. | Let AI do it for you <br> A built-in local MCP server lets Claude and other AI clients search, parse links, queue downloads, remove watermarks and keep an eye on progress. |
[!NOTE] This is an unofficial project and is not affiliated with or endorsed by bilibili. Only download content your own account is allowed to watch, for personal use, and respect the rights of creators and bilibili's terms of service.
Get started in four steps
-
Download the installer for your system from Releases:
| System | File | | --- | --- | | macOS, Apple Silicon (M1 and later) |
bili-downloader-<version>-arm64.dmg| | macOS, Intel |bili-downloader-<version>-x64.dmg| | Windows x64 |bili-downloader-<version>-x64.exe| | Linux x64 |bili-downloader-<version>-x86_64.AppImageorbili-downloader-<version>-amd64.deb| -
Sign in to your bilibili account (see Signing in). The app needs an account to parse links.
-
Paste a link. The app picks it up from the clipboard when you switch back to it, or press <kbd>⌘</kbd><kbd>V</kbd> (<kbd>Ctrl</kbd><kbd>V</kbd> on Windows and Linux) in the input box and click 解析 (Parse).
-
Pick and download. Choose the items (select all, invert, <kbd>Shift</kbd>-click a range, or filter by title or index such as
1-5,7), set the quality, output type and extras, then click 下载 (Download).
You can also type these keywords instead of a link: 稍后再看 or watchlater (Watch Later), 每周必看 (Weekly Must-Watch), 排行榜 (rankings).
Installation
macOS
-
Download the latest
.dmgfrom Releases:arm64for Apple Silicon,x64for Intel. -
Open the dmg and drag B站下载器 into Applications.
-
The app is ad-hoc signed but not notarized, so macOS blocks it the first time. Try to open it once, then go to System Settings → Privacy & Security and click Open Anyway. (Since macOS 15, right-click → Open no longer works.) Alternatively, run:
xattr -dr com.apple.quarantine "/Applications/B站下载器.app"
Requires macOS 12 or later.
Windows
Download bili-downloader-<version>-x64.exe from Releases and run the installer. It installs for the current user and does not require administrator access. The installer is unsigned, so Windows may show an unknown-publisher warning.
Linux
<details> <summary>AppImage or deb (64-bit x86 only)</summary>-
AppImage (any distribution, updates itself):
bili-downloader-<version>-x86_64.AppImage. Make it executable and run it:chmod +x bili-downloader-*-x86_64.AppImage ./bili-downloader-*-x86_64.AppImageAppImages need FUSE 2. If it does not start, install it (
sudo apt install libfuse2t64on Ubuntu 24.04 and later,libfuse2on older releases), or run it with--appimage-extract-and-run. -
deb (Debian, Ubuntu and derivatives):
bili-downloader-<version>-amd64.deb. Install it withsudo apt install ./bili-downloader-<version>-amd64.deb; B站下载器 then appears in your application menu.
When the window is closed to the background, click the tray icon to bring it back. On GNOME this needs the AppIndicator extension (Ubuntu ships it by default). The menu bar is hidden; press <kbd>Alt</kbd> to show it.
</details>Updates
Once installed, the app checks for updates itself. The macOS app, Windows installer and Linux AppImage install updates in place; the deb version shows the release notes and points you to the download page.
AI watermark removal
Uploader watermark stuck in the corner? There are two ways to get rid of it:
| Mode | How it works | Best for |
| --- | --- | --- |
| Fast (default) | Finds the watermark in a corner and fills it in from the surrounding pixels with ffmpeg's delogo | Quick results, static backgrounds |
| AI refine (AI 精修) | Repaints what is under the watermark frame by frame with the LaMa inpainting model | Much cleaner results, moving scenes |
- Turn it on in the download options, or with the 下载后去水印 (Remove watermark after download) switch above the download list, which you can change at any time.
- For a finished download, drag a box over the watermark and remove it by hand.
- AI refine shows an estimated time before it starts and uses the GPU when one is available. The model (~200 MB) is not in the installer; it is downloaded the first time you use AI refine and checked against its SHA-256.
- Removing a watermark re-encodes the video. HDR and Dolby Vision videos are skipped.
Let AI do the downloading (MCP)
Switch on the app's local Model Context Protocol server and AI clients like Claude can search bilibili, queue downloads and track progress for you. Once it's set up, just say what you want:
Search bilibili for “Blender tutorial” videos between 30 and 60 minutes long, pick the five with the most plays, and download them as one batch.
The agent calls search_videos to find candidates, download_batch with the five videos to queue them as one batch, and get_batch_status to follow the progress until it is done.
Download every video in this collection that I don't have yet, then remove the watermarks with AI refine: https://space.bilibili.com/…
Here the agent uses parse_link to expand the collection, download_batch (already-downloaded items are skipped), get_batch_status to see which files carry a watermark and how long removal would take, and remove_watermark to clean them.
Setup
Go to 设置 → AI 助手 (Settings → AI assistants) and click 全部安装 (Install all), or install for one assistant at a time. One click adds the MCP server and a skill to:
Claude Code · Claude Desktop (macOS, Windows) · Codex · Cursor · Gemini CLI · WorkBuddy · CodeBuddy · Trae CN · Qoder · Qwen Code
- Restart the assistant afterwards. From then on, any conversation that asks to download from or search bilibili will use this app.
- No token is stored in the assistants' configs: they start a small bridge that reads the current port and token from the app, and opens the app in the background (tray icon only) if it isn't running.
- When the app is updated or moved, the installed configs and skills are updated on its next launch. Anything you remove inside an assistant stays removed.
Other clients can still connect over HTTP: the buttons under 接入 AI 客户端 (Connect an AI client) on the same page copy the client configuration (JSON) or the Claude Code command, which already include your access token.
{
"mcpServers": {
"bili-downloader": {
"type": "http",
"url": "http://127.0.0.1:39231/mcp",
"headers": { "Authorization": "Bearer <your-token>" }
}
}
}
claude mcp add --transport http bili-downloader http://127.0.0.1:39231/mcp --header "Authorization: Bearer <your-token>"
<details>
<summary>All MCP tools</summary>
| Tool | Description |
| --- | --- |
| list_accounts / switch_account / logout_account | See account UIDs and login status, switch the active account, or sign out a specified UID |
| get_download_quality | Check the video qualities available to each account. Use best_qn and a UID from best_account_mids when submitting a download |
| list_download_history / list_parse_history | Read download and parse history with the initiating account, optionally filtered by UID |
| get_status | Login and premium (大会员) status, queue summary, free space in the download fo
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
112.7kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
82.0k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
