From 9243967abd2cc2d2767ace9f5439f16edaae24d0 Mon Sep 17 00:00:00 2001 From: ucmao <294323976@qq.com> Date: Sat, 29 Aug 2026 23:00:48 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E6=B7=BB=E5=8A=A0=E5=BF=AB=E5=BD=B1?= =?UTF-8?q?=E5=B9=B3=E5=8F=B0=E8=A7=A3=E6=9E=90=E6=94=AF=E6=8C=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 3 +- configs/business_config.json | 3 + docs/index.md | 3 +- docs/parsers/kwaiying.md | 69 +++++++++++++++++ src/parsers/kwaiying_parser.py | 131 +++++++++++++++++++++++++++++++++ tests/live_parser_samples.json | 30 ++++++++ tests/manual_verify_parsers.py | 4 +- tests/test_kwaiying_parser.py | 60 +++++++++++++++ utils/web_fetcher.py | 11 ++- 9 files changed, 309 insertions(+), 5 deletions(-) create mode 100644 docs/parsers/kwaiying.md create mode 100644 src/parsers/kwaiying_parser.py create mode 100644 tests/test_kwaiying_parser.py diff --git a/README.md b/README.md index 98e8e6e..5af58af 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ **基于 Python 的多平台媒体原生本地解析系统** -[](LICENSE) [](https://www.python.org/) [](https://flask.palletsprojects.com/) [](#-部署指南) [](#-支持的平台矩阵) +[](LICENSE) [](https://www.python.org/) [](https://flask.palletsprojects.com/) [](#-部署指南) [](#-支持的平台矩阵)
解析逻辑 • @@ -60,6 +60,7 @@ | **汽水音乐** | ✓ | ✓ | ✓ | ✓ | | ✓ | ✓ | | | **腾讯频道** | ✓ | ✓ | ✓ | ✓ | | | | | | **剪映 / CapCut** | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | | +| **快影** | ✓ | ✓ | ✓ | ✓ | | ✓ | | | | **皮皮搞笑** | ✓ | ✓ | ✓ | ✓ | | | | | | **微视** | ✓ | ✓ | ✓ | ✓ | | | | | | **AcFun** | ✓ | ✓ | ✓ | ✓ | | | | | diff --git a/configs/business_config.json b/configs/business_config.json index cf6bd0a..385d959 100755 --- a/configs/business_config.json +++ b/configs/business_config.json @@ -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": "通义千问", diff --git a/docs/index.md b/docs/index.md index c5692c2..0c6a834 100644 --- a/docs/index.md +++ b/docs/index.md @@ -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) | --- diff --git a/docs/parsers/kwaiying.md b/docs/parsers/kwaiying.md new file mode 100644 index 0000000..3c08445 --- /dev/null +++ b/docs/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 快影 + ``` diff --git a/src/parsers/kwaiying_parser.py b/src/parsers/kwaiying_parser.py new file mode 100644 index 0000000..80b1e25 --- /dev/null +++ b/src/parsers/kwaiying_parser.py @@ -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 [] diff --git a/tests/live_parser_samples.json b/tests/live_parser_samples.json index f501bf9..1d8b5da 100644 --- a/tests/live_parser_samples.json +++ b/tests/live_parser_samples.json @@ -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 真实反馈验证: 《鬼灭之刃》快影模板" } ] } \ No newline at end of file diff --git a/tests/manual_verify_parsers.py b/tests/manual_verify_parsers.py index 67bd1ed..a0fd04d 100644 --- a/tests/manual_verify_parsers.py +++ b/tests/manual_verify_parsers.py @@ -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}") diff --git a/tests/test_kwaiying_parser.py b/tests/test_kwaiying_parser.py new file mode 100644 index 0000000..2720c1a --- /dev/null +++ b/tests/test_kwaiying_parser.py @@ -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() diff --git a/utils/web_fetcher.py b/utils/web_fetcher.py index e2d60af..0cbe1d3 100755 --- a/utils/web_fetcher.py +++ b/utils/web_fetcher.py @@ -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]