SocialDataX B站 Bilibili MCP

bilibili_get_video_download_links

Read-only

根据 Bilibili 视频链接或分享文案获取本地 CLI 下载和 ffmpeg 合并所需的视频下载地址 manifest。

TableJSON Schema

Name	Required	Description	Default
`url`	Yes	Bilibili 视频链接、短链接或包含视频链接的分享文案；用于获取本地 CLI 下载和 ffmpeg 合并所需的视频下载地址 manifest；多 P 视频链接会按 URL 中的 p 参数选择对应分 P；不要传用户主页链接、专栏/动态链接、BV 号或 aid。

TableJSON Schema

Name	Required	Description
`aid`	Yes	B 站视频数字 aid，即老 AV 号的数字部分；仅作为备用视频标识。没有 bvid 时，建议拼成 av{aid} 作为 content_id 传入，避免裸数字和专栏/动态 ID 混淆。
`cid`	Yes	本次下载地址对应的视频分 P cid。
`bvid`	Yes	B 站视频 BV 号；读取视频详情时可作为 bilibili_get_content_detail_by_id 的 content_id 输入，优先使用 bvid；获取视频评论时也优先复用 bvid。
`page`	Yes	本次下载地址对应的分 P 序号；不可用时为 null。
`title`	Yes	视频标题；不可用时为空字符串。
`points`	Yes	本次成功调用的积分消耗与调用完成时的账户积分余额。
`headers`	Yes	本地下载时建议携带的 HTTP headers，通常包含 Referer 和 User-Agent。
`platform`	Yes	平台标识，固定为 bilibili。
`expires_at`	Yes	下载地址过期时间，秒级 Unix 时间戳；无法可靠判断时为 null。
`selected_quality`	Yes	服务端默认选择的清晰度描述；不可用时为空字符串。
`download_manifest`	Yes	本地 CLI 下载和合并所需的 manifest。

Changes observed during successful MCP inspections.

A4/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

注释已声明readOnlyHint=true和openWorldHint=true，描述未与之矛盾。描述额外说明了多P视频按p参数选择分P的行为，这有价值。但未提及可能的错误、权限要求或返回细节，不过输出schema存在，故整体尚可。评分3合理。

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

描述为一句紧凑的句子，清晰罗列了用途和输入限制，无冗余信息。信息密度高且前置，结构合理。

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

工具只有一个参数且schema覆盖完整，有输出schema，注释涵盖只读和开放世界。描述提供了输入限制和用途，对于此类简单工具已足够完整。唯一可增强的是对返回值或输出的简要说明，但输出schema已覆盖，故评分4。

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

schema覆盖100%，url参数的描述已包含输入限制和多P行为，描述未添加超越schema解析的新语义。虽然描述重复了部分信息，但未显著增加价值，符合基线3。

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

描述明确说明了工具的作用：根据Bilibili视频链接或分享文案获取视频下载地址manifest，用于本地CLI下载和ffmpeg合并。动词“获取”和资源“视频下载地址 manifest”表述清晰，且与同级工具（评论、用户信息、搜索等）明显区分，目的明确无歧义。

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

描述详细说明了输入类型（链接、短链接、分享文案），并明确列出不接受的输入（用户主页、专栏/动态、BV号、aid），提供了明确的使用约束。还说明了多P视频的选择逻辑，增强了使用指导。但未直接与其他工具对比或说明“何时用此工具而非其他”，因此略欠完善。

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Add one secure layer between your agents and this server.