# Bilibili Live MCP

> Bilibili Live MCP automates monitoring of massive live streaming broadcasts. It lets your agent continuously read real-time data from Bilibili, capturing Super Chat donations, analyzing Danmaku chat streams, and tracking streamer metadata without needing a dedicated dashboard. You get raw access to fan engagement metrics, financial donation ledgers, and room status updates directly through your AI client.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** live-streaming, danmaku, super-chat, vtuber, audience-interaction

## Description

This MCP plugs the enormous world of live streaming into your agent's workflow. Instead of manually monitoring complicated dashboards, your AI can continuously poll high-volume data streams from Bilibili Live. You track everything: every Super Chat donation, which shows a user's financial support; the rapid-fire Danmaku chat text; and detailed room status metrics that gauge actual audience interest versus bot activity. This makes it possible to build automated systems for community moderation or real-time analytics. By connecting through Vinkius, you get access to this data stream alongside thousands of other industry tools, letting your agent handle complex tasks like logging donation waves into a CRM or filtering toxic chat content instantly.

## Tools

### get_danmu_config
Retrieves the necessary WebSockets settings needed to monitor bullet chat streams.

### get_fans_medal_info
Checks and reports a user's specific fan medal level within the current live room.

### get_gift_history
Shows a list of recent virtual items that have been gifted in the broadcast room.

### get_guard_list
Retrieves a list of active 'Guard' or moderator accounts participating in the room.

### get_room_info
Connects to the app and fetches high-level configuration details about the live broadcast room.

### get_room_play_info
Gets the stream playback URLs and verifies the current live status of the broadcast.

### get_streamer_info
Pulls the broadcaster's public account details for use in tracking or reporting.

### get_super_chats
Extracts detailed records of all purchased Super Chat donations that occur during the stream.

### send_danmu
Allows your agent to send a specific message into the broadcast using the developer account credentials.

### update_room_title
Changes the visible title of the streamer's live room in real time.

## Prompt Examples

**Prompt:** 
```
Fetch the raw user engagement metric from Bilibili room '51923' quickly.
```

**Response:** 
```
Targeting identifier '51923'... Stream fetched! The current popularity index bursts at 1,402,050 concurrent interactions suggesting massive virtual tipping activity ongoing. Should I attempt parsing the overarching super-chat list now?
```

**Prompt:** 
```
Summarize the metadata tied directly to backend ID of host 892019.
```

**Response:** 
```
Running profile extraction algorithms... The host tied to '892019' resolves to 'GamerLegendXXX'. They maintain official standing in the 'Esports Casting' realm holding verified status with peak traffic histories around late evening shifts. Do you need explicit cover-art image arrays linked?
```

**Prompt:** 
```
Retrieve the top 10 richest super-chat donations logged actively over the current cycle.
```

**Response:** 
```
Accessing donation arrays filtering outliers aggressively... The pinnacle contribution sits at ~3000 CNY dropped by user ID 'VIP91'. The subsequent 9 donations average around 800 CNY tightly clustered across a 2-minute competitive wave. Rendering complete table now...
```

## Capabilities

### Track Super Chat donations
Extracts every actively purchased Super Chat contribution made in the live stream.

### Analyze Danmaku chat streams
Reads and configures access for massive, real-time bullet-chat message flows.

### Retrieve room metadata
Gets high-level configuration data about the live broadcast room itself.

### Monitor streamer profiles
Retrieves official public account details and profile information for the broadcaster.

### Manage room identity
Allows your agent to change the live stream's title programmatically.

### Check user fan status
Verifies a specific user's current medal level within the broadcast room.

## Use Cases

### Tracking a Major Donation Event
The agency needs to know the exact total value of donations during a key moment. Your agent calls `get_super_chats` and then aggregates those results with data from `get_gift_history`, producing a complete, auditable financial report.

### Responding to Spam Chat
The chat is overwhelmed by spam. The moderator uses the MCP to check the current room status via `get_room_info` first. If everything looks stable, they use `send_danmu` to post an official warning message.

