跳到导航

用Python找B站同类教程、读评论,整理下一轮内容怎么改

想知道同类 B 站教程怎样组织步骤、观众在哪里卡住,就运行 Python 脚本 bili_read.py:用 bilibili.web.fetch_general_search 保存一页搜索结果,人工挑出内容合适的视频,用 bilibili.app.fetch_video_comments 读每条入选视频的评论,再把发现写成下一轮课程改进清单。

bili_read.py 只用 Python 3 标准库,每次运行发一次请求。已有准确 BV 号时直接从读评论开始;已有保存的原始响应时直接复用。

1. 选范围与准备环境

  1. 在本地环境配置 BEATAPI_API_KEY。
  2. 计划先取一页搜索,再选 2–3 条与课程主题和软件版本相符的视频,每条读一页评论。三条入选视频最多对应 4 次查询,每次按价格页上该动作的现价计费。

搜索请求按播放最多 order: click 排序,方便发现候选。是否入选按视频与课程的相关性判断,不按播放数。

2. 保存一次请求与结果

把下面的脚本保存为 bili_read.py。search 模式调用 bilibili.web.fetch_general_search,comments 模式调用 bilibili.app.fetch_video_comments。每次运行输出到一个新目录,保存请求和原始响应。

import json
import os
import sys
from datetime import datetime, timezone
from pathlib import Path
from urllib.error import HTTPError, URLError
from urllib.request import Request, urlopen
if len(sys.argv) != 4 or sys.argv[1] not in {"search", "comments"}:
raise SystemExit("Usage: python3 bili_read.py search|comments VALUE NEW_DIRECTORY")
mode, value, directory = sys.argv[1:]
if not value.strip():
raise SystemExit("Supply a keyword or a verified BV ID")
key = os.environ.get("BEATAPI_API_KEY")
if not key:
raise SystemExit("Set BEATAPI_API_KEY in your local environment")
if mode == "search":
action = "bilibili.web.fetch_general_search"
params = {"keyword": value, "order": "click", "page": 1, "page_size": 20}
else:
action = "bilibili.app.fetch_video_comments"
params = {"bv_id": value, "mode": 3, "next_offset": 1}
body = {"action": action, "params": params}
out = Path(directory)
out.mkdir(parents=True, exist_ok=False)
(out / "request.json").write_text(json.dumps(body, ensure_ascii=False, indent=2), encoding="utf-8")
started = datetime.now(timezone.utc).isoformat()
(out / "attempt.json").write_text(json.dumps({"started_at": started, "action": action}), encoding="utf-8")
request = Request("https://api.beatapi.io/v1/social-data/call",
data=json.dumps(body).encode("utf-8"), method="POST",
headers={"Authorization": "Bearer " + key, "Content-Type": "application/json"})
try:
with urlopen(request, timeout=60) as response:
status, raw = response.status, response.read()
except HTTPError as error:
status, raw = error.code, error.read()
except URLError:
(out / "transport-error.json").write_text(json.dumps({"outcome": "unknown", "action": action}), encoding="utf-8")
raise SystemExit("No final response saved; review the attempted request before repeating")
(out / "response.json").write_bytes(raw)
(out / "call.json").write_text(json.dumps({"action": action, "params": params,
"http_status": status, "started_at": started,
"finished_at": datetime.now(timezone.utc).isoformat(),
"response_file": "response.json", "platform_review": "required"},
ensure_ascii=False, indent=2), encoding="utf-8")
try:
payload = json.loads(raw)
except (ValueError, UnicodeError):
raise SystemExit("Saved a non-JSON response; inspect response.json")
if status != 200 or not isinstance(payload, dict) or payload.get("status") != "succeeded" or payload.get("error") is not None or payload.get("action") != action:
raise SystemExit("Saved a failed or unexpected response; inspect response.json")
print("Saved response for platform-content review: " + str(out / "response.json"))

先取一页候选:

python3 bili_read.py search '剪辑教程' bili-search-01

输出目录里有 request.json、attempt.json、call.json 和 response.json。bili_read.py 核对公共执行信封,并在 call.json 里标 platform_review: required,平台内容仍由你按实际材料审阅。HTTP 返回原样保存;网络中断、没有最终响应时,脚本把这次尝试记到 transport-error.json,不自动重试。

3. 人工选出值得研究的视频

  1. 读结果。 在 response.json 里核对每条搜索结果的标题、UP 主、视频对象与主题。
  2. 挑选。 留下有具体步骤、示范或评论讨论的视频;软件版本不同、只有宣传片或无关同名的视频,记录排除理由。
  3. 记录。 每条入选视频保存已确认的 BV 号、来源、选择理由和查询时间。播放数等信息按实际返回照录,缺失值留空,也不用另一个平台的点赞或收藏数代替。

搜索的 order 参数支持 totalrank(综合)、click(播放)、pubdate(最新)、dm(弹幕)、stow(收藏)。想找新版本教程时另跑一次 pubdate 搜索,两轮条件分别保存;不要把两种结果当同一次观察。

4. 读取选中视频的评论

传入已确认的 BV 号和一个新目录:

python3 bili_read.py comments '<confirmed_bv_id>' bili-comments-01

comments 模式按 App 评论热门排序 mode: 3 请求首页 next_offset: 1。要读新反馈,把 mode 改为时间排序 2,见评论排序。每次运行只取首批,不自动翻页,也不切换排序。

先读评论里的具体问题,再按需要补回复。比如“找不到菜单”需要版本背景,“这一步没声音”可能需要素材与轨道说明。回复的父子关系与视频来源一并保留,见评论交付表。

5. 做成下一轮课程改进清单

工作表可以按这几项读:

项目怎样落实
值得参考的讲法具体视频、步骤或表达,以及为何帮助理解
学习疑问评论原句、使用条件、所属视频及必要回复
已有解释哪段视频或回复已回答,保留来源
待改内容补版本说明、增加示范、补练习,或先核对条件
范围实际读过的视频、评论页和未完成项

比如“先说明前置条件再演示”是可用于自己课程的结构参考;具体步骤是否适用,要对照自己的软件版本与练习目标。不要只统计热词或直接照搬别人标题。

整理好后,按评论表的 CSV 示例把评论原句和课程待办分别导出。一条待办可以引用多条原句,也可以注明已有哪段课程解释过。交给同事前,先挑一条待办,沿引用回查评论原句和视频,确认依据找得到。

给助手可以这样说:

复用这些搜索与评论原件,挑与我们的剪辑课同版本、同任务的视频。记录讲解结构和观众原句,每个改进建议附来源与理由,列出需要补读的上下文。区分参考做法、待核问题和可以直接更新的说明。

先处理首批发现,再按缺口安排更多视频或评论页。bili_read.py 每次只运行一次;需要定期运行、存储和通知时,在自己的任务环境里配置。

评论表到答疑 · BV/AV定位