你刚看完一位 UP 主讲木工的某一期视频，想从第一课开始学，却发现主页里夹着日常记录和不同系列。需要的不是再搜一次同样的标题，而是一份属于这个作者、能按学习需要阅读的作品目录。

先确定账号身份，再取作品

可通过分类搜索按文档选择 search_type 找线索，再核对账号主页与 uid。相近名字和搬运内容容易混淆，确认作者之后才查用户资料和作品列表。不要把不同作者的相同标题自动合成一个系列，也不要因为搜索结果排序靠前就跳过核对。

分页记录实际取到的范围

作品列表按 pn、ps 等参数读取，必要时使用 keyword 限定作者范围内的内容。保留每次查询的条件和已取得的作品标识，合并分页时去重。列表总数不代表本次取得的数量，更不保证你已经拥有完整历史。如果只看了近期几页，目录说明里直接写明范围。

系列顺序需要从内容确认

对相关作品取详情或打开原视频，检查是否有明确期数、前置课程和作者给出的观看顺序。自己设计目录栏位：来源、系列名称、作者标注期数、建议先学什么、观看状态。没有明确系列关系的作品放入独立参考，不要凭标题相似硬补缺失的一期。

更新目录时保留自己的学习进度

新一轮获取后只添加首次见到的条目，对重复作品更新查询备注，不覆盖已经写好的练习记录。某条旧作品没有返回时，暂记本轮未见，不直接移除你的学习卡。AI 可协助分类已有标题与笔记，但不能替作者编课程体系。最后的目录应帮你判断下一条看什么、为什么先看它；它不是全部作品已下载的证明，也不自动替你播放、订阅或完成学习任务。

这篇用到的接口

完整地址与参数

GET https://api.trmesh.com/openapi/api/v1/bilibili/app/fetch_search_by_type

参数 类型 必填 含义
keyword string 是 搜索关键词
search_type string 否 搜索类型
cursor string 否 翻页游标，首页留空；翻页时传回上一页响应的 data.pagination.next
page_size integer 否 每页数量
order integer 否 排序方式

可以复制的 Python 请求

安装 requests 并在环境变量中设置 TRMESH_API_TOKEN。把示例用户名或作品 ID 换成你要查询的对象。

import os
import requests

# 使用自己的 TRMesh 开发者密钥；不要将密钥写入网页。
url = "https://api.trmesh.com/openapi/api/v1/bilibili/app/fetch_search_by_type"
params = {
    "keyword": "原神"
}
response = requests.get(
    url, params=params, timeout=30,
    headers={"Authorization": f"Bearer {os.environ['TRMESH_API_TOKEN']}"},
)
response.raise_for_status()
payload = response.json()
print(payload)  # 先核对真实响应，再提取业务字段

对应接口文档 · 返回免费查询工具

调用接口会使用你的 TRMesh 账号额度，运行前请确认接口价格。