ai.smithery/222wcnm-bilistalkermcp

Official

by 222wcnm · Python

Track Bilibili creators and get the latest updates on videos, dynamics, and articles. Fetch user p…

Track Bilibili creators and retrieve their latest videos, updates, and user information.

Topics

ai-agentbilibilibilibili-apifastmcpmcpmcp-servermodel-context-protocolpython

README.md8 KBView on GitHub

BiliStalkerMCP

Bilibili MCP Server for Specific User Analysis

BiliStalkerMCP is a Bilibili MCP server built on Model Context Protocol (MCP), designed for AI agents that need to analyze a specific Bilibili user or creator.

It is optimized for workflows that start from a target uid or username, then retrieve that user's profile, videos, dynamics, articles, subtitles, and followings with structured tools.

If you are searching for a Bilibili MCP server, a Bilibili Model Context Protocol server, or an MCP server for tracking and analyzing a specific Bilibili user, this repository is designed for that use case.

English | 中文说明

Installation

bash

uvx bili-stalker-mcp
# or
pip install bili-stalker-mcp

Configuration (Claude Desktop, Recommended)

json

{
  "mcpServers": {
    "bilistalker": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/BiliStalkerMCP", "bili-stalker-mcp"],
      "env": {
        "SESSDATA": "required_sessdata",
        "BILI_JCT": "optional_jct",
        "BUVID3": "optional_buvid3"
      }
    }
  }
}

Prefer uv run --directory ... for faster local updates when PyPI release propagation is delayed. You can still use uvx bili-stalker-mcp for quick one-off usage.

Auth: Obtain SESSDATA from Browser DevTools (F12) > Application > Cookies > .bilibili.com.

Environment Variables

Key	Req	Description
`SESSDATA`	Yes	Bilibili session token.
`BILI_JCT`	No	CSRF protection token.
`BUVID3`	No	Hardware fingerprint (reduces rate-limiting risk).
`BILI_LOG_LEVEL`	No	`DEBUG`, `INFO` (Default), `WARNING`.
`BILI_TIMEZONE`	No	Output time zone for formatted timestamps (default: `Asia/Shanghai`).

Available Tools

Tool	Capability	Parameters
`get_user_info`	Profile & core statistics	`user_id_or_username`
`get_user_videos`	Lightweight video list	`user_id_or_username`, `page`, `limit`
`search_user_videos`	Keyword search in one user's video list	`user_id_or_username`, `keyword`, `page`, `limit`
`get_video_detail`	Full video detail + optional subtitles	`bvid`, `fetch_subtitles` (default: `false`), `subtitle_mode` (`smart`/`full`/`minimal`), `subtitle_lang` (default: `auto`), `subtitle_max_chars`
`get_user_dynamics`	Structured dynamics with image metadata and cursor pagination	`user_id_or_username`, `cursor`, `limit`, `dynamic_type`
`get_user_articles`	Lightweight article list	`user_id_or_username`, `page`, `limit`
`get_article_content`	Full article markdown content	`article_id`
`get_user_followings`	Subscription list analysis	`user_id_or_username`, `page`, `limit`
`get_content_comments`	Comments for a video, article, or dynamic (including images and note metadata)	`content_type`, `content_id`, `cursor`, `limit`, `sort`
`get_content_comment_replies`	Full sub-replies for a video, article, or dynamic comment	`content_type`, `content_id`, `root_rpid`, `page`, `limit`

Comment pictures contain the original image URLs. Regular long comments retain the full text returned by Bilibili. Note-style comments may contain only a preview; use the returned note.cvid with get_article_content to retrieve the full note. For video comments, pass content_type="video" and a BVID, AV number, or video URL as content_id. Use a top-level comment's rpid as root_rpid when fetching its complete reply thread.

Dynamic Filtering (`dynamic_type`)

ALL (default): Text, Draw, and Reposts.
ALL_RAW: Unfiltered (includes Videos & Articles).
VIDEO, ARTICLE, DRAW, TEXT: Specific category filtering.

