SocialDataX B站 Bilibili MCP

{
  "type": "object",
  "required": [
    "comment_object_id",
    "comment_object_type",
    "comment_id"
  ],
  "properties": {
    "comment_id": {
      "type": "string",
      "description": "B 站一级评论 ID；用户已提供时直接使用，否则可从一级评论结果 items[].comment_id 复制；不要自行构造，不要传评论回复项的 comment_id。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "Bilibili 评论回复分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一内容下同一条一级评论的回复分页链路，也就是同一 comment_object_id、comment_object_type 和一级 comment_id；不能跨能力、内容或评论复用。"
    },
    "comment_object_id": {
      "type": "string",
      "description": "被评论对象 ID；用户已提供时直接使用，否则从一级评论结果复制 comment_object_id；必须与同一条一级评论的 comment_id 和 comment_object_type 一起使用；不要自行构造。"
    },
    "comment_object_type": {
      "type": "integer",
      "description": "被评论对象类型编号；用户已提供时直接使用，否则从一级评论结果复制 comment_object_type；必须与同一条一级评论的 comment_id 和 comment_object_id 一起使用；不要自行构造。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "content_id"
  ],
  "properties": {
    "sort_type": {
      "enum": [
        "hot",
        "time_descending"
      ],
      "type": "string",
      "default": "hot",
      "description": "评论排序方式：hot=最热，time_descending=最新。默认 hot。"
    },
    "content_id": {
      "type": "string",
      "description": "Bilibili 内容 ID；用于获取一级评论。视频优先传 bvid（BV...）；如果只有视频 aid，建议传 av{aid}（如 av116668525186915）以明确表示视频评论区；不建议直接传裸数字 aid，因为裸数字也可能是专栏/动态评论区 ID。专栏可传 cv 专栏 ID（如 cv9689859），动态/opus 可传 /opus/{id} 或 /dynamic/{id} 路径中的数字 post_id。不要传 comment_object_id、comment_id、链接或分享文案。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "Bilibili 一级评论分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一内容、同一排序和同一入口的评论分页链路；content_id 入口 / by_id 工具返回的 token 只能继续用于 content_id 入口 / by_id 工具，url 入口 / by_url 工具返回的 token 只能继续用于 url 入口 / by_url 工具；不能跨能力、入口、内容或排序复用。"
    }
  },
  "additionalProperties": false
}

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

{
  "type": "object",
  "required": [
    "content_id"
  ],
  "properties": {
    "content_id": {
      "type": "string",
      "description": "Bilibili 内容 ID；读取视频详情时优先传 bvid（BV...）。如果只有视频 aid，建议传 av{aid}（如 av116668525186915）以明确表示视频；不建议直接传裸数字 aid，因为裸数字也可能是专栏/动态 post_id，容易混淆并会按自动识别处理。读取专栏详情时传 cv 专栏 ID（如 cv9689859）；读取动态/opus 详情时可传 /opus/{id} 或 /dynamic/{id} 路径中的数字 post_id。不要传链接或分享文案。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Bilibili 视频、专栏或动态链接，t.bilibili.com 动态链接、短链接或包含链接的分享文案；读取视频详情、专栏详情或动态详情时优先传完整链接；不要传用户主页链接、BV 号、aid 或纯数字 ID。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "post_id"
  ],
  "properties": {
    "post_id": {
      "type": "string",
      "description": "Bilibili 专栏/动态 post_id；即 /opus/{id}、/dynamic/{id} 或 t.bilibili.com/{id} 路径里的数字 ID。也可以从内容详情返回的 post.post_id 复制。专栏搜索结果的 content_id=cv... 不能直接用于赞与转发；从专栏搜索结果出发时，先获取详情，再使用详情里的 post.post_id 或 post.share_url。不要传视频 BV 号、aid、cv 专栏 ID、链接或分享文案。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "Bilibili 专栏/动态赞与转发列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一专栏/动态的同一 post_id 或同一 url 赞与转发分页链路；继续翻页时必须使用同一个入口，by_post_id 返回的 token 只能继续传给 by_post_id，by_url 返回的 token 只能继续传给 by_url；不能跨能力或内容复用。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Bilibili 专栏/动态链接、移动端链接、t.bilibili.com 动态链接、b23.tv 短链接或包含链接的分享文案；支持 /opus/{id}、/dynamic/{id}、t.bilibili.com/{id}、t.bilibili.com/h5/dynamic/detail/{id} 等同一专栏/动态的常见 B 站链接形态。从专栏搜索结果出发时，先获取详情，再使用详情里的 post.share_url 或 post.post_id。不要传视频链接、其他链接或用户主页链接。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "Bilibili 专栏/动态赞与转发列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一专栏/动态的同一 post_id 或同一 url 赞与转发分页链路；继续翻页时必须使用同一个入口，by_post_id 返回的 token 只能继续传给 by_post_id，by_url 返回的 token 只能继续传给 by_url；不能跨能力或内容复用。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "profile_url"
  ],
  "properties": {
    "profile_url": {
      "type": "string",
      "description": "B 站用户主页链接、短链接或分享文案；不要传 user_id，不要传视频链接、BV 号或 aid；已有 user_id 时使用 by_user_id 工具。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "user_id"
  ],
  "properties": {
    "user_id": {
      "type": "string",
      "description": "B 站用户 user_id，通常是 space.bilibili.com/{user_id} 路径里的数字 ID；可从搜索、详情、评论或用户资料结果中的 author.user_id 或 user_id 复制；不要传用户主页链接，不要传视频链接、昵称、BV 号或 aid。已有用户主页链接时使用 by_profile_url 工具。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "profile_url"
  ],
  "properties": {
    "page_token": {
      "type": "string",
      "default": "",
      "description": "Bilibili 用户发布单篇专栏分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户的单篇专栏列表分页链路，不能跨能力或用户复用。"
    },
    "profile_url": {
      "type": "string",
      "description": "B 站用户主页链接、短链接或分享文案；不要传 user_id，不要传视频链接、BV 号或 aid；已有 user_id 时使用 by_user_id 工具。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "user_id"
  ],
  "properties": {
    "user_id": {
      "type": "string",
      "description": "B 站用户 user_id，通常是 space.bilibili.com/{user_id} 路径里的数字 ID；可从搜索、详情、评论或用户资料结果中的 author.user_id 或 user_id 复制；不要传用户主页链接，不要传视频链接、昵称、BV 号或 aid。已有用户主页链接时使用 by_profile_url 工具。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "Bilibili 用户发布单篇专栏分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户的单篇专栏列表分页链路，不能跨能力或用户复用。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "profile_url"
  ],
  "properties": {
    "page_token": {
      "type": "string",
      "default": "",
      "description": "Bilibili 用户发布动态分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户的动态列表分页链路，不能跨能力或用户复用。"
    },
    "profile_url": {
      "type": "string",
      "description": "B 站用户主页链接、短链接或分享文案；不要传 user_id，不要传视频链接、BV 号或 aid；已有 user_id 时使用 by_user_id 工具。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "user_id"
  ],
  "properties": {
    "user_id": {
      "type": "string",
      "description": "B 站用户 user_id，通常是 space.bilibili.com/{user_id} 路径里的数字 ID；可从搜索、详情、评论或用户资料结果中的 author.user_id 或 user_id 复制；不要传用户主页链接，不要传视频链接、昵称、BV 号或 aid。已有用户主页链接时使用 by_profile_url 工具。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "Bilibili 用户发布动态分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户的动态列表分页链路，不能跨能力或用户复用。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "profile_url"
  ],
  "properties": {
    "sort_type": {
      "enum": [
        "time_descending",
        "view_count_descending",
        "collect_count_descending"
      ],
      "type": "string",
      "default": "time_descending",
      "description": "用户发布视频排序方式：time_descending=最新发布，view_count_descending=最多播放，collect_count_descending=最多收藏。默认 time_descending。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "Bilibili 用户发布视频列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户和同一排序方式的视频列表分页链路，不能跨能力、用户或排序复用。"
    },
    "profile_url": {
      "type": "string",
      "description": "B 站用户主页链接、短链接或分享文案；不要传 user_id，不要传视频链接、BV 号或 aid；已有 user_id 时使用 by_user_id 工具。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "user_id"
  ],
  "properties": {
    "user_id": {
      "type": "string",
      "description": "B 站用户 user_id，通常是 space.bilibili.com/{user_id} 路径里的数字 ID；可从搜索、详情、评论或用户资料结果中的 author.user_id 或 user_id 复制；不要传用户主页链接，不要传视频链接、昵称、BV 号或 aid。已有用户主页链接时使用 by_profile_url 工具。"
    },
    "sort_type": {
      "enum": [
        "time_descending",
        "view_count_descending",
        "collect_count_descending"
      ],
      "type": "string",
      "default": "time_descending",
      "description": "用户发布视频排序方式：time_descending=最新发布，view_count_descending=最多播放，collect_count_descending=最多收藏。默认 time_descending。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "Bilibili 用户发布视频列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户和同一排序方式的视频列表分页链路，不能跨能力、用户或排序复用。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Bilibili 视频链接、短链接或包含视频链接的分享文案；用于获取本地 CLI 下载和 ffmpeg 合并所需的视频下载地址 manifest；多 P 视频链接会按 URL 中的 p 参数选择对应分 P；不要传用户主页链接、专栏/动态链接、BV 号或 aid。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "口播转文字任务 ID；用户已提供时直接使用，否则使用 bilibili_submit_video_speech_text_by_video_url 或 bilibili_submit_video_speech_text_by_bvid 返回的 job_id；不要传 BV 号、aid 或视频链接。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "description": "搜索 Bilibili 专栏文章的搜索词，可传关键词或短语，例如品牌名、话题、人物名或产品名；不要传视频链接、专栏/动态链接、用户主页链接、BV 号、aid、专栏/动态 ID 或 page_token。"
    },
    "category": {
      "enum": [
        "all",
        "animation",
        "gaming",
        "film_and_tv",
        "lifestyle",
        "hobbies",
        "light_novel",
        "technology",
        "notes"
      ],
      "type": "string",
      "default": "all",
      "description": "专栏分区筛选：all=全部分区，animation=动画，gaming=游戏，film_and_tv=影视，lifestyle=生活，hobbies=兴趣，light_novel=轻小说，technology=科技，notes=笔记。"
    },
    "sort_type": {
      "enum": [
        "general",
        "time_descending",
        "view_count_descending",
        "like_count_descending",
        "comment_count_descending"
      ],
      "type": "string",
      "default": "general",
      "description": "专栏排序方式：general=综合排序，time_descending=最新发布，view_count_descending=最多点击/阅读，like_count_descending=最多喜欢，comment_count_descending=最多评论。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "Bilibili 专栏搜索分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一关键词、排序方式和分区筛选的专栏搜索链路，不能跨能力、关键词或筛选条件复用。消费多页搜索结果时，建议按 content_id 作为稳定键合并结果。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "description": "搜索关键词或短语；不要传链接、用户 ID 或 page_token。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "description": "用户搜索关键词或短语，例如账号名；不要传主页链接、用户 ID 或 page_token。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "首页留空；后续原样传入同一关键词用户搜索返回的 next_page_token，不可跨能力使用。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "bvid"
  ],
  "properties": {
    "bvid": {
      "type": "string",
      "description": "Bilibili 视频 BV 号（BV...）；用于转写视频 P1；如需转写 P2 或后续分 P，请改用 by_video_url 工具并在 URL 中传 p 参数；不要传视频链接、aid 或用户主页链接。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "video_url"
  ],
  "properties": {
    "video_url": {
      "type": "string",
      "description": "Bilibili 视频链接、b23.tv 短链接或包含视频链接的分享文案；多 P 视频可在普通视频 URL 中使用 p 参数选择一个分 P，例如 ?p=2；普通视频链接未传 p 时转写 P1，短链接按解析后的目标分 P 转写；每次只转写一个分 P；不要传 BV 号或用户主页链接。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}