4kvm-downloader은(는) 무엇을 하나요?
4kvm.net에서 비디오를 다운로드하는 Python 라이브러리 또는 CLI 도구로, Tencent COS 안티-스크래핑 보호를 우회하여 AI 에이전트 통합을 지원합니다.
개요
이 도구는 4kvm.net 비디오 호스팅 플랫폼에서 콘텐츠를 다운로드하는 과정을 단순화합니다. Tencent COS가 구현한 안티-스크래핑 보호를 처리하여 AI 에이전트와 개발자가 비디오 데이터에 안정적으로 접근할 수 있도록 합니다.
설치
pip를 사용하여 설치:
pip install git+https://github.com/Weilandt9459/4kvm-downloader.git
사용법
Python 라이브러리로 사용
from kvm_downloader import download_video
# 단일 비디오 다운로드
download_video("https://4kvm.net/video/example", output="example.mp4")
CLI로 사용
python -m kvm_downloader https://4kvm.net/video/example -o example.mp4
특징
- 안티-스크래핑 우회: Tencent COS 챌린지 및 속도 제한을 자동으로 처리
- 다중 해상도 지원: 사용 가능한 경우 4K, 1080p, 720p 등 여러 해상도 선택 가능
- 배치 다운로드: URL 목록을 파일로 제공하여 여러 비디오를 한 번에 다운로드
- 진행 상황 추적: 진행 표시줄 및 다운로드 상태 업데이트 표시
AI 에이전트 통합
AI 에이전트(예: Claude Code, Cursor, Codex)는 이 라이브러리를 사용하여 4kvm.net에서 비디오 다운로드를 자동화할 수 있습니다. 다음은 예시입니다:
# AI 에이전트 워크플로우 예시
from kvm_downloader import download_video
def fetch_video_for_analysis(url):
"""
AI 에이전트가 분석을 위해 4kvm.net에서 비디오를 다운로드
"""
local_path = download_video(url, output="temp_video.mp4")
# 다운로드된 비디오로 추가 처리...
return local_path
구성
환경 변수:
KVM_DOWNLOADER_OUTPUT_DIR: 다운로드된 파일의 기본 출력 디렉터리 (기본값: 현재 디렉터리)KVM_DOWNLOADER_USER_AGENT: 요청에 사용할 사용자 에이전트 문자열 재정의
문제 해결
다운로드 문제가 발생하면:
python -m kvm_downloader --debug를 사용하여 디버그 로깅 활성화- URL이 유효하고 4kvm.net에서 접근 가능한지 확인
- 네트워크 연결이 안정적인지 확인
라이선스
MIT 라이선스