Each dynamic item includes an images list. Every image contains url, width, and height; invalid URLs are omitted, and unavailable dimensions are null. image_count always equals the number of returned images. Reposts expose the same fields under origin.images and origin.image_count. Non-image dynamics return an empty images list.

Pagination: Responses include next_cursor. Pass this to subsequent requests for seamless scrolling.

Subtitle Modes (`get_video_detail`)

smart (default when fetch_subtitles=true): fetch metadata for all pages, download only one best-matched subtitle track text.
full: download text for all subtitle tracks (higher cost).
minimal: skip subtitle metadata and subtitle text fetching.

subtitle_lang can force a language (for example en-US); auto uses built-in priority fallback.
subtitle_max_chars caps returned subtitle text size to avoid token explosion.

Bundled Skill

The repository ships a ready-to-use AI agent skill in skills/bili-content-analysis/:

code

skills/bili-content-analysis/
├── SKILL.md                        # Workflow & output contract
└── references/
    └── analysis-style.md           # Detailed writing style rules

What It Does

Guides compatible AI agents (Gemini, Claude, etc.) through a structured 6-step workflow for deep Bilibili content analysis:

Clarify target and scope (uid / bvid / keyword).
Collect evidence — lightweight lists first, heavy detail only for high-value items.
Reconstruct source structure before interpreting (timeline, chapters, speakers).
Analyze — facts, logic chain, assumptions, themes, and shifts.
Retain anchors — uid, bvid, article_id, timestamps, key source snippets.
Handle failures — state blockers explicitly, stop speculation.

Usage

Copy the bili-content-analysis folder into your project's skill directory:

code

<project>/.agent/skills/bili-content-analysis/

The agent will automatically activate the skill when user requests involve Bilibili creator tracking, transcript interpretation, timeline reconstruction, or content analysis.

Development

bash

# Setup
git clone https://github.com/222wcnm/BiliStalkerMCP.git
cd BiliStalkerMCP
uv sync --dev

# Test
uv run pytest -q

# Integration & Performance (Requires Auth)
uv run python scripts/integration_suite.py -u <UID>
uv run python scripts/perf_baseline.py -u <UID> --tools dynamics -n 3

Release (Maintainers)

Credentials: The release script uses UV_PUBLISH_TOKEN when set; otherwise it reads the matching [pypi] or [testpypi] token from $HOME\.pypirc. Twine is invoked transiently through uvx only for package metadata validation and is not a project dependency.

powershell

# Build + test + package metadata validation (no upload)
.\scripts\pypi_release.ps1

# Upload to TestPyPI
.\scripts\pypi_release.ps1 -TestPyPI -Upload

# Upload to PyPI
.\scripts\pypi_release.ps1 -Upload

Docker

Runs via stdio transport. No ports exposed.

bash

docker build -t bilistalker-mcp .
docker run -e SESSDATA=... bilistalker-mcp

Troubleshooting

412 Precondition Failed: Bilibili anti-crawling system triggered. Refresh SESSDATA or provide BUVID3.
Cloud IPs: Highly susceptible to blocking; local execution is recommended.

License

MIT

Disclaimer: For personal research and learning only. Bulk profiling, harassment, or commercial surveillance is prohibited.

This project is built and maintained with the help of AI.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "222wcnm-bilistalkermcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://server.smithery.ai/@222wcnm/bilistalkermcp/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Topics

BiliStalkerMCP

Bilibili MCP Server for Specific User Analysis

Installation

Configuration (Claude Desktop, Recommended)

Environment Variables

Available Tools

Dynamic Filtering (dynamic_type)

Subtitle Modes (get_video_detail)

Bundled Skill

What It Does

Usage

Development

Release (Maintainers)

Docker

Troubleshooting

License

Install

Dynamic Filtering (`dynamic_type`)

Subtitle Modes (`get_video_detail`)