SuperAPI AI 工具集

resolve-kwai-cdn-url

设计与创作

查看项目

更新于 10-15 22:14

技能介绍

用途:将快手(快手/Kwai)分享链接或分享文本解析为视频CDN URL,适合需要对单个链接、分享文本或CSV批量输入进行解析、且输出需为JSONL的场景。

主要能力:提供两条解析路径。videodl(videofetch)为主路径,基于Playwright与requests,支持cookie与代理;GraphQL/移动页面为备用路径,在videodl失败时使用,依次尝试GraphQL、移动端INIT_STATE和HTML状态解析。videodl会自动从分享文本中提取第一个URL,并跟随v.kuaishou.com跳转。输出方面,videodl输出包含url、cdn_url、error_msg字段的JSONL;CSV模式在两条路径下均输出原始列加CDNURL及可选error_msg。live.kuaishou.com与captcha.zt.kuaishou.com会被视为失败,error_msg中记录原因。

使用方式:安装与执行目录为~/.agents/skills/resolve-kwai-cdn-url/,需在该目录下运行命令。可一次性执行:cd ~/.agents/skills/resolve-kwai-cdn-url && uv run python scripts/kwai_videodl_resolve.py --help。主路径初始化:uv venv .venv;uv sync。单链接示例:uv run python scripts/kwai_videodl_resolve.py "https://v.kuaishou.com/8qIlZu" > single.jsonl。CSV批量:uv run python scripts/kwai_videodl_resolve.py --input-csv data.csv --csv-url-field URL --output output.jsonl --workers 10(可加--resume续跑)。代理与cookie:--proxy "http://user:pass@host:port"、--cookie "<YOUR_COOKIE>"或--cookie-file cookie.json。备用路径使用scripts/kwai_extract_cdn.py,CSV转换使用scripts/kwai_csv_to_jsonl.py(参数含--url-col、--cdn-col、--cookie、--cookie-file、--workers、--output、--resume、--proxy)。

限制与注意:--cookie接受原始Cookie头字符串;--cookie-file接受原始字符串或JSON cookie数组;未提供cookie时videodl会从首页获取匿名cookie。--proxy作用于所有HTTP请求。--resume会重写输出JSONL仅保留成功行,然后重试缺失或失败行并追加新结果。如遇拦截,可先尝试不带cookie,仍被拦截再通过--cookie或--cookie-file传入真实浏览器cookie。CSV进度日志为按批次的成功计数,统计在完成或Ctrl+C时输出。cookie、代理的具体可用性与平台限制暂未提供。