用途:作为社媒视频下载的统一入口,从分享链接把视频保存到本地;飞书多维表格等批处理场景也须复用其下载脚本,而非另写直连下载器。正文、点赞、收藏可在业务脚本各自抓取,但视频文件获取必须走本技能链路。
主要能力:自动识别平台并按平台选主引擎与兜底:视频号用自托管解析器取临时直链;B站优先 yt-dlp,失败回退 Playwright;抖音、小红书优先 Playwright,失败回退 yt-dlp;TikTok 优先真实浏览器 CDP 抓流;YouTube、Twitter/X、Instagram 等用 yt-dlp,支持 1700+ 站点。下载后生成 .meta.json,含作者、描述、封面、时间、互动数据及校验字段,不含临时 URL、API Key 或 Cookie。
使用方式:先进入技能根目录,命令用相对路径。B站下载前须检查登录:python3 ./scripts/download.py check-login bilibili;需要时执行 python3 ./scripts/download.py login bilibili --signal-file /tmp/video_dl_login_done 交互式登录。下载命令为 python3 ./scripts/download.py "<分享文本或链接>" [输出文件名.mp4],默认保存到 ~/Downloads/,可用 VIDEO_DOWNLOAD_OUTPUT_DIR 修改。Cookie 存于 ~/.config/video-download/<平台>_cookies.json,支持 bilibili/douyin/xiaohongshu。
适用场景与限制:视频号需配置 WECHAT_CHANNELS_RESOLVER_URL,解析器返回加密密钥时本技能拒绝下载;TikTok 默认 CDP 端口 127.0.0.1:9225,不回退 9222;依赖 playwright、yt-dlp、ffmpeg,B站及音视频分离格式需 ffmpeg 合并。未登录 B站仅 480p;抖音、小红书视风控可能需要 Cookie;CDN 链接数小时过期需重跑;其他平台登录与收费情况暂未提供。