B站 MCP

通过 bilibili-api-python 操作哔哩哔哩，支持视频、动态、直播、收藏夹等全功能。

工作流程概览

1. 检查登录状态（check_login）
2. 如未登录 → 执行扫码登录流程（见下文）
3. 执行目标操作

安装（仅首次）

bash {{SKILL_DIR}}/scripts/install.sh

凭据存储

登录凭据使用 加密文件 存储在 data/credential.enc 中（Fernet AES-128-CBC），密钥自动从机器指纹派生。不再写入 .zshrc 或 .bashrc。

扫码登录流程（重要！）

当 check_login 返回 logged_in: false 时，必须执行以下步骤：

1. 调用 get_login_qrcode
2. 二维码图片会自动弹出预览窗口（macOS 用 open 命令打开）
3. 必须立即回复用户以下内容（不要省略！）：

   📱 请扫码登录 B 站账号：
   
   二维码已自动打开，请用哔哩哔哩 App 扫描登录。
   正在等待扫码...（最长等待 120 秒）

4. get_login_qrcode 会自动轮询等待扫码（每 3 秒检查一次，最长 120 秒），扫码成功后自动保存凭据并返回结果
5. 如果返回超时，提示用户重新调用

禁止：

• ❌ 使用 browser 工具（会占据整个界面无法返回）
• ❌ 说"二维码已保存到桌面"（二维码不再保存到桌面，而是自动弹出预览）

调用方式

python3 {{SKILL_DIR}}/scripts/bili_call.py <tool_name> [json_args]

工具列表

📋 账号管理

📤 内容发布

upload_video 可选参数：cover(封面), desc(简介), tags(标签列表), dynamic(动态文字), original(是否原创), source(转载来源)

publish_dynamic 可选参数：images(图片路径列表), topic_id, schedule_time(定时发布)

常用分区 tid：

• 17=单机游戏, 171=电子竞技, 172=手机游戏
• 138=搞笑, 21=日常, 75=动物圈
• 183=影视杂谈, 182=影视剪辑
• 122=野生技术协会, 39=演讲公开课

🔍 搜索

可选：page(页码，默认1)

🔥 热门/排行榜

排行榜 type_name：All=全站, Douga=动画, Music=音乐, Game=游戏, Ent=娱乐, Technology=科技, Knowledge=知识, Life=生活, Cinephile=影视, Food=美食, Animal=动物, Dance=舞蹈, Kichiku=鬼畜, Fashion=时尚, Sports=运动, Car=汽车, Original=原创, Rookie=新人

📺 视频信息

get_user_videos 可选：page, order(pubdate/click/stow)

👍 视频互动

like_video 可选：unlike=true 取消点赞 coin_video 可选：num(投币数量，1或2) favorite_video 可选：add_media_ids(收藏夹ID列表)

💬 弹幕

send_video_danmaku 可选：dm_time(出现时间秒数)

📝 动态

📺 直播

get_live_list 必填：area_id(子分区ID，通过 get_live_area_list 获取)；可选：page

📁 收藏夹

create_favorite_folder 可选：intro, privacy(是否私密)

👥 关注/粉丝

follow_user 可选：unfollow=true 取消关注

📜 历史记录

示例

# 检查登录
python3 {{SKILL_DIR}}/scripts/bili_call.py check_login

# 搜索视频
python3 {{SKILL_DIR}}/scripts/bili_call.py search_video '{"keyword":"AI教程"}'

# 获取热门视频
python3 {{SKILL_DIR}}/scripts/bili_call.py get_hot_videos

# 获取游戏区排行榜
python3 {{SKILL_DIR}}/scripts/bili_call.py get_rank '{"type_name":"Game","day":7}'

# 获取视频信息
python3 {{SKILL_DIR}}/scripts/bili_call.py get_video_info '{"bvid":"BV1xx411c7mD"}'

# 点赞视频
python3 {{SKILL_DIR}}/scripts/bili_call.py like_video '{"bvid":"BV1xx411c7mD"}'

# 发送弹幕
python3 {{SKILL_DIR}}/scripts/bili_call.py send_video_danmaku '{"bvid":"BV1xx411c7mD","text":"666"}'

# 获取直播间信息
python3 {{SKILL_DIR}}/scripts/bili_call.py get_live_info '{"room_id":21452505}'

# 发布动态
python3 {{SKILL_DIR}}/scripts/bili_call.py publish_dynamic '{"text":"今天天气不错"}'

# 发布带图动态
python3 {{SKILL_DIR}}/scripts/bili_call.py publish_dynamic '{"text":"分享图片","images":["/path/to/img.jpg"]}'

# 上传视频
python3 {{SKILL_DIR}}/scripts/bili_call.py upload_video '{"video_path":"/path/to/video.mp4","title":"我的视频","tid":17,"desc":"视频简介","tags":["游戏","实况"]}'

# 关注用户
python3 {{SKILL_DIR}}/scripts/bili_call.py follow_user '{"mid":123456}'

# 创建收藏夹
python3 {{SKILL_DIR}}/scripts/bili_call.py create_favorite_folder '{"title":"我的收藏","privacy":true}'

视频发布流程

当用户要发布视频但没有提供完整信息时：

1. 询问视频文件路径
2. 询问视频标题
3. 根据内容推荐合适的分区（tid）
4. 自动生成简短的 B 站风格简介和标签（不要调用其他 skill）
5. 调用 upload_video 上传

简介风格示例：

• "记录日常生活的小美好~"
• "希望大家喜欢，三连支持一下！"
• "第一次投稿，多多指教"

约束

• 视频标题 ≤ 80 字
• 动态文字 ≤ 2000 字
• 弹幕 ≤ 100 字
• 每日投稿上限约 50 个
• 封面会自动从视频提取（需要 ffmpeg 或 opencv-python）
• 部分操作需要登录（会自动提示）

故障排查

• 未登录 → 执行扫码登录流程
• 凭据过期 → 调用 logout 后重新登录
• 视频上传失败 → 检查文件路径、分区ID是否正确
• 封面提取失败 → 安装 ffmpeg: brew install ffmpeg