mirror of
https://github.com/ucmao/media-parser.git
synced 2026-11-20 08:04:56 +08:00
feat: 添加快影平台解析支持
This commit is contained in:
@@ -3,7 +3,7 @@
|
||||
|
||||
**基于 Python 的多平台媒体原生本地解析系统**
|
||||
|
||||
[](LICENSE) [](https://www.python.org/) [](https://flask.palletsprojects.com/) [](#-部署指南) [](#-支持的平台矩阵)
|
||||
[](LICENSE) [](https://www.python.org/) [](https://flask.palletsprojects.com/) [](#-部署指南) [](#-支持的平台矩阵)
|
||||
|
||||
<p align="center">
|
||||
<a href="#-核心解析逻辑">解析逻辑</a> •
|
||||
@@ -60,6 +60,7 @@
|
||||
| **汽水音乐** | ✓ | ✓ | ✓ | ✓ | | ✓ | ✓ | |
|
||||
| **腾讯频道** | ✓ | ✓ | ✓ | ✓ | | | | |
|
||||
| **剪映 / CapCut** | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | |
|
||||
| **快影** | ✓ | ✓ | ✓ | ✓ | | ✓ | | |
|
||||
| **皮皮搞笑** | ✓ | ✓ | ✓ | ✓ | | | | |
|
||||
| **微视** | ✓ | ✓ | ✓ | ✓ | | | | |
|
||||
| **AcFun** | ✓ | ✓ | ✓ | ✓ | | | | |
|
||||
|
||||
@@ -61,6 +61,9 @@
|
||||
"lv.ulikecam.com": "剪映",
|
||||
"www.capcut.cn": "剪映",
|
||||
"capcut.cn": "剪映",
|
||||
"share.kwaiying.com": "快影",
|
||||
"kwaiying.com": "快影",
|
||||
"www.kwaiying.com": "快影",
|
||||
"weixin.qq.com": "视频号",
|
||||
"channels.weixin.qq.com": "视频号",
|
||||
"activity.qianwen.com": "通义千问",
|
||||
|
||||
+2
-1
@@ -14,7 +14,7 @@
|
||||
* 📖 **平台实战指南 (Parser Guides)**:
|
||||
* **短视频与轻社区**:[抖音](parsers/douyin.md) | [快手](parsers/kuaishou.md) | [皮皮虾](parsers/pipixia.md) | [皮皮搞笑](parsers/pipigaoxiao.md) | [最右](parsers/zuiyou.md) | [美拍](parsers/meipai.md) | [微视](parsers/weishi.md) | [绿洲](parsers/lvzhou.md)
|
||||
* **图文与综合社区**:[小红书](parsers/xiaohongshu.md) | [微博](parsers/weibo.md) | [知乎](parsers/zhihu.md) | [闲鱼](parsers/xianyu.md) | [Soul](parsers/soul.md)
|
||||
* **长视频与弹幕/创作**:[哔哩哔哩](parsers/bilibili.md) | [AcFun](parsers/acfun.md) | [新片场](parsers/xinpianchang.md) | [好看视频](parsers/haokan.md) | [西瓜视频](parsers/xigua.md) | [剪映](parsers/jianying.md)
|
||||
* **长视频与弹幕/创作**:[哔哩哔哩](parsers/bilibili.md) | [AcFun](parsers/acfun.md) | [新片场](parsers/xinpianchang.md) | [好看视频](parsers/haokan.md) | [西瓜视频](parsers/xigua.md) | [剪映](parsers/jianying.md) | [快影](parsers/kwaiying.md)
|
||||
* **AI 生成与大模型**:[豆包 AI](parsers/doubao.md) | [即梦 AI](parsers/jimeng.md) | [可灵 AI](parsers/kling.md) | [通义千问](parsers/qianwen.md) | [夸克 AI](parsers/quark-ai.md) | [小云雀 AI](parsers/xiaoyunque.md)
|
||||
* **音频与垂直频道**:[汽水音乐](parsers/qsmusic.md) | [全民K歌](parsers/quanminkge.md) | [虎牙](parsers/huya.md) | [梨视频](parsers/lishipin.md) | [微信视频号](parsers/wechat-channels.md) | [腾讯频道](parsers/tencent-channel.md)
|
||||
|
||||
@@ -60,6 +60,7 @@
|
||||
| 29 | **Soul** | 视频 / 瞬间 | ✅ 支持 | 🟢 免配置 | Web 话题页解析 | [查看指南](parsers/soul.md) |
|
||||
| 30 | **剪映 / CapCut** | 模板视频 / Web协作视频 | ✅ 支持 | 🟢 免配置 | 字节剪映 & CapCut 协作 API | [查看指南](parsers/jianying.md) |
|
||||
| 31 | **梨视频** | 资讯短视频 | ✅ 支持 | 🟢 免配置 | 动态防盗链时间戳解密 | [查看指南](parsers/lishipin.md) |
|
||||
| 32 | **快影** | 模板视频 / 原声音乐 | ✅ 支持 | 🟢 免配置 | 快影 OpenAPI + 动态签名 | [查看指南](parsers/kwaiying.md) |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -0,0 +1,69 @@
|
||||
# 快影 (Kwaiying) 逆向解析指南
|
||||
|
||||
本篇详细记录快手科技旗下 **快影 (Kwaiying)** 剪辑 App 模板分享与作品分享的原生解析方案。
|
||||
|
||||
---
|
||||
|
||||
## 1. 平台特征与支持能力
|
||||
|
||||
* **平台标识**:`快影`
|
||||
* **支持媒体类型**:高清模板视频 (MP4) / 封面图 / 标题文案 / 创作者信息 / 背景音乐 (MP3)
|
||||
* **支持域名**:
|
||||
* `share.kwaiying.com`(快影 App H5 模板分享)
|
||||
* `kwaiying.com` / `www.kwaiying.com`
|
||||
* **常见链接形态**:
|
||||
* **快影模板分享长链**:`https://share.kwaiying.com/share/template/index.html?id=8467216&userId=702561542395651960`
|
||||
* **Cookie 依赖**:🟢 免配置(开箱即用)。
|
||||
|
||||
---
|
||||
|
||||
## 2. 核心逆向流程
|
||||
|
||||
### 1. 提取 Template ID
|
||||
从 URL query 参数(`id` / `templateId`)中解析出模板 ID(例如 `8467216`)。
|
||||
|
||||
### 2. 动态计算客户端签名 (Sign & Nonce)
|
||||
快影 OpenAPI 接口校验 `timestamp`、12 位随机数 `nonce` 以及基于混淆密钥 `yiuhjkbvhbjisjchgdnx38uejd` 计算的签名:
|
||||
|
||||
```python
|
||||
import hashlib, random, re, time
|
||||
|
||||
def get_kwaiying_sign(key="yiuhjkbvhbjisjchgdnx38uejd"):
|
||||
now_ms = int(time.time() * 1000)
|
||||
nonce = random.randint(100000000000, 999999999999)
|
||||
hex_str = "".join([hex(ord(c))[2:] for c in key])
|
||||
digits_only = re.sub(r"[a-fA-F]", "", hex_str)[:16]
|
||||
a = int(digits_only)
|
||||
s = (a ^ now_ms) | a
|
||||
sign_val = hashlib.md5(str(nonce ^ s).encode("utf-8")).hexdigest()
|
||||
return {"timestamp": now_ms, "nonce": nonce, "sign": sign_val}
|
||||
```
|
||||
|
||||
### 3. 请求模板详情接口
|
||||
* **请求方式**:`GET`
|
||||
* **接口地址**:`https://api.kmovie.gifshow.com/rest/n/kmovie/app/resource/getTemplateById`
|
||||
* **Query 参数**:`templateId`, `timestamp`, `nonce`, `sign`
|
||||
* **Headers**:
|
||||
```http
|
||||
User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 16_6 like Mac OS X)...
|
||||
Origin: https://share.kwaiying.com
|
||||
Referer: https://share.kwaiying.com/share/template/index.html?id=...
|
||||
```
|
||||
|
||||
### 4. 提取媒体数据
|
||||
* **视频直链**:`data.resource.videoUrl`(无水印标准 MP4)
|
||||
* **封面图**:`data.resource.templateBean.coverUrl`
|
||||
* **标题描述**:`data.resource.name` 或 `data.resource.templateBean.description`
|
||||
* **创作者**:`data.resource.user.nickName`、`data.resource.user.userId` 及 `data.resource.user.iconUrlList[0]`
|
||||
* **背景原声**:`data.resource.music.url`
|
||||
|
||||
---
|
||||
|
||||
## 3. 测试与验证
|
||||
|
||||
* **专属单元测试**:[tests/test_kwaiying_parser.py](file:///Users/leo/Projects/media-parser/tests/test_kwaiying_parser.py)
|
||||
* **执行命令**:
|
||||
```bash
|
||||
python3 -m unittest tests/test_kwaiying_parser.py
|
||||
python3 tests/manual_verify_parsers.py --platform 快影
|
||||
```
|
||||
@@ -0,0 +1,131 @@
|
||||
from src.parser_factory import register_parser
|
||||
"""快影 (Kwaiying) 模板与作品分享解析器。"""
|
||||
|
||||
import hashlib
|
||||
import random
|
||||
import re
|
||||
import time
|
||||
from urllib.parse import parse_qs, urlparse
|
||||
|
||||
from configs.logging_config import get_logger
|
||||
from src.parsers.base_parser import BaseParser
|
||||
|
||||
|
||||
logger = get_logger(__name__)
|
||||
|
||||
|
||||
@register_parser("快影")
|
||||
class KwaiyingParser(BaseParser):
|
||||
"""通过快影 OpenAPI 接口解析 share.kwaiying.com 分享链接。"""
|
||||
|
||||
DETAIL_API = "https://api.kmovie.gifshow.com/rest/n/kmovie/app/resource/getTemplateById"
|
||||
SIGN_KEY = "yiuhjkbvhbjisjchgdnx38uejd"
|
||||
USER_AGENT = (
|
||||
"Mozilla/5.0 (iPhone; CPU iPhone OS 16_6 like Mac OS X) AppleWebKit/605.1.15 "
|
||||
"(KHTML, like Gecko) Version/16.6 Mobile/15E148 Safari/604.1"
|
||||
)
|
||||
|
||||
def __init__(self, real_url):
|
||||
super().__init__(real_url)
|
||||
self.template_id = self._extract_template_id(real_url)
|
||||
self.resource_data = self._fetch_template()
|
||||
|
||||
@staticmethod
|
||||
def _extract_template_id(url):
|
||||
"""从 URL query 或 path 中提取 templateId / id。"""
|
||||
parsed = urlparse(url)
|
||||
query = parse_qs(parsed.query)
|
||||
template_id = (query.get("id") or query.get("templateId") or [""])[0]
|
||||
if not template_id:
|
||||
match = re.search(r"(?:id|templateId|template_id)=(\d+)", url)
|
||||
if match:
|
||||
template_id = match.group(1)
|
||||
return template_id
|
||||
|
||||
@classmethod
|
||||
def _generate_sign_params(cls):
|
||||
"""生成快影 API 签名与 nonce 校验参数。"""
|
||||
now_ms = int(time.time() * 1000)
|
||||
nonce = random.randint(100000000000, 999999999999)
|
||||
hex_str = "".join([hex(ord(c))[2:] for c in cls.SIGN_KEY])
|
||||
digits_only = re.sub(r"[a-fA-F]", "", hex_str)[:16]
|
||||
a = int(digits_only) if digits_only else 0
|
||||
s = (a ^ now_ms) | a
|
||||
sign_val = hashlib.md5(str(nonce ^ s).encode("utf-8")).hexdigest()
|
||||
return {
|
||||
"timestamp": now_ms,
|
||||
"nonce": nonce,
|
||||
"sign": sign_val,
|
||||
}
|
||||
|
||||
def _fetch_template(self):
|
||||
"""请求快影 API 获取模板及媒体数据。"""
|
||||
if not self.template_id:
|
||||
logger.warning("Unable to extract Kwaiying template_id from URL: %s", self.real_url)
|
||||
return {}
|
||||
|
||||
params = self._generate_sign_params()
|
||||
params["templateId"] = self.template_id
|
||||
|
||||
headers = {
|
||||
"User-Agent": self.USER_AGENT,
|
||||
"Origin": "https://share.kwaiying.com",
|
||||
"Referer": self.real_url,
|
||||
}
|
||||
|
||||
try:
|
||||
response = self.session.get(
|
||||
self.DETAIL_API,
|
||||
headers=headers,
|
||||
params=params,
|
||||
timeout=12,
|
||||
)
|
||||
response.raise_for_status()
|
||||
res_json = response.json()
|
||||
if res_json.get("result") == 1 and res_json.get("resource"):
|
||||
return res_json.get("resource") or {}
|
||||
logger.warning("Kwaiying API returned error: %s", res_json.get("errorMsg"))
|
||||
except Exception as exc:
|
||||
logger.warning("Failed to fetch Kwaiying template: %s", exc)
|
||||
return {}
|
||||
|
||||
def get_real_video_url(self):
|
||||
"""提取无水印高清 MP4 视频直链。"""
|
||||
return self.resource_data.get("videoUrl")
|
||||
|
||||
def get_title_content(self):
|
||||
"""提取模板标题或文案描述。"""
|
||||
return (
|
||||
self.resource_data.get("name")
|
||||
or (self.resource_data.get("templateBean") or {}).get("description")
|
||||
or "快影模板"
|
||||
)
|
||||
|
||||
def get_cover_photo_url(self):
|
||||
"""提取封面图地址。"""
|
||||
template_bean = self.resource_data.get("templateBean") or {}
|
||||
return template_bean.get("coverUrl") or template_bean.get("coverWebPUrl")
|
||||
|
||||
def get_author_info(self):
|
||||
"""提取创作者昵称、ID 及头像。"""
|
||||
user = self.resource_data.get("user") or {}
|
||||
icon_list = user.get("iconUrlList") or []
|
||||
avatar = icon_list[0] if icon_list else ""
|
||||
return {
|
||||
"nickname": user.get("nickName") or "",
|
||||
"author_id": str(user.get("userId") or user.get("ksUserId") or ""),
|
||||
"avatar": avatar,
|
||||
}
|
||||
|
||||
def get_audio_url(self):
|
||||
"""提取音频地址。"""
|
||||
music = self.resource_data.get("music") or {}
|
||||
return music.get("url") or music.get("playUrl")
|
||||
|
||||
def get_image_list(self):
|
||||
"""提取图集资源。"""
|
||||
return []
|
||||
|
||||
def get_video_list(self):
|
||||
video_url = self.get_real_video_url()
|
||||
return [video_url] if video_url else []
|
||||
@@ -3865,6 +3865,36 @@
|
||||
"title"
|
||||
],
|
||||
"note": "2026-08 真实反馈验证: 豆包对话分享"
|
||||
},
|
||||
{
|
||||
"platform": "快影",
|
||||
"url": "https://share.kwaiying.com/share/template/index.html?id=8467216&userId=702561542395651960",
|
||||
"pattern": "share.kwaiying.com 模板分享 (id=8467216)",
|
||||
"media_types": [
|
||||
"video"
|
||||
],
|
||||
"expected_fields": [
|
||||
"video",
|
||||
"cover",
|
||||
"title",
|
||||
"author"
|
||||
],
|
||||
"note": "2026-08 真实反馈验证: 《复古氛围感》快影模板"
|
||||
},
|
||||
{
|
||||
"platform": "快影",
|
||||
"url": "https://share.kwaiying.com/share/template/index.html?id=37069795&userId=664843898673931655",
|
||||
"pattern": "share.kwaiying.com 模板分享 (id=37069795)",
|
||||
"media_types": [
|
||||
"video"
|
||||
],
|
||||
"expected_fields": [
|
||||
"video",
|
||||
"cover",
|
||||
"title",
|
||||
"author"
|
||||
],
|
||||
"note": "2026-08 真实反馈验证: 《鬼灭之刃》快影模板"
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -71,7 +71,7 @@ def verify_case(case):
|
||||
|
||||
|
||||
def main():
|
||||
parser = argparse.ArgumentParser(description="一键多形态验证 31 平台真实分享链接")
|
||||
parser = argparse.ArgumentParser(description="一键多形态验证 32 平台真实分享链接")
|
||||
parser.add_argument("--platform", action="append", help="仅验证指定平台;可重复传入")
|
||||
parser.add_argument("--list-missing", action="store_true", help="仅列出缺少链接的平台")
|
||||
parser.add_argument("--limit", type=int, default=0, help="限制每个平台运行的最大用例数 (默认全部)")
|
||||
@@ -100,7 +100,7 @@ def main():
|
||||
limited_cases.append(case)
|
||||
cases = limited_cases
|
||||
|
||||
print(f"🧪 开始执行 31 平台自动化多形态链接验证 (共 {len(cases)} 条用例)...\n")
|
||||
print(f"🧪 开始执行 32 平台自动化多形态链接验证 (共 {len(cases)} 条用例)...\n")
|
||||
results = [verify_case(case) for case in cases]
|
||||
for status, platform, pattern, detail, url in results:
|
||||
status_tag = f"✅ {status}" if status == "PASSED" else (f"❌ {status}" if status == "FAILED" else f"⚪ {status}")
|
||||
|
||||
@@ -0,0 +1,60 @@
|
||||
import unittest
|
||||
from unittest.mock import Mock, patch
|
||||
|
||||
from src.parsers.kwaiying_parser import KwaiyingParser
|
||||
|
||||
|
||||
class KwaiyingParserTest(unittest.TestCase):
|
||||
URL = "https://share.kwaiying.com/share/template/index.html?id=8467216&userId=702561542395651960"
|
||||
|
||||
def test_maps_template_response(self):
|
||||
response = Mock()
|
||||
response.raise_for_status.return_value = None
|
||||
response.json.return_value = {
|
||||
"result": 1,
|
||||
"resource": {
|
||||
"id": "8467216",
|
||||
"name": "测试快影模板",
|
||||
"videoUrl": "https://video.example.com/kwaiying_video.mp4",
|
||||
"templateBean": {
|
||||
"coverUrl": "https://image.example.com/kwaiying_cover.jpg",
|
||||
"description": "快影描述文案",
|
||||
"videoDuration": 25000,
|
||||
},
|
||||
"user": {
|
||||
"nickName": "快影测试作者",
|
||||
"userId": "12345678",
|
||||
"iconUrlList": ["https://image.example.com/kwaiying_avatar.jpg"],
|
||||
},
|
||||
"music": {
|
||||
"url": "https://audio.example.com/kwaiying_music.mp3"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
with patch("requests.Session.get", return_value=response):
|
||||
parser = KwaiyingParser(self.URL)
|
||||
|
||||
self.assertEqual(parser.get_real_video_url(), "https://video.example.com/kwaiying_video.mp4")
|
||||
self.assertEqual(parser.get_title_content(), "测试快影模板")
|
||||
self.assertEqual(parser.get_cover_photo_url(), "https://image.example.com/kwaiying_cover.jpg")
|
||||
self.assertEqual(parser.get_author_info()["nickname"], "快影测试作者")
|
||||
self.assertEqual(parser.get_author_info()["author_id"], "12345678")
|
||||
self.assertEqual(parser.get_author_info()["avatar"], "https://image.example.com/kwaiying_avatar.jpg")
|
||||
self.assertEqual(parser.get_audio_url(), "https://audio.example.com/kwaiying_music.mp3")
|
||||
self.assertEqual(parser.get_video_list(), ["https://video.example.com/kwaiying_video.mp4"])
|
||||
|
||||
def test_missing_template_id_does_not_call_api(self):
|
||||
with patch("requests.Session.get") as get_mock:
|
||||
parser = KwaiyingParser("https://share.kwaiying.com/share/template/index.html")
|
||||
|
||||
get_mock.assert_not_called()
|
||||
self.assertIsNone(parser.get_real_video_url())
|
||||
|
||||
def test_extracts_id_from_templateId_param(self):
|
||||
url = "https://share.kwaiying.com/share/template/index.html?templateId=999888"
|
||||
self.assertEqual(KwaiyingParser._extract_template_id(url), "999888")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
unittest.main()
|
||||
+10
-1
@@ -23,7 +23,7 @@ class WebFetcher:
|
||||
# 微博博文可通过 API 直接根据 ID 解析,直接访问网页端常触发访客系统重定向。
|
||||
domain = UrlParser.get_domain(url)
|
||||
if domain not in {"t.cn", "b23.tv", "xhslink.cn", "xhslink.com", "hy.fan"}:
|
||||
if UrlParser.get_platform(url) in {"知乎", "绿洲", "新片场", "夸克AI", "通义千问", "微博", "小云雀AI", "哔哩哔哩"}:
|
||||
if UrlParser.get_platform(url) in {"知乎", "绿洲", "新片场", "夸克AI", "通义千问", "微博", "小云雀AI", "哔哩哔哩", "快影"}:
|
||||
return UrlParser.extract_video_address(url)
|
||||
try:
|
||||
current_url = url
|
||||
@@ -217,6 +217,15 @@ class UrlParser:
|
||||
preserved_params.append((key, value))
|
||||
if preserved_params:
|
||||
address = f"{address}?{urlencode(preserved_params)}"
|
||||
elif platform == "快影":
|
||||
query_params = parse_qs(parsed_url.query)
|
||||
preserved_params = []
|
||||
for key in ("id", "templateId", "template_id", "userId", "app_name", "page_name"):
|
||||
value = query_params.get(key, [None])[0]
|
||||
if value is not None:
|
||||
preserved_params.append((key, value))
|
||||
if preserved_params:
|
||||
address = f"{address}?{urlencode(preserved_params)}"
|
||||
elif platform == "视频号":
|
||||
query_params = parse_qs(parsed_url.query)
|
||||
short_uri = query_params.get('id', [None])[0]
|
||||
|
||||
Reference in New Issue
Block a user