Lanerc Desktop 片源接入 API 文档

版本：v1.0 · 更新日期：2026-11-15
适用程序：Lanerc Desktop（Python + PyQt6 桌面客户端）

⚠️ 重要声明：本文档及配套代码仅供学习、交流、技术研究使用。

1. 本项目不提供、不存储、不传播任何影视资源，仅演示客户端如何解析第三方公开采集接口。
2. 文档中出现的接口均为第三方站点公开提供的采集接口，其内容版权归原权利人所有。
3. 严禁将本文档或相关代码用于商业用途、付费分发、盗链、批量抓取或任何侵犯版权的行为。
4. 请在下载/测试后 24 小时内删除相关数据与代码，遵守所在地法律法规及目标站点的服务条款。
5. 使用本项目造成的任何法律、账号或数据风险，由使用者自行承担。

1. 架构总览

客户端把「数据源」抽象成统一接口，同一套 UI 可以切换不同片源：

统一接口契约（三种客户端均实现）：

1
2
3
4
5
6
7
8
9
10
11
12

config() -> dict
home() -> {"banners": [Vod], "sections": [(title, [Vod])], "total": int}
search(keyword, page=1) -> {"items": [Vod], "has_more": bool, "total": int}
filter_vods(type_name="", page=1) -> {"items": [Vod], "has_more": bool}
rank(page=1) -> {"items": [Vod], "has_more": bool}
week() -> {"days": {day: [Vod]}, "order": [day]}
detail(vod_id) -> Vod
play(vod_id, video_id) -> {"url", "play_url", "video_id", "line", "source", "player", "err"}
comments(video_id, page=1) -> [{"user", "text", "time", "likes"}]
login(account, password) -> dict
logout() -> None
user_info() -> dict

归一化模型：

2. 苹果CMS（MacCMS v10）采集接口

这是当前默认且实测可用的数据源。

2.1 请求约定

• 请求方法：GET
• 接口地址：{base}/api.php/provide/vod/（部分站点为 /provide/vod/）
• 返回格式：application/json（个别站点 content-type 标成 text/html，但正文仍是 JSON）
• 建议请求头：

1
2

