mcpField
Q
qiaomu-download

qiaomu-download

github.com/joeseesun创意与媒体432316 次安装1 周前更新
代码仓库

关于 qiaomu-download

Qiaomu Download 是一项技能，可将支持的在线视频 URL 转为经过验证的本地视频、MP3、字幕或结构化媒体信息。它包含视频号和 Spotify 的专用流程，并明确规定验证、身份验证与隐私边界。

主要功能

  1. 01下载视频、MP3、字幕或元数据
  2. 02内置微信视频号适配器
  3. 03将 Spotify 单曲匹配到公开视频源
  4. 04验证生成文件及媒体信息
  5. 05限制 Cookie 与账户数据处理

适用场景

  1. 01从 HTTPS 分享链接保存视频
  2. 02根据 Spotify 单曲 URL 创建带标签 MP3
  3. 03获取字幕或结构化媒体信息
  4. 04按需完成人工操作后下载视频号内容

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/joeseesun/qiaomu-download --skill qiaomu-download

安装后在 Claude Code 中输入/qiaomu-download确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.gitignore
manifest.json
LICENSE
README.md
.github/workflows/
ci.yml
agents/
interface.yaml
evals/
trigger_cases.json
evals/output/
cases.json
references/
platforms.md
wechat-video.md
security.md
workflow.md
reports/
creation-handoff.md
output-evidence.json
output_quality_scorecard.md
release-1.3.1.md
prior-art-candidates.json
runtime-validation.md
prior-art-research.md
skill-ir.json
trust-report.md
trigger-eval.json
scripts/
spotify_adapter.py
download.py
test_download.py
validate_skill.py
trigger_eval.py
scripts/spotify/
release-lock.json
scripts/wechat/
download_media.py
download_online.py

详细介绍

来自项目 README

Qiaomu Download

把用户给出的在线视频 URL 转为经过验证的本地视频、MP3、字幕或结构化媒体信息。默认保存到 ~/Downloads，除非用户指定目录。微信视频号是本包内置适配器，不依赖另装 qiaomu-wx-video。

工作流

  1. 用户表达下载或保存意图并附带 HTTPS URL 时触发；“下载这个：URL”已经足够。单独出现 URL、查看、总结、上传、图片/PDF/网页下载不触发。
  2. 先识别 URL：
    • weixin.qq.com/sph/*：直接使用内置视频号适配器，见“视频号流程”。
    • open.spotify.com/track/*：使用内置 Spotify 公共元数据与 YouTube 候选匹配器，输出带 Spotify 标题、艺人、专辑标签的 MP3。
    • 其他 HTTPS URL：每个新任务先运行 python3 scripts/download.py doctor --upgrade，再由 yt-dlp 动态探测。
  3. 对小红书、抖音、TikTok、Instagram、Facebook、微博等容易触发登录验证或风控的平台，下载前简短提醒：“将只通过分享链接和 yt-dlp 解析，不操作客户端或网页 UI；若出现登录、验证码或安全验证，需要你手动完成。”提醒后直接继续。
  4. 普通视频运行 python3 scripts/download.py download URL；MP3、字幕、元数据分别使用 audio、subtitles、info。用户指定画质时加 --quality 1080p|720p|480p。
  5. 只有最终 JSON 中 ok: true 且 files 含经过验证的绝对路径时，才能报告完成。返回大小、时长、分辨率、编码和 Cookie 是否参与，不回显 Cookie 内容或签名媒体地址。

视频号流程

统一入口就是：

python3 scripts/download.py download 'https://weixin.qq.com/sph/...' --dir ~/Downloads
  1. 命令自动识别视频号链接，调用包内 scripts/wechat_adapter.py，不使用 yt-dlp，也不要求另装其他 Skill。
  2. 先检查已连接的本地下载后端；连接和配置都可用时直接获取媒体、下载、解密并完整解码验证。
  3. 结果为 manual_action_required 时，才对用户说一次：“已准备好，请在电脑微信里打开这个视频并播放；若页面原来已打开，请关闭视频页后重新打开。回复‘已播放’即可，不用点下载。” 用户完成后用 --wait-page 90 重试并继续到文件交付，不再问“是否继续”。
  4. 不得用 Computer Use、Accessibility、AppleScript、浏览器自动化或其他 UI 工具点击、播放、刷新、登录或控制微信及其内嵌页面；不能换一种自动化工具绕过限制。
  5. 固定在线解析器只接收公开分享 URL。只有用户明确同意把该 URL 发给第三方解析器后，才加 --wechat-online allowed；不得发送 Cookie、登录态、设备信息或抓包内容。
  6. 冷启动需要安装本地后端、信任本机独立 CA 或修改系统代理时，分别说明真实影响并取得所需授权。保存修改前的代理快照，成功、失败或中断都恢复；不使用公开私钥对应的共享根证书。
  7. 默认可保存经真实编码验证的 H.264 与 H.265 两版；用户只要一份时加 --single-version。不要根据 spec 名猜编码或把普通 720p 称为原画。

详细状态和首次设置见 视频号内置适配器。

Spotify 单曲流程

python3 scripts/download.py download 'https://open.spotify.com/track/...' --dir ~/Downloads
  1. 读取 Spotify 公开页面中的标题、艺人、专辑、年份与时长；不读取客户端缓存，不要求 Premium 登录，也不解密 Spotify 音频。
  2. 用 yt-dlp 搜索公开视频源，按标题、艺人、时长、频道验证、播放量和版本词惩罚评分；低于阈值时停止。
  3. 锁定得分最高的单个 YouTube URL，下载 128 kbps MP3，写入 Spotify 标签，再用 ffprobe 验证。
  4. 自动模式只接受单曲 URL；专辑和播放列表需要先明确数量边界。
  5. 结果返回元数据源、音频源 URL、匹配置信度及 drm_bypass_used: false。

匹配机制参考仍在维护的 spotDL v4，并针对其元数据客户端可能卡住的情况改用 Spotify 公开页面，减少依赖和首次安装等待。

平台策略

  • YouTube、Bilibili、X/Twitter 是已验证目标；其他平台由当前 yt-dlp extractor 动态探测，不能把一次成功等同于永久支持。
  • auto Cookie 模式先匿名访问；只有失败时才尝试一次本机 Chrome、Edge、Firefox 或 Safari Cookie。
  • 登录可见、会员、年龄限制或地区限制内容，只使用用户本机已有且有权使用的会话；不得绕过 DRM、付费墙或访问控制。
  • 对小红书及其他风控站点，只允许 URL、网络请求和按需本机 Cookie 读取；公开解析失败后最多一次 Cookie 回退，仍失败就停止并让用户手动处理验证。

Trust boundary

网络边界包括用户 URL、目标站点、Spotify 公开页面、YouTube 搜索/媒体端点、GitHub 官方 yt-dlp release API，以及用户明确同意后的视频号固定解析器。浏览器 Cookie、微信登录态、抓包、解密 key 和签名媒体 URL 不得上传或出现在日志与报告中。视频号后端仅从锁定的上游官方 Release 下载并校验 SHA-256。

Rollback boundary

普通下载使用 --no-overwrites，只清理本次任务新产生的格式分片。视频号流程只停止本次启动且 PID 与路径匹配的后端，系统 HTTP/HTTPS/SOCKS 代理按启动前快照逐项恢复；视频、后端缓存、用户配置和证书不自动删除。

资源

Copyright (c) 向阳乔木 · X · GitHub

评论

支持 Markdown