--- name: bilibili-all-in-one description: > A comprehensive Bilibili toolkit that integrates hot trending monitoring, video downloading, video watching/playback, subtitle downloading, and video publishing capabilities into a single unified skill. Supports Bilibili session cookie authentication for publishing and high-quality downloads. Requests go to official Bilibili API endpoints over HTTPS. version: 1.0.18 type: code implementation: python interface: cli-and-api runtime: python>=3.8 languages: - zh-CN - en tags: - bilibili - video-download - hot-trending - subtitle - danmaku - video-publish - video-player

- batch-download - multi-format author: wscats license: MIT homepage: https://github.com/wscats/bilibili-all-in-one repository: https://github.com/wscats/bilibili-all-in-one entry_point: main.py required_env_vars: [] optional_env_vars: - BILIBILI_SESSDATA - BILIBILI_BILI_JCT - BILIBILI_BUVID3 - BILIBILI_PERSIST install: pip install -r requirements.txt ---

Bilibili All-in-One Skill

A comprehensive Bilibili toolkit that integrates hot trending monitoring, video downloading, video watching/playback, subtitle downloading, and video publishing capabilities into a single unified skill.

> ⚠️ Optional Environment Variables: BILIBILI_SESSDATA, BILIBILI_BILI_JCT (optional), BILIBILI_BUVID3 (optional), BILIBILI_PERSIST (optional) > These are sensitive Bilibili session cookies needed only for publishing and high-quality (1080p+/4K) downloads. > Most features work WITHOUT any credentials: hot monitoring, standard-quality downloads, subtitle listing, danmaku, stats viewing. > > 📦 Install: pip install -r requirements.txt (all standard PyPI packages: httpx, aiohttp, beautifulsoup4, lxml, requests) > > 🔗 Source: github.com/wscats/bilibili-all-in-one

---

何时激活

当用户明确请求以下 Bilibili 相关操作时，本 Skill 可被激活：

| 触发场景 | 匹配的模块 | 典型触发词 | |---|---|---| | 查看B站热门、热搜、排行榜、必看榜 | 🔥 Hot Monitor | "热门"、"热搜"、"排行"、"趋势"、"必看"、"流行"、"榜单" | | 下载B站视频、提取音频、批量下载 | ⬇️ Downloader | "下载"、"保存视频"、"提取音频"、"导出MP4"、"批量下载" | | 查看视频播放量、点赞数、数据追踪、对比 | 👀 Watcher | "播放量"、"点赞"、"数据"、"统计"、"对比"、"监控"、"追踪"、"观看量" | | 下载字幕、转换字幕格式、合并字幕 | 📝 Subtitle | "字幕"、"CC"、"SRT"、"ASS"、"字幕下载"、"字幕转换"、"翻译" | | 播放视频、获取弹幕、播放列表 | ▶️ Player | "播放"、"弹幕"、"播放地址"、"分P"、"播放列表"、"danmaku" | | 上传视频、发布、定时发布、草稿、编辑 | 📤 Publisher | "上传"、"发布"、"投稿"、"定时发布"、"草稿"、"编辑视频" |

> ⚠️ 注意：本 Skill 不会仅因消息中出现 Bilibili 链接或 BV 号就自动激活。只有当用户明确表达了操作意图（如"下载这个视频"、"查看热门"等）时才会被调用。涉及写操作（发布/编辑）时，需要用户显式提供凭证。

---

Features

| Module | Description | |---|---| | 🔥 Hot Monitor | Monitor Bilibili hot/trending videos and topics in real-time | | ⬇️ Downloader | Download Bilibili videos with multiple quality and format options | | 👀 Watcher | Watch and track video engagement metrics (supports Bilibili) | | 📝 Subtitle | Download and process subtitles in multiple formats and languages | | ▶️ Player | Get playback URLs, danmaku (bullet comments), and playlist info | | 📤 Publisher | Upload, schedule, edit, and manage videos on Bilibili |

Installation

Requirements

• Python >= 3.8
• ffmpeg (optional, for merging video/audio streams)

Install Dependencies

pip install -r requirements.txt

Dependencies

