SuperAPI AI 工具集

qiaomu-download

通用与其它

查看项目

更新于 10-15 20:27

技能介绍

用途:把用户给出的在线视频/音乐 URL 转为经过验证的本地视频、MP3、字幕或结构化媒体信息,默认保存到 ~/Downloads。用户表达下载或保存意图并附 HTTPS URL 即触发;单独出现 URL、查看、总结、上传、图片/PDF/网页下载不触发。

主要能力:识别 weixin.qq.com/sph/* 用内置视频号适配器;识别 open.spotify.com/track/* 用内置 Spotify 公共元数据与 YouTube 候选匹配器输出带标签 MP3;其他 HTTPS URL 由 yt-dlp 动态探测。支持 download、audio、subtitles、info 子命令,可用 --quality 1080p|720p|480p,只有最终 JSON ok: true 且 files 含经验证绝对路径才报完成。

使用方式示例:python3 scripts/download.py download URL;python3 scripts/download.py doctor --upgrade;视频号:python3 scripts/download.py download 'https://weixin.qq.com/sph/...' --dir ~/Downloads;Spotify:python3 scripts/download.py download 'https://open.spotify.com/track/...' --dir ~/Downloads。普通下载使用 --no-overwrites。

视频号流程:自动调用包内 scripts/wechat_adapter.py,不使用 yt-dlp;结果为 manual_action_required 时提示用户在电脑微信播放后加 --wait-page 90 重试;禁止用 UI 自动化控制微信;固定在线解析器需用户明确同意后加 --wechat-online allowed,且不得发送 Cookie 或登录态。默认可保存 H.264 与 H.265 两版,可用 --single-version。

Spotify 流程:读取公开页面元数据,不要求 Premium,不解密 Spotify 音频;用 yt-dlp 搜索公开视频源评分匹配,下载 128 kbps MP3 并写标签、ffprobe 验证;自动模式只接受单曲 URL。

限制:YouTube、Bilibili、X/Twitter 已验证,其他平台由当前 yt-dlp extractor 动态探测,一次成功不等于永久支持;登录可见、会员、年龄或地区限制内容只使用用户本机已有且有权使用的会话;不得绕过 DRM、付费墙或访问控制;对小红书等风控站点公开解析失败后最多一次 Cookie 回退。Cookie、微信登录态、抓包、解密 key 与签名媒体 URL 不得上传或出现在日志与报告中。视频号冷启动可能需安装本地后端、信任本机独立 CA 或修改系统代理,需授权并在结束后按快照恢复。收费、价格等暂未提供。