JoeanAmier/XHS-Downloader

해결하는 문제

샤오홍슈(RedNote라고도 함)는 사용자가 사진, 비디오, 텍스트 게시물을 공유하는 소셜 플랫폼입니다. 이러한 게시물을 직접 다운로드할 수 있는 공식적인 방법은 없습니다. 이 도구는 사용자가 게시물 링크를 붙여넣고 이미지, 비디오, 커버, 라이브 사진 등 다운로드 가능한 모든 콘텐츠를 자동으로 추출하여 로컬에 저장할 수 있게 함으로써 이 문제를 해결합니다. 또한 여러 링크를 동시에 처리하고 이미 다운로드된 파일을 건너뛸 수 있습니다.

작동 방식

이 프로그램은 샤오홍슈 게시물 URL(xhslink.com과 같은 단축 링크 포함)을 구문 분석한 다음 플랫폼의 웹 데이터를 사용하여 게시물의 정보와 다운로드 링크를 가져옵니다. 사용 방법은 여러 가지가 있습니다:

• 대화형 사용을 위한 그래픽 사용자 인터페이스(GUI) 및 터미널 사용자 인터페이스(TUI).
• 스크립트 또는 대량 다운로드를 위한 명령줄 모드.
• 로컬 서버(포트 5556)를 실행하고 다른 프로그램이 HTTP를 통해 게시물 데이터를 요청하거나 다운로드를 트리거할 수 있는 API 모드.
• AI 어시스턴트 및 유사한 도구가 다운로더를 호출할 수 있도록 하는 MCP(모델 컨텍스트 프로토콜) 모드.
• 발견 페이지, 사용자 프로필, 검색 등에서 게시물 링크를 추출하고 실행 중인 프로그램에 다운로드 작업을 푸시할 수 있는 브라우저 사용자 스크립트(Tampermonkey용).

구성은 settings.json 파일에 저장되며, 프로그램은 쿠키(선택 사항이지만 비디오 품질을 향상시킴)를 읽고 필요한 경우 프록시를 사용할 수 있습니다. 또한 플랫폼에 과부하를 방지하기 위한 지연 메커니즘이 있습니다.

대상 사용자

개인 아카이브, 연구 또는 기타 합법적인 목적으로 샤오홍슈에서 콘텐츠를 다운로드하려는 모든 사람을 대상으로 합니다. API 및 MCP 인터페이스를 제공하고 소스 코드를 라이브러리로 사용할 수 있으므로 샤오홍슈 콘텐츠 검색을 자체 애플리케이션에 통합하려는 개발자에게도 유용합니다.

주요 기능

• 여러 실행 방법: GUI, TUI, CLI, Docker, API 서버, MCP 서버.
• 이미지, 비디오(쿠키를 제공하면 더 높은 품질), 비디오 커버, 라이브 사진을 다운로드할 수 있습니다.
• 일괄 처리: 여러 링크를 한 번에 제공할 수 있습니다.
• 이미 다운로드된 파일을 자동으로 건너뛰고 다운로드된 게시물 ID를 기록합니다.
• 파일 이름 및 폴더 구조를 사용자 정의할 수 있습니다. 각 작성자의 게시물을 별도의 폴더에 저장할 수 있습니다.
• 인덱스 목록을 통해 여러 이미지 게시물에서 특정 이미지만 다운로드하는 것을 지원합니다.
• 브라우저 사용자 스크립트는 사이트의 많은 부분에서 게시물 링크를 추출하여 메인 프로그램에 푸시할 수 있습니다.
• 무단 사용을 방지하기 위해 API 및 MCP 액세스에 대한 인증이 포함되어 있습니다.