feat: 添加快影平台解析支持

This commit is contained in:
ucmao
2026-08-29 23:00:48 +08:00
parent 2a51abfeb3
commit 9243967abd
9 changed files with 309 additions and 5 deletions
+2 -1
View File
@@ -3,7 +3,7 @@
**基于 Python 的多平台媒体原生本地解析系统**
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) [![Python Version](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/) [![Flask](https://img.shields.io/badge/Framework-Flask-000000?logo=flask&logoColor=white)](https://flask.palletsprojects.com/) [![Docker](https://img.shields.io/badge/Docker-Ready-2496ED?logo=docker&logoColor=white)](#-部署指南) [![Support](https://img.shields.io/badge/support-31%20Platforms-brightgreen.svg)](#-支持的平台矩阵)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) [![Python Version](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/) [![Flask](https://img.shields.io/badge/Framework-Flask-000000?logo=flask&logoColor=white)](https://flask.palletsprojects.com/) [![Docker](https://img.shields.io/badge/Docker-Ready-2496ED?logo=docker&logoColor=white)](#-部署指南) [![Support](https://img.shields.io/badge/support-32%20Platforms-brightgreen.svg)](#-支持的平台矩阵)
<p align="center">
<a href="#-核心解析逻辑">解析逻辑</a> •
@@ -60,6 +60,7 @@
| **汽水音乐** | ✓ | ✓ | ✓ | ✓ | | ✓ | ✓ | |
| **腾讯频道** | ✓ | ✓ | ✓ | ✓ | | | | |
| **剪映 / CapCut** | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | |
| **快影** | ✓ | ✓ | ✓ | ✓ | | ✓ | | |
| **皮皮搞笑** | ✓ | ✓ | ✓ | ✓ | | | | |
| **微视** | ✓ | ✓ | ✓ | ✓ | | | | |
| **AcFun** | ✓ | ✓ | ✓ | ✓ | | | | |
+3
View File
@@ -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
View File
@@ -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) |
---
+69
View File
@@ -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 快影
```
+131
View File
@@ -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 []
+30
View File
@@ -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 真实反馈验证: 《鬼灭之刃》快影模板"
}
]
}
+2 -2
View File
@@ -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}")
+60
View File
@@ -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
View File
@@ -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]