Bilibili API MCP Server

# bilibili-api-python 库完整分析报告 ## 1. 库概览分析 ### 基本信息 - **版本**: 17.1.4 - **描述**: 哔哩哔哩的各种 API 调用便捷整合（视频、动态、直播等），另外附加一些常用的功能 - **架构**: 模块化设计，每个功能领域都有独立的模块 - **技术特点**: 异步优先设计，完整的异常处理体系，多客户端适配支持 ### 完整架构图 ``` bilibili_api/ ├── 核心功能模块 (42个) │ ├── user.py # 用户相关 │ ├── video.py # 视频相关 │ ├── dynamic.py # 动态相关 │ ├── search.py # 搜索相关 │ ├── live.py # 直播相关 │ ├── bangumi.py # 番剧相关 │ ├── comment.py # 评论相关 │ ├── activity.py # 活动相关 │ ├── app.py # 移动端API │ ├── article.py # 专栏文章 │ ├── article_category.py # 专栏分类 │ ├── ass.py # ASS字幕/弹幕 │ ├── audio.py # 音频相关 │ ├── audio_uploader.py # 音频上传 │ ├── black_room.py # 小黑屋 │ ├── channel_series.py # 频道合集 │ ├── cheese.py # 课程相关 │ ├── client.py # 客户端配置 │ ├── creative_center.py # 创作中心 │ ├── emoji.py # 表情包 │ ├── favorite_list.py # 收藏夹 │ ├── festival.py # 节日活动 │ ├── game.py # 游戏相关 │ ├── homepage.py # 首页推荐 │ ├── hot.py # 热门内容 │ ├── interactive_video.py # 互动视频 │ ├── live_area.py # 直播分区 │ ├── login_v2.py # 登录验证 │ ├── manga.py # 漫画相关 │ ├── music.py # 音乐相关 │ ├── note.py # 笔记功能 │ ├── opus.py # 图文动态 │ ├── rank.py # 排行榜 │ ├── session.py # 会话管理 │ ├── show.py # 综艺节目 │ ├── topic.py # 话题相关 │ ├── video_tag.py # 视频标签 │ ├── video_uploader.py # 视频上传 │ ├── video_zone.py # 视频分区 │ ├── vote.py # 投票功能 │ └── watchroom.py # 观影厅 ├── 工具模块 (utils/ - 15个) │ ├── sync.py # 异步同步转换 │ ├── network.py # 网络请求 │ ├── danmaku.py # 弹幕处理 │ ├── AsyncEvent.py # 异步事件 │ ├── BytesReader.py # 字节流读取 │ ├── aid_bvid_transformer.py # AV/BV号转换 │ ├── cache_pool.py # 缓存池 │ ├── danmaku2ass.py # 弹幕转ASS │ ├── geetest.py # 极验验证 │ ├── initial_state.py # 初始状态解析 │ ├── parse_link.py # 链接解析 │ ├── picture.py # 图片处理 │ ├── short.py # 短链接 │ ├── srt2ass.py # SRT转ASS │ ├── upos.py # 上传服务 │ ├── user_render_data.py # 用户渲染数据 │ ├── utils.py # 通用工具 │ └── varint.py # 变长整数 ├── 异常处理 (exceptions/ - 18个) │ ├── ApiException.py # API异常 │ ├── ArgsException.py # 参数异常 │ ├── CookiesRefreshException.py # Cookie刷新异常 │ ├── CredentialNoAcTimeValueException.py # 凭据时间异常 │ ├── CredentialNoBiliJctException.py # 凭据JCT异常 │ ├── CredentialNoBuvid3Exception.py # 凭据Buvid3异常 │ ├── CredentialNoBuvid4Exception.py # 凭据Buvid4异常 │ ├── CredentialNoDedeUserIDException.py # 凭据用户ID异常 │ ├── CredentialNoSessdataException.py # 凭据Session异常 │ ├── DanmakuClosedException.py # 弹幕关闭异常 │ ├── DynamicExceedImagesException.py # 动态图片超限异常 │ ├── ExClimbWuzhiException.py # 爬虫检测异常 │ ├── GeetestException.py # 极验异常 │ ├── LiveException.py # 直播异常 │ ├── LoginError.py # 登录错误 │ ├── NetworkException.py # 网络异常 │ ├── ResponseCodeException.py # 响应码异常 │ ├── ResponseException.py # 响应异常 │ ├── StatementException.py # 声明异常 │ ├── VideoUploadException.py # 视频上传异常 │ └── WbiRetryTimesExceedException.py # WBI重试超限异常 ├── 客户端适配 (clients/ - 3个) │ ├── AioHTTPClient.py # AioHTTP客户端 │ ├── CurlCFFIClient.py # CurlCFFI客户端 │ └── HTTPXClient.py # HTTPX客户端 ├── 数据文件 (data/) │ ├── api/ # API配置文件 │ ├── appeal.json # 申诉数据 │ ├── article_category.json # 专栏分类 │ ├── audio_search_tags.json # 音频搜索标签 │ ├── bangumi_index_params.json # 番剧索引参数 │ ├── countries_codes.json # 国家代码 │ ├── geetest/ # 极验相关数据 │ ├── subtitle_lan.json # 字幕语言 │ ├── video_uploader_lines.json # 上传线路 │ ├── video_uploader_meta_pre.json # 上传元数据 │ └── video_zone.json # 视频分区 └── 工具集 (tools/) ├── ivitools/ # 互动视频工具 │ ├── download.py # 下载工具 │ ├── extract.py # 提取工具 │ ├── player.py # 播放器 │ └── touch.py # 触摸交互 └── parser/ # 解析工具 ├── Card.vue # Vue组件 ├── app.py # 解析应用 └── parser.py # 解析器 ``` ## 2. 核心功能模块详细分析 (42个) ### 🎯 内容相关模块 (12个) - **video.py**: 视频信息、下载、弹幕、播放数据、AI总结 - **audio.py**: 音频播放、收藏、评论、歌单管理 - **article.py**: 专栏文章阅读、点赞、收藏、分类浏览 - **bangumi.py**: 番剧信息、剧集、时间表、追番功能 - **manga.py**: 漫画阅读、购买、收藏、章节管理 - **interactive_video.py**: 互动视频的选择分支、剧情树 - **opus.py**: 图文动态内容、多媒体发布 - **show.py**: 综艺节目信息、节目单 - **music.py**: 音乐播放、歌单、音乐人信息 - **game.py**: 游戏相关内容、游戏区视频 - **cheese.py**: 付费课程学习、知识付费 - **note.py**: 视频笔记功能、学习记录 ### 👥 用户交互模块 (8个) - **user.py**: 用户信息、关注、粉丝、个人中心 - **dynamic.py**: 动态发布、获取、互动、转发评论 - **comment.py**: 评论发布、获取、管理、楼中楼 - **favorite_list.py**: 收藏夹管理、分类收藏 - **vote.py**: 投票功能、问卷调查 - **emoji.py**: 表情包使用、自定义表情 - **topic.py**: 话题参与、热门话题 - **black_room.py**: 违规处理、封禁管理 ### 🔴 直播相关模块 (2个) - **live.py**: 直播间信息、弹幕、礼物、大航海 - **live_area.py**: 直播分区管理、分区推荐 ### 🔍 搜索发现模块 (4个) - **search.py**: 全站搜索功能、多类型搜索 - **rank.py**: 各类排行榜、热门榜单 - **hot.py**: 热门内容推荐、趋势分析 - **homepage.py**: 首页推荐算法、个性化推荐 ### 🎨 创作者工具模块 (6个) - **video_uploader.py**: 视频上传管理、批量上传 - **audio_uploader.py**: 音频上传管理、音频处理 - **creative_center.py**: 创作者数据中心、收益统计 - **channel_series.py**: 频道合集管理、系列视频 - **video_tag.py**: 视频标签管理、标签推荐 - **video_zone.py**: 视频分区管理、分区规则 ### 🏢 平台功能模块 (6个) - **activity.py**: 官方活动参与、活动管理 - **festival.py**: 节日特别活动、主题活动 - **session.py**: 用户会话管理、登录状态 - **login_v2.py**: 登录验证流程、二次验证 - **watchroom.py**: 观影厅功能、同步观看 - **client.py**: 客户端配置、设备管理 ### 📝 分类管理模块 (2个) - **article_category.py**: 专栏文章分类、内容分类 - **app.py**: 移动端专用API、移动端功能 ### 🎬 字幕弹幕模块 (2个) - **ass.py**: ASS格式字幕和弹幕处理、格式转换 ## 3. 工具模块详细分析 (utils/ - 15个) ### 🔧 核心工具 (4个) - **sync.py**: 异步函数同步化转换，核心工具 - **network.py**: HTTP请求封装、凭据管理、网络配置 - **utils.py**: 通用工具函数集合、辅助功能 - **AsyncEvent.py**: 异步事件处理框架、事件监听 ### 📊 数据处理 (4个) - **danmaku.py**: 弹幕数据结构和处理、弹幕解析 - **danmaku2ass.py**: 弹幕转ASS字幕格式、格式转换 - **srt2ass.py**: SRT字幕转ASS格式、字幕处理 - **BytesReader.py**: 二进制数据流读取、数据解析 ### 🔄 ID转换 (2个) - **aid_bvid_transformer.py**: AV号和BV号互转、ID转换 - **varint.py**: 变长整数编解码、数据编码 ### 🔗 链接处理 (2个) - **parse_link.py**: B站链接解析和识别、URL处理 - **short.py**: 短链接处理、链接缩短 ### 🖼️ 媒体处理 (1个) - **picture.py**: 图片上传和处理、图片压缩 ### 🔐 验证相关 (2个) - **geetest.py**: 极验滑动验证码处理、反机器人 - **initial_state.py**: 页面初始状态解析、状态管理 - **user_render_data.py**: 用户渲染数据解析、数据格式化 - **upos.py**: 文件上传服务、云存储 - **cache_pool.py**: 数据缓存池管理、性能优化 ## 4. 异常处理体系 (exceptions/ - 18个) ### 🔑 凭据相关异常 (6个) - **CredentialNoSessdataException.py**: 缺少sessdata凭据 - **CredentialNoBiliJctException.py**: 缺少bili_jct凭据 - **CredentialNoDedeUserIDException.py**: 缺少用户ID凭据 - **CredentialNoAcTimeValueException.py**: 缺少时间值凭据 - **CredentialNoBuvid3Exception.py**: 缺少buvid3凭据 - **CredentialNoBuvid4Exception.py**: 缺少buvid4凭据 ### 🌐 网络相关异常 (4个) - **NetworkException.py**: 网络连接异常 - **ResponseException.py**: 响应异常 - **ResponseCodeException.py**: HTTP状态码异常 - **CookiesRefreshException.py**: Cookie刷新失败 ### ⚙️ 功能相关异常 (5个) - **DanmakuClosedException.py**: 弹幕功能关闭 - **DynamicExceedImagesException.py**: 动态图片数量超限 - **VideoUploadException.py**: 视频上传失败 - **LiveException.py**: 直播相关异常 - **WbiRetryTimesExceedException.py**: WBI签名重试超限 ### 🔒 验证相关异常 (3个) - **GeetestException.py**: 极验验证失败 - **LoginError.py**: 登录失败 - **ExClimbWuzhiException.py**: 反爬虫检测 ## 5. 客户端适配 (clients/ - 3个) - **HTTPXClient.py**: 基于HTTPX的HTTP客户端（默认） - **AioHTTPClient.py**: 基于aiohttp的HTTP客户端 - **CurlCFFIClient.py**: 基于curl-cffi的HTTP客户端（绕过检测） ## 6. 核心API功能总结 ### 🔍 搜索模块 (search.py) **主要功能**: - `search()`: 基础关键词搜索 - `search_by_type()`: 按类型搜索（视频、用户、直播、专栏等） - `get_hot_search_keywords()`: 获取热搜 - `get_suggest_keywords()`: 搜索建议 **搜索类型支持**: - `SearchObjectType`: VIDEO, USER, BANGUMI, LIVE, ARTICLE, TOPIC, PHOTO - **排序选项**: 按时间、播放量、粉丝数等多种排序方式 ### 👤 用户模块 (user.py) **核心类**: `User(uid, credential=None)` **主要功能**: - `get_user_info()`: 获取用户基本信息 - `get_dynamics_new()`: 获取用户动态（新接口） - `get_videos()`: 获取用户投稿视频 - `get_channels()`: 获取用户合集/列表 - `get_followers()`: 获取粉丝列表 - `get_followings()`: 获取关注列表 - `get_top_videos()`: 获取代表作 ### 🎬 视频模块 (video.py) **核心类**: `Video(bvid/aid, credential=None)` **主要功能**: - `get_info()`: 获取视频基本信息 - `get_detail()`: 获取视频详细信息 - `get_pages()`: 获取分P信息 - `get_danmakus()`: 获取弹幕 - `get_download_url()`: 获取下载链接 - `get_tags()`: 获取视频标签 - `get_related()`: 获取相关视频 ### 📱 动态模块 (dynamic.py) **核心类**: `Dynamic(dynamic_id, credential=None)` **主要功能**: - `get_info()`: 获取动态信息 - `get_reposts()`: 获取转发列表 - `get_likes()`: 获取点赞列表 - `send_dynamic()`: 发送动态 - `get_dynamic_page_info()`: 获取动态页信息 ### 🔴 直播模块 (live.py) **核心类**: `LiveRoom(room_display_id, credential=None)` **主要功能**: - `get_room_info()`: 获取直播间信息 - `get_room_play_url()`: 获取直播流地址 - `get_danmu_info()`: 获取弹幕服务器信息 - `get_dahanghai()`: 获取大航海列表 - `get_gift_config()`: 获取礼物配置 ### 🎭 番剧模块 (bangumi.py) **核心类**: `Bangumi(media_id/season_id)`, `Episode(epid)` **主要功能**: - `get_meta()`: 获取番剧元信息 - `get_episodes()`: 获取剧集列表 - `get_timeline()`: 获取时间表 - `get_index_info()`: 获取索引信息 ### 💬 评论模块 (comment.py) **核心类**: `Comment(oid, type, rpid, credential=None)` **主要功能**: - `get_comments()`: 获取评论列表 - `get_sub_comments()`: 获取子评论 - `send_comment()`: 发送评论 ## 7. 重点功能深入分析 ### 🎯 与当前项目高度相关的功能 #### A. 用户内容获取 (已使用) ```python # 用户动态 user.get_dynamics_new(offset="") # 新接口，推荐使用 user.get_dynamics(offset=0) # 旧接口 # 用户投稿 user.get_videos(tid=0, pn=1, ps=30, keyword="", order=VideoOrder.PUBDATE) # 用户合集 user.get_channels() # 返回 List[ChannelSeries] ``` #### B. 搜索功能 (已使用) ```python # 精确搜索 search.search_by_type( keyword="IT咖啡馆", search_type=SearchObjectType.USER, order_type=OrderUser.FANS, page_size=50 ) ``` ### 🚀 未使用但有潜力的功能 #### A. 视频详细分析 ```python video = Video("BV1234567890") await video.get_info() # 基本信息 await video.get_detail() # 详细信息 await video.get_tags() # 标签 await video.get_related() # 相关视频 await video.get_ai_conclusion() # AI总结 ``` #### B. 直播间监控 ```python live_room = LiveRoom(12345) await live_room.get_room_info() # 直播间信息 await live_room.get_room_play_url() # 直播流地址 ``` #### C. 评论分析 ```python # 获取视频评论 comments = await get_comments( oid=video_aid, type_=CommentResourceType.VIDEO, page_index=1, page_size=20 ) ``` #### D. 番剧追踪 ```python bangumi = Bangumi(season_id=12345) await bangumi.get_meta() # 番剧信息 await bangumi.get_episodes() # 剧集列表 ``` ## 8. 实用性评估与功能增强建议 ### 🎯 高价值未使用功能 #### 1. **视频深度分析功能** ```python @mcp.tool() def analyze_video_content(bvid: str) -> Dict[str, Any]: """ 深度分析视频内容，包括AI总结、标签、相关视频等 """ v = video.Video(bvid) info = sync(v.get_info()) tags = sync(v.get_tags()) related = sync(v.get_related()) ai_summary = sync(v.get_ai_conclusion()) return { "basic_info": info, "tags": tags, "related_videos": related, "ai_summary": ai_summary } ``` #### 2. **直播间监控功能** ```python @mcp.tool() def get_live_room_status(room_id: int) -> Dict[str, Any]: """ 获取直播间状态和信息 """ room = live.LiveRoom(room_id) room_info = sync(room.get_room_info()) play_info = sync(room.get_room_play_info()) return { "room_info": room_info, "is_live": play_info.get("live_status") == 1, "title": room_info.get("title"), "online": room_info.get("online") } ``` #### 3. **评论情感分析功能** ```python @mcp.tool() def analyze_video_comments(bvid: str, count: int = 50) -> Dict[str, Any]: """ 分析视频评论，提取热门评论和情感倾向 """ v = video.Video(bvid) aid = sync(v.get_aid()) comments = sync(comment.get_comments( oid=aid, type_=comment.CommentResourceType.VIDEO, page_size=count )) # 提取热门评论 hot_comments = [] for reply in comments.get("replies", []): hot_comments.append({ "content": reply["content"]["message"], "like": reply["like"], "author": reply["member"]["uname"] }) return { "total_comments": comments.get("page", {}).get("count", 0), "hot_comments": hot_comments[:10] } ``` #### 4. **热门内容发现功能** ```python @mcp.tool() def discover_trending_content(category: str = "all") -> Dict[str, Any]: """ 发现热门内容，包括热搜、热门视频等 """ # 获取热搜 hot_search = sync(search.get_hot_search_keywords()) # 获取热门视频（通过搜索热门关键词） trending_videos = [] if hot_search.get("list"): for item in hot_search["list"][:5]: keyword = item.get("keyword", "") videos = sync(search.search_by_type( keyword=keyword, search_type=search.SearchObjectType.VIDEO, page_size=3 )) trending_videos.extend(videos.get("result", [])[:2]) return { "hot_keywords": [item.get("keyword") for item in hot_search.get("list", [])[:10]], "trending_videos": trending_videos } ``` ### 📈 功能增强建议优先级 #### 🔥 高优先级 1. **视频内容分析** - 扩展现有视频功能，增加AI总结和标签分析 2. **评论情感分析** - 帮助用户了解视频反响 3. **热门内容发现** - 提供内容推荐和趋势分析 #### 🔶 中优先级 4. **直播间监控** - 实时监控关注UP主的直播状态 5. **番剧追踪** - 追踪番剧更新状态 #### 🔷 低优先级 6. **数据统计分析** - 提供更深入的数据分析功能 7. **内容创作辅助** - 帮助内容创作者分析数据 ## 9. 技术实现要点 ### 🔧 核心技术特点 1. **异步处理**: 所有API都是异步的，需要使用`sync()`函数转换 2. **凭据管理**: 部分功能需要登录凭据(`Credential`) 3. **错误处理**: 库提供了完整的异常体系 4. **数据清洗**: API返回的数据通常很详细，需要提取关键信息 5. **频率限制**: 注意API调用频率，避免被限制 ### 🔗 与bilibili-mcp-server集成建议 1. **统一异常处理**: 利用库的异常体系提供更好的错误信息 2. **缓存机制**: 使用cache_pool模块优化性能 3. **多客户端支持**: 根据需要选择合适的HTTP客户端 4. **数据格式化**: 利用工具模块进行数据清洗和格式转换 ## 10. 总结 bilibili-api-python 是一个功能非常全面的库，当前项目只使用了其中很小一部分功能。通过扩展使用更多API，可以显著增强 bilibili-mcp-server 的功能，为用户提供更丰富的哔哩哔哩内容分析和监控服务。 **建议优先实现**： - 视频内容分析和评论分析功能 - 这些功能与现有的用户内容获取功能形成很好的互补 - 能够提供更全面的内容洞察 **架构优势**： - 完整覆盖B站所有功能领域 - 专业的模块化设计 - 完善的异常处理体系 - 多客户端适配支持 - 丰富的工具模块支持