User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 ...
Accept: application/json, text/plain, */*

2.2 通用查询参数

2.3 响应包络

1
2
3
4
5
6
7
8
9

{
  "code": 1,
  "msg": "数据列表",
  "page": 1,
  "pagecount": 8197,
  "limit": "20",
  "total": 163936,
  "list": []
}

2.4 剧集字段（list 元素）

2.5 分类列表

1

GET {base}?ac=list&pg=1

响应额外包含 class 数组：

1
2
3
4
5
6
7
8
9

{
  "code": 1,
  "class": [
    {"type_id": 39, "type_pid": 0, "type_name": "动漫片"},
    {"type_id": 41, "type_pid": 39, "type_name": "日韩动漫"},
    {"type_id": 40, "type_pid": 39, "type_name": "国产动漫"},
    {"type_id": 42, "type_pid": 39, "type_name": "欧美动漫"}
  ]
}

客户端会缓存分类，并按以下优先级挑选动漫分类作为首页/榜单/时间表的默认范围：

1

日韩动漫 → 国产动漫 → 欧美动漫 → 港台动漫 → 海外动漫 → 动画片 → 动漫

若站点没有动漫分类，则自动回退到全站最新数据。

2.6 列表、搜索、分页

1
2
3
4
5
6
7
8

# 最新番剧（指定动漫分类）
GET {base}?ac=detail&pg=1&t=41

# 关键词搜索
GET {base}?ac=detail&pg=1&wd=火影

# 按评分/热度
GET {base}?ac=detail&pg=1&t=41&by=hits&order=desc

判定是否还有下一页：

1

has_more = page < pagecount

2.7 详情与播放地址格式

1

GET {base}?ac=detail&ids=165238

vod_play_url 是紧凑编码的剧集列表：

1

第01集$https://cdn.example.com/a/0001/index.m3u8#第02集$https://cdn.example.com/a/0002/index.m3u8

规则：

解析伪代码：

1
2
3
4

for group in vod_play_url.split("$$$"):
    for part in group.split("#"):
        name, url = part.split("$", 1)
        episodes.append(Episode(video_id=url, name=name, url=url))

• 优先选择线路名包含 m3u8 的线路；
• 无集名时自动补「第 N 集」；
• 非 http(s) 开头的条目会被丢弃；
• vod_play_url 为空时，详情页仍可浏览，但「选集」为空，播放会提示无可用剧集。

2.8 播放地址解析

play() 会按顺序尝试把剧集地址变为可直连的视频流：

1. 地址包含 .m3u8 或 .mp4 → 直接返回；
2. 地址的 query 中有 url= / src= / play= / m3u8= 参数 → 解码后若是媒体直链则返回；
3. 地址是播放网页 → 拉取 HTML，正则匹配第一个 https?://...m3u8...；
4. 全部失败 → 抛出「该剧集的地址不是可直连的视频流，无法内置播放」。

实测：多数采集接口直接提供 m3u8，无需第 3 步；若目标站点启用了防盗链、IP 限制或签名过期，播放会失败，属于源站行为，与本客户端无关。

2.9 客户端页面映射

2.10 已适配的公开片源

以下地址在 2026-11-15 实测可返回 JSON，且首个剧集的 m3u8 可下载到分片：

这些是第三方站点，可用性、内容与合规性均不受本项目控制。接口随时可能失效、更换域名或开启鉴权。

2.11 curl 示例

1
2
3
4
5
6
7
8
9
10
11

# 分类
curl "https://bfzyapi.com/api.php/provide/vod/?ac=list&pg=1"

# 日韩动漫第一页
curl "https://bfzyapi.com/api.php/provide/vod/?ac=detail&pg=1&t=41"

# 搜索
curl "https://bfzyapi.com/api.php/provide/vod/?ac=detail&wd=火影&pg=1"

# 详情（含播放地址）
curl "https://bfzyapi.com/api.php/provide/vod/?ac=detail&ids=165238"

3. Lanerc 官方接口（可选数据源）

状态：域名引导已下线，当前 api.lanerc.app 等地址均返回 404，以下内容仅来自静态逆向资料，不可直接用于生产。仅作为协议结构参考。

3.1 公共请求头

3.2 签名（占位实现）

1
2

raw  = f"{path}|{timestamp}|{device_id}"
sign = HMAC-SHA256(secret, raw).hexdigest()

真实算法未确认，客户端把 secret 做成可配置项；确认后只需替换 _make_sign。

3.3 端点一览（客户端已实现）

3.4 响应约定

1

{"code": 0, "success": true, "message": "ok", "data": {}}

客户端逻辑：

• success === false 或 code 不在 0 / 200 / None / "" 中 → 视为业务错误；
• 优先取 data，其次 result；
• 401 且存在 refresh_token 时自动刷新一次后重试。

4. 错误处理

5. 数据、缓存与隐私

• 数据目录按优先级选择：LANERC_DATA_DIR 环境变量 → E:/LanercPC → D:/LanercPC → F:/LanercPC → 程序目录 data；
• 配置、历史、收藏均为本地 JSON，不上传任何服务器；
• 封面图片缓存在 {数据目录}/cache/images；
• 图片请求的 Referer 自动设为图片所在域名，以兼容常见防盗链；
• 客户端不采集、不上报任何用户行为数据。

6. 合规使用建议

• 仅用于本地技术验证，不要公开部署或分发；
• 不要绕过付费、登录、地区限制等访问控制；
• 不要对第三方接口进行高频轮询或批量抓取；
• 若你拥有相关内容的版权或授权，请优先使用官方渠道；
• 如相关权利人提出异议，请立即停止使用并删除所有副本。

再次声明：本文档仅供学习、交流、研究使用，禁止任何形式的商业使用与资源传播。
文档中涉及的第三方接口、商标、影视内容版权均归其各自权利人所有。