BiliStalkerMCP
A Model Context Protocol (MCP) server for comprehensive Bilibili user data acquisition.
Quick Start
Installation
Installing via Smithery
To install bilistalkermcp automatically via Smithery:
npx -y @smithery/cli install @222wcnm/bilistalkermcp
Manual Installation
uvx bili-stalker-mcp
Configuration
Add to your MCP client settings:
{
"mcpServers": {
"bilistalker": {
"command": "uvx",
"args": ["bili-stalker-mcp"],
"env": {
"SESSDATA": "your_sessdata",
"BILI_JCT": "your_bili_jct",
"BUVID3": "your_buvid3"
}
}
}
}
Available Tools
| Tool | Description | Parameters |
|---|---|---|
get_user_info | User profile and stats | user_id or username |
get_user_video_updates | Video publications with subtitles | user_id/username, page, limit |
get_user_dynamic_updates | User dynamics with type filtering | user_id/username, offset, limit, dynamic_type |
get_user_articles | Article publications | user_id/username, page, limit |
get_user_followings | Following list | user_id/username, page, limit |
Dynamic Type Filtering
The get_user_dynamic_updates tool supports filtering by type:
dynamic_type | Description |
|---|---|
ALL (default) | TEXT, IMAGE_TEXT, REPOST only (analysis-focused) |
ALL_RAW | All types including VIDEO, ARTICLE |
VIDEO | Video dynamics only |
ARTICLE | Article dynamics only |
DRAW | Image-text dynamics only |
TEXT | Text-only dynamics |
Return Data Features
- Human-readable timestamps: All time fields include formatted strings (e.g.,
created_time,publish_time) - Image URLs: Video covers (
pic) and dynamic images (images) can be rendered with - Repost origin: REPOST dynamics include full
originobject with original content details
Development
# Clone and setup
git clone https://github.com/222wcnm/BiliStalkerMCP.git
cd BiliStalkerMCP
uv pip install -e .
# Run tests
python tests/test_suite.py -u <user_id_or_username>
License
MIT
This project was entirely created and maintained by AI.