> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 用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 次查询，每次按[价格页](https://beatapi.io/zh/pricing)上该动作的现价计费。

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

## 2. 保存一次请求与结果

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

```python
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"))
```

先取一页候选：

```bash
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 号和一个新目录：

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

`comments` 模式按 App 评论热门排序 `mode: 3` 请求首页 `next_offset: 1`。要读新反馈，把 `mode` 改为时间排序 2，见[评论排序](/zh/faq/bilibili-comment-order)。每次运行只取首批，不自动翻页，也不切换排序。

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

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

工作表可以按这几项读：

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

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

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

给助手可以这样说：

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

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

[评论表到答疑](/zh/faq/bilibili-comment-export) · [BV/AV定位](/zh/faq/bilibili-bv-comments)