### Updating Broadcast Information
The streamer is starting a new segment. Instead of telling the moderator to manually change the title, the agent calls `update_room_title`, instantly updating the room's public facing name for the audience.

### Analyzing Fan Loyalty
A marketing team needs to know which fan groups are most loyal. They run `get_fans_medal_info` on several users and combine that with donation data from `get_super_chats` to build a loyalty report.

## Benefits

- Super Chat Monitoring: Instead of missing massive interactions during peak traffic, you can use `get_super_chats` to continuously scan for every purchased donation without needing a browser open.
- Data Logging: Agency managers can map and store automated logs summarizing entire broadcast donation waves by running `get_gift_history`, which feeds directly into daily ledger CRMs.
- Moderation Safety: For community moderators, the MCP provides tools to inject strict AI safety layers capable of filtering toxic messages instantly across hundreds of incoming chat posts.
- Room Status Check: Quickly determine if a stream is active or what its core settings are by using `get_room_info` and `get_streamer_info` before building an automated workflow.
- Stream Control: You can take action by running `update_room_title`, allowing your agent to change the live room's title based on external triggers or events.
- Engagement Tracking: Go beyond simple view counts; use `get_fans_medal_info` and other tools to track deeper fan engagement metrics, like medal levels.

## How It Works

The bottom line is you get a tireless automated moderator that feeds raw text metrics directly to your AI client.

1. First, you must get official access by enrolling in the Bilibili Open Live Console.
2. Next, generate your required AccessKey and Secret combination for authentication.
3. Finally, plug those credentials into your agent; it handles the real-time chat parsing and data fetching.

## Frequently Asked Questions

**How do I get raw chat logs using the get_danmu_config tool?**
The `get_danmu_config` tool provides the specific WebSockets settings you need to connect your agent directly to the bullet-chat stream. This bypasses simple API calls and gives you continuous, real-time data feeds.

**Can I use get_super_chats for financial analysis?**
Yes. `get_super_chats` extracts actively purchased Super Chat records. You can then process this list to determine donation patterns or calculate total earnings across a broadcast cycle.

**What if I want to change the stream title? Do I use update_room_title?**
Yes, `update_room_title` is the tool for this. It allows your agent to programmatically modify the public-facing title of the streamer's room, letting you manage metadata automatically.

**Is get_streamer_info enough to know about a broadcaster?**
While `get_streamer_info` pulls core public account details, remember that you might also need to run `get_fans_medal_info` for deeper insight into specific fan engagement and loyalty.

**What information do I get when I run `get_room_info`?**
It fetches high-level configuration data for the live room. This initial read establishes essential details like the stream's current status, basic setup parameters, and general metadata before you can access specific chat or fan metrics.

**Are there rate limits I need to know about when using `send_danmu`?**
Yes. The API enforces throttling rules on message sending. You must manage your request frequency; hitting the limit will temporarily block further messages, so plan for staggered sends.

**Does `get_gift_history` retrieve a deep audit log of all virtual items?**
No. It displays recent virtual gifts given in the room. The scope is limited to the most immediate history and does not provide an exhaustive, long-term financial ledger.

**How do I use `get_guard_list` to check moderator status?**
It pulls a list of active 'Guards,' which are designated staff members or moderators within the room. This tool identifies their roles and operational presence, helping you gauge the overall moderation strength.

**Can my AI automatically aggregate bullet-chat density from a major active esports broadcast directly?**
Yes! Utilize the `get_room_danmu` endpoint integration tool. Your agent will dynamically hook to the channel pinging the rapid incoming stream mapping it natively to your terminal workspace seamlessly bypassing clunky UI obstacles totally.

**How do I fetch the exact real-time audience capacity on a specified VTuber room?**
Simply ask the agent to run `get_room_popularity` targeting the internal integer Room ID. The pipeline will isolate the live audience metric securely displaying the engagement index free of visual latency delays instantly in markdown format natively.

**Are there destructive capabilities enabling unwarranted permanent room shutdowns programmatically?**
Absolutely not. This suite adheres to read-only data mining directives strictly mapping traffic, messages, and identities. No system administration functions or destructive endpoints are configured assuring unbreakable security fences from external tampering continuously.