• httpx >= 0.24.0
• aiohttp >= 3.8.0
• beautifulsoup4 >= 4.12.0
• lxml >= 4.9.0
• requests >= 2.31.0
• faster-whisper >= 1.0.0 (optional, for speech recognition subtitle fallback)

Configuration

Some features (downloading high-quality videos, publishing, etc.) require Bilibili authentication. You can provide credentials in three ways:

1. Environment Variables

export BILIBILI_SESSDATA="your_sessdata"
export BILIBILI_BILI_JCT="your_bili_jct"
export BILIBILI_BUVID3="your_buvid3"

2. Credential File

Create a JSON file (e.g., credentials.json):

{
  "sessdata": "your_sessdata",
  "bili_jct": "your_bili_jct",
  "buvid3": "your_buvid3"
}

3. Direct Parameters

Pass credentials directly when initializing:

from main import BilibiliAllInOne

app = BilibiliAllInOne(
    sessdata="your_sessdata",
    bili_jct="your_bili_jct",
    buvid3="your_buvid3",
)

4. Persistent Storage (Optional)

By default, credentials are kept in-memory only and are not saved to disk. To enable automatic persistence across sessions:

# Via environment variable
export BILIBILI_PERSIST=1

# Or via code
app = BilibiliAllInOne(persist=True)

When persistence is enabled:

• Credentials are auto-saved to .credentials.json (with 0600 permissions) after initialization
• On next startup, credentials are auto-loaded from this file
• You can toggle persistence at runtime: app.auth.persist = True / app.auth.persist = False
• To delete the persisted file: app.auth.clear_persisted()

> How to get cookies: Log in to bilibili.com, open browser DevTools (F12) → Application → Cookies, and copy the values of SESSDATA, bili_jct, and buvid3.

⚠️ Security & Privacy

Credential Handling

This skill handles sensitive Bilibili session cookies. Please read the following carefully:

| Concern | Detail | |---|---| | What credentials are needed? | SESSDATA, bili_jct, buvid3 — Bilibili full browser session cookies (not limited API keys). Providing them grants broad access to your Bilibili account. | | Which features require authentication? | Publishing (upload/edit/schedule/draft), downloading 1080p+/4K quality videos | | Which features work WITHOUT credentials? | Hot monitoring, standard-quality downloads, subtitle listing, danmaku fetching, stats viewing | | Where are credentials sent? | To official Bilibili API endpoints (api.bilibili.com, member.bilibili.com) over HTTPS only | | Are credentials persisted to disk? | NO by default — credentials stay in memory. Set persist=True or BILIBILI_PERSIST=1 to opt-in to automatic persistence (saved to .credentials.json with 0600 permissions). You can also manually call auth.save_to_file() | | File permissions for saved credentials | 0600 (owner read/write only) — restrictive by default |

Best Practices

1. 🧪 Use a test account — Do NOT provide your primary Bilibili account cookies for evaluation/testing purposes. These are full session cookies that grant broad account access (not limited API keys).
2. 🔒 Prefer in-memory credentials — Pass credentials via environment variables or direct parameters rather than saving to a file. Only enable persist=True if you need credentials to survive across sessions.
3. 📁 If you enable persistence — Credentials are saved with 0600 permissions. Use auth.clear_persisted() or auth.persist = False to remove the file when no longer needed.
4. 🐳 Run in isolation — When possible, run this skill in an isolated container/environment and inspect network traffic.
5. 🌐 Verify network traffic — All HTTP requests go to Bilibili's official domains only. You can verify by monitoring outbound connections.
6. ❌ No exfiltration — This skill does NOT send credentials to any third-party service, analytics endpoint, or telemetry server.
7. 🔑 Credential scope — SESSDATA and bili_jct are full session cookies. They are NOT scoped/limited API keys. Treat them with the same care as your account password.

Network Endpoints Used

| Domain | Purpose | |---|---| | api.bilibili.com | Video info, stats, hot lists, subtitles, danmaku, playback URLs | | member.bilibili.com | Video publishing (upload, edit) | | upos-sz-upcdnbda2.bilivideo.com | Video file upload CDN | | www.bilibili.com | Web page scraping fallback |

Credential Requirement by Module

...