joeseesun/qiaomu-download

What it solves

It simplifies the process of downloading media from various online platforms by allowing a user to trigger downloads via a simple natural language command (e.g., "Download this: [URL]") given to an AI agent, removing the need to remember complex commands, use third-party parsing websites, or manually select audio/video streams.

How it works

The project acts as a "Skill" for an AI agent, leveraging yt-dlp for general media extraction and specialized adapters for platforms like WeChat Channels and Spotify. It follows a "public first" privacy strategy, attempting anonymous parsing before requesting browser cookies. To ensure quality, it uses ffprobe to verify that downloaded files are playable and contain the expected streams, resolution, and duration before confirming success. It also includes an automatic update mechanism that checks for the latest yt-dlp stable releases to maintain compatibility with changing website structures.

Who it’s for

Users who want a streamlined, agent-driven way to save videos, audio, or subtitles from platforms like YouTube, Bilibili, X (Twitter), TikTok, Instagram, and WeChat without dealing with manual command-line tools or risky UI automation.

Highlights

• One-sentence trigger: Works with simple phrases like "Download this" or "Save this" followed by a URL.
• Broad platform support: Integrated support for dozens of sites including YouTube, Bilibili, X, TikTok, and Instagram.
• Post-download verification: Uses ffprobe to validate file integrity and playback capability.
• Safety-first approach: Explicitly avoids UI automation (Computer Use) for sensitive platforms like WeChat and Xiaohongshu to prevent account bans.
• Spotify integration: Matches Spotify track metadata with high-confidence public audio sources from YouTube.
• Auto-updating engine: Automatically upgrades yt-dlp via the system's package manager when new versions are released.