SkillAgentSearch skills...

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-downloader

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

84/100

Category

Marketing

Supported Platforms

Claude Code
Claude Desktop

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.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
4/20
Freshness
15/15

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 found

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.

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.

SkillScoreStarsUpdatedFormat
bili-downloader (this skill)by wangzi62248410todayMCP Server
Agent-Reachby Panniantong100112.7k9d agoCLAUDE.md
rufloby ruvnet10082.0ktodayCLAUDE.md
headroomby headroomlabs-ai10079.9ktodayCLAUDE.md
CowAgentby zhayujie10048.0ktodayCLAUDE.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.
<div align="center"> <img src="build/icon.png" width="128" alt="Bili Downloader icon">

Bili 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.

Latest release Downloads Stars License: MIT

Download for macOS Download for Windows Download for 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

  1. 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.AppImage or bili-downloader-<version>-amd64.deb |

  2. Sign in to your bilibili account (see Signing in). The app needs an account to parse links.

  3. 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).

  4. 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

  1. Download the latest .dmg from Releases: arm64 for Apple Silicon, x64 for Intel.

  2. Open the dmg and drag B站下载器 into Applications.

  3. 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.AppImage
    

    AppImages need FUSE 2. If it does not start, install it (sudo apt install libfuse2t64 on Ubuntu 24.04 and later, libfuse2 on older releases), or run it with --appimage-extract-and-run.

  • deb (Debian, Ubuntu and derivatives): bili-downloader-<version>-amd64.deb. Install it with sudo 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

View on GitHub
GitHub Stars10
CategoryMarketing
Updated17h ago
Forks1

Languages

TypeScript

Trust signals

97/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 info