Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
BILIBILI_COOKIENoOptional Bilibili login cookie (at least SESSDATA) used to improve search reliability and enable subtitle access, especially AI subtitles. Example: SESSDATA=xxx; bili_jct=yyy

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

B站学习助手。search_videos 找视频,get_video_info 看简介和分P,get_subtitles 读字幕(做笔记和总结的最佳素材),get_hot_comments 判断视频口碑。本服务只提供数据,不调用 LLM,总结由你完成。如果工具返回 Cookie 相关的提示,请把配置方法转告用户,不要原样重复调用。

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_videosA

在 B 站搜索学习类视频,返回标题、UP主、BV号、时长、播放量和链接。

何时调用:
    - 用户想找某个主题的教程、课程或讲解,而手上还没有具体视频时,先用本工具。
    - 需要给用户一份候选清单让他挑选时。
    - 已经知道 BV 号时不要用本工具,直接调用 get_video_info。

参数:
    keyword: 搜索关键词,建议 1-4 个词,例如 "线性代数 期末速成"、"MIT 6.824"。
        支持中英文和空格;不要传 URL 或 BV 号。无需 Cookie 也能搜索,
        配置 Cookie 可提高被风控时的成功率。
    limit: 返回条数,范围 1-50,默认 5。给用户做选择时 5-10 条足够。

返回示例:
    搜索「线性代数」找到 2 个视频:

    1. 线性代数 期末速成(4小时)
       UP主:某老师 | 时长:4:12:30 | 播放:120.5万
       BV号:BV1xx411c7mD
       链接:https://www.bilibili.com/video/BV1xx411c7mD

失败时:
    返回以「搜索失败:」开头的中文说明。搜索可匿名使用;若被 B 站风控拦截,
    会提示配置 BILIBILI_COOKIE。请把配置方法转告用户,不要用相同参数反复重试。
get_video_infoA

读取单个 B 站视频的详细信息:标题、简介、UP主、分P列表(含 cid)、互动数据、时长。

何时调用:
    - 用户给了 BV 号或视频链接,想了解这个视频讲了什么时。
    - 调用 get_subtitles 或 get_hot_comments 之前,先确认分P数量和 cid。
    - 视频没有字幕时,用简介判断内容是否值得看。

参数:
    bv_id: BV 号或完整链接。支持 "BV1GJ411x7h7"、
        "https://www.bilibili.com/video/BV1GJ411x7h7"、
        "https://www.bilibili.com/video/BV1GJ411x7h7?p=2" 等写法。
        注意 BV 号主体区分大小写,请原样复制,不要手打。

返回示例:
    标题:线性代数的本质
    BV号:BV1GJ411x7h7 | AV号:8047632
    UP主:3Blue1Brown
    时长:1:02:03(3723 秒)
    播放:1234.5万 | 点赞:8.9万 | 收藏:3.2万 | 投币:1.1万 | 评论:4321
    发布时间:2020-05-01
    链接:https://www.bilibili.com/video/BV1GJ411x7h7

    简介:
    (最多 800 字,超出会标注「已截断」)

    分P列表(共 2 P):
    P1 | cid=12345678 | 00:12:34 | 向量是什么
    P2 | cid=12345679 | 00:15:01 | 线性组合

失败时:
    返回以「获取视频信息失败:」开头的说明。BV 号格式错误时会提示正确写法,
    视频不存在或被删除时会说明原因,不要用同样的参数重试。
get_subtitlesA

读取视频某一 P 的字幕,按 "[mm:ss] 文本" 逐行返回,适合做带时间戳的笔记。

何时调用:
    - 用户要总结视频、做学习笔记、提取知识点时(这是最重要的素材来源,优先于简介)。
    - 需要引用原话或定位具体时间点时。
    - 用户问「这个视频讲了什么」而 get_video_info 的简介太简略时。

参数:
    bv_id: BV 号或完整链接,例如 "BV1GJ411x7h7"。
    page: 分P序号,从 1 开始,默认 1。先用 get_video_info 查看共几 P。
    start_sec: 只返回起始时间 >= 该秒数的字幕,例如 600 表示 10:00 之后。
    end_sec: 只返回起始时间 <= 该秒数的字幕,例如 1200 表示 20:00 之前。
        字幕过长时可分段读取:先 0-600,再 600-1200……

返回示例:
    《线性代数的本质》第 1 P(向量是什么)字幕 - 中文(自动生成),共 412 行
    时间范围:00:00 - 06:52

    [00:00] 这个视频我们来聊向量
    [00:03] 首先从物理学的角度

注意:
    - AI 字幕需要登录 Cookie;部分视频没有字幕,此时会返回明确提示。
    - 单次最多返回 8000 行,超出会截断并说明总行数,请用 start_sec/end_sec 分段读取。

失败时:
    返回以「读取字幕失败:」开头的说明,并给出下一步建议。
get_hot_commentsA

按点赞数排序返回视频的热门评论,用来判断视频质量和观众口碑。

何时调用:
    - 用户想知道某个视频「值不值得看」「大家评价怎么样」时。
    - 总结完视频内容后,想补充观众反馈作为参考时。
    - 不要用它替代 get_subtitles 做内容总结:评论只有观点,没有讲解内容。

参数:
    bv_id: BV 号或完整链接,例如 "BV1GJ411x7h7"。
    limit: 返回条数,范围 1-49,默认 10。

返回示例:
    《线性代数的本质》热门评论(按点赞排序,共 1234 条,返回前 2 条):

    1. 👍 892 | 某用户
       讲得比我们老师清楚多了
    2. 👍 431 | 另一个用户
       第三集开始有点快,建议 0.75 倍速

失败时:
    返回以「获取评论失败:」开头的说明;评论区关闭时会明确告知,
    此时可以改用 get_subtitles 或 get_video_info 了解内容。

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.6/5.0

Scored across 4 tools

Disambiguation5/5

Each tool targets a distinct resource: discovery (search_videos), metadata (get_video_info), content (get_subtitles), and social proof (get_hot_comments). The descriptions explicitly draw boundaries, e.g. 'already know the BV id → don't use search_videos' and 'don't use get_hot_comments as a substitute for get_subtitles'.

Naming Consistency5/5

All four names follow a consistent snake_case verb_noun pattern: search_videos, get_video_info, get_subtitles, get_hot_comments. The verb choice (search vs get) also maps meaningfully to the operation type.

Tool Count5/5

Four tightly scoped tools that each earn their place in a single linear workflow (find → inspect → read → validate). Nothing feels redundant or missing at the tool-count level for a video-learning server.

Completeness4/5

The surface covers the full learning lifecycle: discover videos, get metadata/分P info, read timestamped subtitles with pagination, and check audience feedback. Minor gaps exist — no way to list a UP主's other videos, no cross-video/collection search, and no tool to persist notes — but agents can work around these.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues