Skip to main content
Glama

SocialDataX B站 Bilibili MCP

bilibili_get_content_comments_by_url

Read-only

根据 Bilibili 视频、专栏或动态链接、短链接或分享文案获取一级评论列表。

Input Schema

NameRequiredDescriptionDefault
urlYesBilibili 视频、专栏或动态链接,t.bilibili.com 动态链接、短链接或包含链接的分享文案;用于获取该内容的一级评论;不要传用户主页链接、BV 号、aid、纯数字 ID 或 comment_id。
sort_typeNo评论排序方式:hot=最热,time_descending=最新。默认 hot。hot
page_tokenNoBilibili 一级评论分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回;page_token 是不透明分页令牌;不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成,不得用省略号替换中间内容。只能用于同一内容、同一排序和同一入口的评论分页链路;content_id 入口 / by_id 工具返回的 token 只能继续用于 content_id 入口 / by_id 工具,url 入口 / by_url 工具返回的 token 只能继续用于 url 入口 / by_url 工具;不能跨能力、入口、内容或排序复用。

Output Schema

NameRequiredDescriptionDefault
itemsYes当前页内容评论列表。
pointsYes本次成功调用的积分消耗与账户积分余额。
comment_countYes平台返回的评论总数,通常包含一级评论和回复;不是当前页数量,也不等于 items 中一级评论条数;不可用时为 null。
next_page_tokenYes下一页不透明分页令牌;为空表示没有更多一级评论。继续获取一级评论下一页时,必须将返回的完整 next_page_token 原样作为 page_token 传回,并沿用本次调用入口;content_id 入口 / by_id 工具返回的 token 只能继续用于 content_id 入口 / by_id 工具,url 入口 / by_url 工具返回的 token 只能继续用于 url 入口 / by_url 工具。不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成,不得用省略号替换中间内容;不能跨能力、入口、内容或排序复用。

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedOutput schema / properties / points / description
      Previous value: -"本次成功调用的积分消耗与调用完成时的账户积分余额。"New value: +"本次成功调用的积分消耗与账户积分余额。"
    • changedOutput schema / properties / points / properties / balance / description
      Previous value: -"本次接口完成时看到的当前积分余额,可为负数。"New value: +"优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。"
  2. Changed2 schema fields changed
    • changedOutput schema / properties / points / properties / balance / description
      Previous value: -"本次接口完成时看到的当前积分余额。"New value: +"本次接口完成时看到的当前积分余额,可为负数。"
    • removedOutput schema / properties / points / properties / balance / minimum
      Removed value: -0
  3. Changed20 schema fields changed
    • addedOutput schema / properties / comment_count / title
      Added value: +"Comment Count"
    • addedOutput schema / properties / items / items / properties / author / properties / avatar_url / title
      Added value: +"Avatar Url"
    • addedOutput schema / properties / items / items / properties / author / properties / member_level / title
      Added value: +"Member Level"
    • addedOutput schema / properties / items / items / properties / author / properties / name / title
      Added value: +"Name"
    • addedOutput schema / properties / items / items / properties / author / properties / profile_url / title
      Added value: +"Profile Url"
    • addedOutput schema / properties / items / items / properties / author / properties / user_id / title
      Added value: +"User Id"
    • addedOutput schema / properties / items / items / properties / author / title
      Added value: +"BilibiliCommentAuthorData"
    • addedOutput schema / properties / items / items / properties / comment_id / title
      Added value: +"Comment Id"
    • addedOutput schema / properties / items / items / properties / comment_object_id / title
      Added value: +"Comment Object Id"
    • addedOutput schema / properties / items / items / properties / comment_object_type / title
      Added value: +"Comment Object Type"
    • addedOutput schema / properties / items / items / properties / content / title
      Added value: +"Content"
    • addedOutput schema / properties / items / items / properties / image_urls / title
      Added value: +"Image Urls"
    • addedOutput schema / properties / items / items / properties / ip_location / title
      Added value: +"Ip Location"
    • addedOutput schema / properties / items / items / properties / like_count / title
      Added value: +"Like Count"
    • addedOutput schema / properties / items / items / properties / publish_time / title
      Added value: +"Publish Time"
    • addedOutput schema / properties / items / items / properties / reply_count / title
      Added value: +"Reply Count"
    • addedOutput schema / properties / items / items / title
      Added value: +"BilibiliContentCommentItemData"
    • addedOutput schema / properties / items / title
      Added value: +"Items"
    • addedOutput schema / properties / next_page_token / title
      Added value: +"Next Page Token"
    • addedOutput schema / title
      Added value: +"BilibiliContentCommentsResult"
  4. First observed

TDQS

A3.5/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true and openWorldHint=true, so the safety profile is covered. The description adds nothing about pagination, rate limits, or result size—those behaviors are only explained inside the page_token schema field, not in the description.

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

Conciseness4/5

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

A single front-loaded sentence with no filler. It is efficient, though it is arguably under-specified rather than concise, since it omits pagination and the by_id alternative entirely.

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?

With an output schema present and fully documented parameters, the description does not need to explain return values. It is nearly complete for a low-complexity read tool, with the only real gap being routing guidance between this and the by_id sibling.

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 description coverage is 100% and the url/page_token/sort_type fields are documented in exceptional detail, so the schema carries the full semantic load. The description contributes no additional parameter meaning beyond restating which link types are accepted.

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

Purpose4/5

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

The description uses a specific verb phrase ("获取一级评论列表") paired with the resource types it accepts (视频、专栏、动态链接、短链接或分享文案). Naming "一级评论" also distinguishes it from the sibling that fetches replies, though it never explicitly contrasts itself with the by_id variant.

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

Usage Guidelines3/5

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

Usage is only implied through the URL-oriented phrasing and the restriction to top-level comments; there is no explicit "use this when you have a link, use by_id when you have an ID" routing, and no exclusions stated in the description itself (those live only in the schema's url description).

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources