diff --git a/.env.example b/.env.example index 980418d..776ed35 100644 --- a/.env.example +++ b/.env.example @@ -38,12 +38,7 @@ XHS_COOKIE='' # 日常 99%+ 的普通短视频、图文笔记、LivePhoto、原声音乐等完全免 Cookie 匿名直出。 DOUYIN_COOKIE='' -# 5. 哔哩哔哩高码率 (可选,用于提取 1080P 高码率/4K 及大会员专享番剧正片) -# 精简格式至少包含 `SESSDATA=xxx; bili_jct=yyy`。 -# 未配置时仍可完全免登录获取 720P/1080P 官方基础音视频流。 -BILIBILI_COOKIE='' - -# 6. 拼多多多多视频 (可选,用于多多视频短视频信息流原画解析) +# 5. 拼多多多多视频 (可选,用于多多视频短视频信息流原画解析) # 登录 mobile.yangkeduo.com 移动端后获取,精简格式至少包含 `PDDAccessToken=xxx`。 # 未配置时仍可免 Cookie 解析商品图集与评价秀实物素材。 PINDUODUO_COOKIE='' diff --git a/README.md b/README.md index b007fea..dfecb32 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,7 @@
核心特性 •
支持平台 •
+项目原则 •
部署指南 •
API 接口 •
测试自检 •
@@ -47,7 +48,7 @@ Media-Parser是一款专为短视频创作者与开发者打造的**100%原生
| **哔哩哔哩** | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | | | [查看](docs/parsers/bilibili.md) |
| **豆包** | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | ✓ | | [查看](docs/parsers/doubao.md) |
| **即梦AI** | ✓ | ✓ | ✓ | ✓ | ✓* | ✓ | ✓ | | | | [查看](docs/parsers/jimeng.md) |
-| **小云雀AI** | ✓ | ✓ | ✓ | ✓ | ✓* | ✓ | | | | | [查看](docs/parsers/xiaoyunque.md) |
+| **小云雀AI** | ✓ | ✓ | ✓ | ✓* | ✓* | ✓ | | | | | [查看](docs/parsers/xiaoyunque.md) |
| **可灵AI** | ✓ | ✓ | | ✓ | ✓ | | | | | | [查看](docs/parsers/kling.md) |
| **海螺AI** | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | | | | [查看](docs/parsers/hailuo.md) |
| **夸克AI** | ✓ | ✓ | | ✓ | ✓ | ✓ | | | | | [查看](docs/parsers/quark-ai.md) |
@@ -90,7 +91,7 @@ Media-Parser是一款专为短视频创作者与开发者打造的**100%原生
| **央视** | ✓ | ✓ | | ✓ | ✓ | | | | | | [查看](docs/parsers/cctv.md) |
| **央视频** | ✓ | ✓ | | ✓ | ✓ | ✓ | | | | | [查看](docs/parsers/yangshipin.md) |
-注:带 `*` 的项表示支持提取官方最高画质直链,但受平台生成或导出机制限制,该素材目前仍保留官方原生水印;未带 `*` 的项均为无水印素材。
+说明:带 `*` 的项表示该素材目前仍保留官方原生水印,未带 `*` 的项均为无水印素材。
---
@@ -113,9 +114,7 @@ cp .env.example .env
* 用于解决小红书网页端针对服务器机房 IP 匿名抓取可能遭遇的 302 登录拦截。推荐精简 Cookie 配置 `a1=xxx; webId=xxx; web_session=xxx`。日常默认无需 Cookie 即可直接匿名解析。
4. **抖音放映厅长视频 (`DOUYIN_COOKIE`)**:
* 仅在解析放映厅/影视长片/演唱会大片等强风控内容时才需要配置。推荐精简 Cookie 配置 `s_v_web_id=xxx; __ac_nonce=xxx`,该字段仅为字节安全 SDK 的人机风控通行证。日常 99%+ 的普通短视频、图文笔记、LivePhoto、原声音乐等完全免 Cookie 匿名解析。
-5. **哔哩哔哩高码率 (`BILIBILI_COOKIE`)**:
- * 用于提取 1080P 高码率/4K 及大会员专享番剧正片。推荐精简 Cookie 配置 `SESSDATA=xxx; bili_jct=yyy;`。未配置时仍可完全免登录获取 720P/1080P 官方基础流与音频。
-6. **拼多多多多视频 (`PINDUODUO_COOKIE`)**:
+5. **拼多多多多视频 (`PINDUODUO_COOKIE`)**:
* 用于解析多多视频(短视频)原画。登录 `mobile.yangkeduo.com`(拼多多移动端)后获取,推荐精简 Cookie 配置 `PDDAccessToken=xxx`。未配置时仍可免 Cookie 解析商品图集与评价秀素材。
### Docker 部署(推荐)
@@ -269,9 +268,17 @@ python3 tests/manual_verify_parsers.py --platform "小云雀AI"
---
-## ⚖️ 开源协议 & 免责声明
+## 🛡️ 项目原则与免责声明
-1. 本项目基于 **[MIT LICENSE](LICENSE)** 协议开源。
-2. **免责声明**:本项目所有代码和文档仅用于网络技术研究、接口逆向工程学习与防御性安全交流。使用者请遵守各目标平台的《用户服务协议》与相关法律法规,不得用于任何形式的商业盈利抓取或恶意攻击行为。因使用本工具造成的任何直接或间接法律责任由使用者自行承担。
+### 1. 核心设计原则与边界红线
+本项目定位为**短视频创作者素材辅助工具与底层网络协议研究**,严格恪守以下原则与红线:
+* **仅限公开 UGC 内容**:仅解析普通用户公开发布的短视频、图集素材,**不支持**任何私密、好友可见等未公开内容。
+* **拒绝 VIP / 付费破解**:**不解析**任何会员专享、单点付费、付费短剧等收费内容;系统不依赖亦不索取任何付费/VIP Cookie。
+* **不支持版权长视频**:专注于短视频生态,**坚决不做**任何爱优腾芒、Netflix、电影、电视剧等长视频版权内容的嗅探与破解。
+* **纯粹协议逆向,无破坏性**:不破坏 DRM 加密流,不从事任何黑产或恶意绕过行为。如遇平台接口调整或合规要求,将主动调整或下线对应解析模块。
+
+### 2. 开源协议 & 法律合规
+* 本项目基于 **[MIT LICENSE](LICENSE)** 协议开源。
+* **免责声明**:本项目所有代码和文档仅用于网络技术研究、接口逆向工程学习与防御性安全交流。使用者请遵守各目标平台的《用户服务协议》与相关法律法规,不得用于任何形式的商业侵权抓取或恶意攻击行为。因使用本工具造成的任何直接或间接法律责任由使用者自行承担。
---
diff --git a/docker-compose.yml b/docker-compose.yml
index f11dd06..98b055e 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -29,4 +29,3 @@ services:
- DOUBAO_COOKIE=${DOUBAO_COOKIE:-}
- YUANBAO_COOKIE=${YUANBAO_COOKIE:-}
- PINDUODUO_COOKIE=${PINDUODUO_COOKIE:-}
- - BILIBILI_COOKIE=${BILIBILI_COOKIE:-}
diff --git a/docs/index.md b/docs/index.md
index 71e48b5..cc456ba 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -112,10 +112,7 @@ XHS_COOKIE="a1=xxx; webId=yyy; web_session=zzz;"
# 4. 抖音放映厅长视频 (可选,仅在解析 /lvdetail/ 长片时需要)
DOUYIN_COOKIE="s_v_web_id=verify_xxx; __ac_nonce=xxx;"
-# 5. 哔哩哔哩高码率 (可选,用于提取 1080P+ 高码率/4K 及大会员专区番剧)
-BILIBILI_COOKIE="SESSDATA=xxx; bili_jct=yyy;"
-
-# 6. 拼多多多多视频 (可选,用于多多短视频信息流原画解析)
+# 5. 拼多多多多视频 (可选,用于多多短视频信息流原画解析)
PINDUODUO_COOKIE="PDDAccessToken=xxx;"
```
diff --git a/docs/parsers/bilibili.md b/docs/parsers/bilibili.md
index 08479e9..040dcfb 100644
--- a/docs/parsers/bilibili.md
+++ b/docs/parsers/bilibili.md
@@ -18,8 +18,7 @@
* 番剧/剧集长链:`https://www.bilibili.com/bangumi/play/ep1231565`、`https://www.bilibili.com/bangumi/play/ss12345`
* 动态/Opus 链接:`https://t.bilibili.com/1245189054385881096` 或 `https://www.bilibili.com/opus/1245189054385881096`
* **Cookie 依赖**:
- * **公开视频基础流**:**无需 Cookie**(默认获取 720P/1080P HTML5 基础流)。
- * **高清/大会员高码率流(可选)**:如需更高清晰度,可在 `.env` 中配置 `BILIBILI_COOKIE="SESSDATA=xxx; bili_jct=yyy;"`。
+ * **完全免 Cookie**:免登录直接获取 720P/1080P HTML5 基础流、番剧预告/公开剧集及图文动态。
---
diff --git a/docs/parsers/xiaoyunque.md b/docs/parsers/xiaoyunque.md
index 69dc059..5951c18 100644
--- a/docs/parsers/xiaoyunque.md
+++ b/docs/parsers/xiaoyunque.md
@@ -1,6 +1,6 @@
# 小云雀 AI (Xiaoyunque) 逆向解析指南
-本篇详细记录字节跳动剪映旗下 **小云雀 AI (xiaoyunque.jianying.com / xyq.jianying.com)** 作品的接口抓取机制、底层 VOD 视频分发流、水印压制机制与双轨逆向解析算法。
+本篇详细记录字节跳动剪映旗下 **小云雀 AI (xiaoyunque.jianying.com / xyq.jianying.com)** 作品的接口抓取机制、底层 VOD 视频分发流、水印压制机制与免登录逆向解析算法。
---
@@ -9,21 +9,21 @@
* **平台标识**:`小云雀AI`
* **支持媒体类型**:
* **AI 生图 / 创作图集** (PNG/JPEG,100% 官方原始纯净无水印原图)
- * **AI 创作高清视频** (MP4,最高 9.4 Mbps 原画,支持去除左上角 AI 标识)
+ * **AI 创作高清视频** (MP4 高清播放流与备选流列表)
* **提示词文案** (完整的 Prompt 提示词、标题、封面及创作者元数据)
* **常见链接形态**:
* 分享短链:`https://xiaoyunque.jianying.com/s/ebmxLzUc87I/`
* 落地页长链:`https://xiaoyunque.jianying.com/activities/pippit_share?inspiration_id=7647057288208977177&...`
-* **Cookie 依赖**:公开短链**完全无需 Cookie** 即可匿名解析;配置 `XIAOYUNQUE_COOKIE` 可激活创作者超清去标通道。
+* **Cookie 依赖**:**完全无需 Cookie**,全匿名免登录解析。
> [!NOTE]
> **水印与素材状态说明**:
> 1. **AI 生图 / 图集**:从字节 TOS 存储桶中直接提取官方原始图(`origin_aigc`),**100% 完全无水印**。
-> 2. **AI 生成视频**:平台在云端渲染合成时直接把水印压制在 MP4 画面像素中。解析器配置 Cookie 时自动优先提取已去除左上角「AI生成」黑框的 **9.4 Mbps 创作者原画流**(仅保留右下角小云雀微标);公开免登录模式下自动回退至 H5 落地页通道。
+> 2. **AI 生成视频**:平台在云端渲染合成时直接把水印压制在 MP4 画面像素中。解析器通过公开落地页通道直接提取高清视频播放流与备选流列表。视频封面也带有水印,为压水印视频的抽帧截图。
---
-## 2. 核心架构与双轨自适应解析流程
+## 2. 核心架构与解析流程
```mermaid
sequenceDiagram
@@ -31,76 +31,21 @@ sequenceDiagram
participant Client as 调用方
participant Parser as XiaoyunqueParser
participant Redirect as 302 重定向服务
- participant BizAPI as 创作者详情接口 (get_inspiration_detail)
participant LandingAPI as 公开落地页 (landing_page)
Client->>Parser: 输入分享短链 (如 /s/ebmxLzUc87I/)
Parser->>Redirect: HTTP GET 获取 302 Location
Redirect-->>Parser: 提取 query_params (含 inspiration_id, share_id 等)
-
- alt 已配置 XIAOYUNQUE_COOKIE
- Parser->>BizAPI: POST /api/biz/v1/inspiration/get_inspiration_detail
- BizAPI-->>Parser: 返回 watermark_video_info
- Note over Parser: 优先提取 brand_user_url (9.4 Mbps,无左上角 AI 标)
- else 未配置 Cookie / 创作者接口请求失败
- Parser->>LandingAPI: POST /luckycat/cn/jianying/campaign/v1/pippit/share/landing_page
- LandingAPI-->>Parser: 返回 page_info (兼容 inspiration / generate / gugu 等模板)
- end
-
+ Parser->>LandingAPI: POST /luckycat/cn/jianying/campaign/v1/pippit/share/landing_page
+ LandingAPI-->>Parser: 返回 page_info (兼容 inspiration / generate / template / gugu 等模板)
Parser->>Client: 统一返回标准 JSON (视频、图集、Prompt、作者元数据)
```
---
-## 3. 视频流类型与底层逆向分析
+## 3. 接口规范与参数清洗
-小云雀视频采用字节跳动 VOD (Video On Demand) 视频云分发体系,服务端在完成视频生成后会产出多路物理文件:
-
-| 视频流字段 / 类型 | 码率 / 分辨率 | 水印状态 | 解析器处理策略 |
-| :--- | :---: | :--- | :--- |
-| **`brand_user_url`** (创作者流) | **9.4 Mbps (720P/1080P)** | **无左上角「AI生成」黑框**,仅保留右下角微标 | **Cookie 模式下作为默认主视频 (`video_url`) 输出** |
-| **`share_url`** (分享流) | ~9.4 Mbps | 左上角带「AI生成」框,右下角无标 | 备选流,放入 `video_list` |
-| **`download_url` / `brand_url`** | ~9.4 Mbps | 左上角「AI生成」+ 右下角「小云雀」双水印 | 备选流,放入 `video_list` |
-| **`ai_url`** (预览流) | ~6.4 Mbps (720P) | 带官方基础预览水印 | 免登录兜底流 |
-| **母带原始渲染流** (如 `7cef...`) | 原画 | 100% 纯净(无任何角标) | **受作者账号 UID 权限保护**(见下文说明) |
-
-### 底层母带权限边界分析 (UID Security Boundary)
-通过对 Web 前端源码(`main.e10fbb27b2.js`)及后端 RPC 服务逆向发现:
-* 原始 100% 纯净母带渲染任务(`videogen/batch_get_render_task` / `get_published_inspiration_detail`)在后端 RPC 微服务(`pippit.business.editor`)层面进行了严格的用户归属鉴权:
- ```json
- {"ret":"10007","errmsg":"RPCError{PSM:[pippit.business.editor] Method:[CheckRenderTask] BizStatusMessage:[uid not equal]}"}
- {"ret":"2","errmsg":"uid not own inspiration"}
- ```
-* **结论**:普通访客或跨账号请求无法直接获取母带播放签名。解析器通过 `get_inspiration_detail` 提取的 `brand_user_url` 是当前非作者本号跨端获取的最佳清晰度与最少水印版本。
-
----
-
-## 4. 接口规范与参数清洗
-
-### 4.1 创作者灵感详情接口(优先,需 Cookie)
-* **接口地址**:
- `POST https://xyq.jianying.com/api/biz/v1/inspiration/get_inspiration_detail`
-* **请求头**:
- ```http
- Accept: application/json, text/plain, */*
- Content-Type: application/json
- Appid: 795647
- pf: 7
- appvr: 5.8.0
- Cookie: