joeseesun/qiaomu-download

何を解決するか

さまざまなオンラインプラットフォームからのメディアダウンロードプロセスを簡素化し、ユーザーがAIエージェントに自然言語のコマンド（例：「このURLをダウンロード」）を送ることでダウンロードをトリガーできるようにします。これにより、複雑なコマンドを覚える必要がなくなり、サードパーティのパースサイトを使用する必要も、手動でオーディオ/ビデオストリームを選択する必要もありません。

動作方法

このプロジェクトはAIエージェントの「スキル」として機能し、一般のメディア抽出には yt-dlp を、WeChat Channels や Spotify などの特定プラットフォームには専用アダプタを使用します。プライバシーを最優先する「公開情報優先」戦略を採用しており、ブラウザのクッキーを要求する前に匿名パースを試みます。品質を確保するために、ffprobe を使ってダウンロードされたファイルが再生可能で、期待されるストリーム、解像度、再生時間を持っていることを検証し、成功を確認します。また、変化するウェブサイト構造に対応するため、最新の yt-dlp ステーブルリリースをチェックして自動更新する仕組みも備えています。

対象ユーザー

YouTube、Bilibili、X（Twitter）、TikTok、Instagram、WeChat などのプラットフォームから動画、音声、字幕を手軽に保存したいが、手動のコマンドラインツールや危険なUI自動化に悩まされたくないユーザー。

特徴

• 一文でトリガー: 「このURLをダウンロード」や「このURLを保存」などの簡単なフレーズとURLを組み合わせて使用可能。
• 広範なプラットフォーム対応: YouTube、Bilibili、X、TikTok、Instagram など数十のサイトに対応。
• ダウンロード後検証: ffprobe を使ってファイルの整合性と再生可能性を検証。
• 安全最優先アプローチ: WeChat や Xiaohongshu などの敏感なプラットフォームではUI自動化（コンピュータ使用）を明示的に回避し、アカウントの禁止を防ぎます。
• Spotify統合: Spotifyのトラックメタデータを、YouTubeからの高信頼性の公開音声ソースと照合。
• 自動更新エンジン: 新バージョンリリース時に、システムのパッケージマネージャー経由で yt-dlp を自動アップグレード。