joeseesun/qiaomu-download

해결하는 문제

사용자가 AI 에이전트에게 자연어 명령어(예: "이 URL을 다운로드해줘")를 입력함으로써 다양한 온라인 플랫폼에서 미디어를 다운로드하는 과정을 단순화합니다. 복잡한 명령어를 외우거나, 제3자 파싱 웹사이트를 사용하거나, 수동으로 오디오/비디오 스트림을 선택할 필요 없이 간편하게 다운로드할 수 있습니다.

작동 방식

이 프로젝트는 AI 에이전트의 "스킬"으로 작동하며, 일반적인 미디어 추출에는 yt-dlp를 사용하고, WeChat 채널, Spotify와 같은 특정 플랫폼에는 전용 어댑터를 활용합니다. 익명 파싱을 우선 시하는 "공개 정보 우선" 개인정보 보호 전략을 따르며, 브라우저 쿠키 요청 전에 익명 파싱을 시도합니다. 품질을 보장하기 위해 ffprobe를 사용해 다운로드된 파일이 재생 가능하고, 예상되는 스트림, 해상도, 재생 시간을 포함하고 있는지 검증한 후 성공을 확인합니다. 또한, 웹사이트 구조 변화에 대응하기 위해 최신 yt-dlp 안정 버전을 자동으로 확인하고 업데이트하는 기능을 포함하고 있습니다.

대상 사용자

YouTube, Bilibili, X(Twitter), TikTok, Instagram, WeChat 등에서 동영상, 오디오, 자막을 수동 명령줄 도구나 위험한 UI 자동화 없이 간편하게 저장하고 싶은 사용자.

주요 특징

• 한 문장 트리거: "이걸 다운로드해줘" 또는 "이걸 저장해줘"와 같은 간단한 문장에 URL을 추가해 사용 가능.
• 광범위한 플랫폼 지원: YouTube, Bilibili, X, TikTok, Instagram 등 수십 개의 사이트를 통합 지원.
• 다운로드 후 검증: ffprobe를 사용해 파일 무결성과 재생 가능성을 검증.
• 안전 우선 접근법: WeChat 및 Xiaohongshu와 같은 민감한 플랫폼에서 UI 자동화(컴퓨터 사용)를 명시적으로 회피하여 계정 정지 위험을 방지.
• Spotify 통합: Spotify 트랙 메타데이터를 YouTube에서 제공하는 고신뢰도 공개 오디오 소스와 정확히 매칭.
• 자동 업데이트 엔진: 새 버전이 출시되면 시스템 패키지 매니저를 통해 yt-dlp를 자동으로 업그레이드.