跳转至

B 站

B 站的公开接口直连就能用，不经中转、不用 key，只有视频直链靠下载狗。请求都带仿浏览器的 User-Agent 和 Referer: https://www.bilibili.com/。

脚本

python3 scripts/bilibili.py <链接或整段分享文案>... --out <目录> [--parts 1,3-5] [--comments]
  • bilibili.py 就是下面这套：视频、图文动态、b23.tv 短链都认
  • --parts：只取这几P，默认全取。多P的长课先 --no-video 跑一次看分P，再挑
  • --comments：取评论和楼中楼，对这次传入的所有链接都生效，只要其中几条的评论就分两次跑
  • 每P视频 0.005 元，元数据、字幕、评论、图文不花钱
  • 字幕要登录才给时 warnings 会提示，改走阅读视频转写
  • 文件夹格式、共用参数和续跑见解析分享链接
  • b23.tv 短链：App 分享出来的短链不带 BV 号，也不带图文 ID；先跟一次跳转，读 Location 头拿到完整链接
  • BV 号：链接里 BV 开头的 12 位；图文、动态的 ID 在 /opus/<数字>、/dynamic/<数字> 或 t.bilibili.com/<数字>

底层：视频

元数据和分P

https://api.bilibili.com/x/web-interface/view?bvid=<BV号>

  • code 为 0 才算成功，内容在 data
  • title、desc 是标题和简介；owner.name 是 UP 主；pubdate 是秒级时间戳；duration 是总秒数；pic 是封面
  • stat 里 like、favorite、reply、share、view、coin、danmaku 是赞、藏、评、转、播放、投币、弹幕
  • aid 是评论接口要的 oid
  • pages[] 每P一条：page、cid、part（分P标题）、duration

字幕

https://api.bilibili.com/x/player/v2?bvid=<BV号>&cid=<这一P的 cid>

  • 字幕轨在 data.subtitle.subtitles[]，subtitle_url 指向一个 JSON，body[] 每条有 from、to（秒）和 content
  • 多半要登录才给：need_login_subtitle 为真、字幕轨为空，就是只给登录用户；只列出 ai-zh、subtitle_url 为空，是 AI 字幕要登录才给地址。2026-10-17 试了 7 个视频，匿名一条字幕都没拿到。本站不走登录态，拿不到就改走转录音频

视频

  • 每P单独交给下载狗：第 1 P 传 https://www.bilibili.com/video/<BV号>/，其余加 ?p=<N>。每P扣一次额度
  • videoUrls 多半是一个字符串，有时是数组（取第一个），是音视频合一的 mp4；直链路径里带这一P的 cid，可以核对没拿错P
  • 下载时带 Referer: https://www.bilibili.com/

评论

用 WBI 签名的主评论接口，不签名的 /x/v2/reply?type=1&oid=… 报出完整评论数，却只返回几条置顶、热门的：

https://api.bilibili.com/x/v2/reply/wbi/main
  ?type=1&oid=<aid>&mode=3&next=<游标>&ps=20&web_location=1315875&wts=<秒级时间戳>&w_rid=<签名>
  • 签名：先请求 https://api.bilibili.com/x/web-interface/nav，没登录会回 code -101，但 data.wbi_img 里的 img_url、sub_url 照样给。两个文件名（不含扩展名）拼起来，按下面的置换表取字符、截前 32 位，得到 mixin key。参数加上 wts，按键名排序，值里去掉 !'()*，URL 编码后接上 mixin key，取 MD5 就是 w_rid
  • 置换表：[46,47,18,2,53,8,23,32,15,50,10,31,58,3,45,35,27,43,5,49,33,9,42,19,29,28,14,39,12,38,41,13,37,48,7,16,24,55,40,61,26,17,0,1,60,51,30,4,22,25,54,21,56,59,6,63,57,62,11,36,20,34,44,52]
  • 翻页：data.cursor.is_end 为真就停，否则把 cursor.next 当下一次的 next。主评论在 data.replies，置顶在 data.top_replies 和 data.top
  • 楼中楼：https://api.bilibili.com/x/v2/reply/reply?type=1&oid=<aid>&root=<主评论 rpid>&pn=<页码>&ps=20，不用签名；主评论的 rcount 是楼中楼条数

底层：图文动态

读公开页面 https://www.bilibili.com/opus/<ID> 里的 window.__INITIAL_STATE__= 后面那个 JSON 对象，不走 polymer 动态接口：/x/polymer/web-dynamic/v1/detail?id=<ID> 匿名调常回 -352 风控，页面里却有完整正文。

  • 内容在 detail.modules[]，按 module_type 取：MODULE_TYPE_TITLE 标题、MODULE_TYPE_AUTHOR 作者（name、mid、pub_ts）、MODULE_TYPE_CONTENT 正文、MODULE_TYPE_STAT 统计（like、favorite、comment、forward、coin 下面各有 count）
  • 正文在 module_content.paragraphs[]，按 para_type 分：1 文字、2 图片（pic.pics[].url）、5 列表（list.children[]，list.style 为 1 是有序）、6 链接卡片、7 代码块（code.lang、code.content）、8 标题（heading.level）。文字都在 nodes[].word.words 或 nodes[].rich.text 里
  • 评论：不能拿图文 ID 当 oid、type=1。用 detail.basic.comment_type 当 type，detail.basic.comment_id_str 当 oid，接口同上；见过的一条是 type=12
  • 图片下载带 B 站 Referer