JoeanAmier/XHS-Downloader

小红书(XiaoHongShu、RedNote)链接提取/作品采集工具

해결하는 문제

XHS-Downloader는 소셜 미디어 플랫폼인 Xiaohongshu (RedNote)에서 콘텐츠를 추출하고 다운로드하도록 설계된 도구입니다. 작업 정보를 자동으로 수집하고 파일을 일괄 다운로드하는 방법을 제공하여 게시물, 이미지 및 동영상을 수동으로 저장해야 하는 문제를 해결합니다.

작동 방식

이 프로젝트는 세 가지 주요 인터페이스를 통해 작동합니다:

  1. 독립형 애플리케이션: 실행 파일 또는 Python/Docker를 통해 실행할 수 있는 TUI (Terminal User Interface) 프로그램입니다. 클립보드의 링크를 모니터링하여 콘텐츠를 자동으로 다운로드할 수 있습니다.
  2. 사용자 스크립트: 브라우저에서 실행되는 Tampermonkey 스크립트로, 추천 페이지, 사용자 프로필, 컬렉션 및 검색 결과에서 링크를 추출하여 메인 프로그램으로 전송하여 다운로드할 수 있습니다.
  3. 서버 모드: API 서버 또는 MCP (Model Context Protocol) 서버로 배포할 수 있어, 다른 애플리케이션이나 AI 에이전트가 게시물 상세 정보를 요청하고 다운로드를 트리거할 수 있습니다.

대상 사용자

  • 콘텐츠 크리에이터 및 연구자: 분석 또는 백업을 위해 Xiaohongshu 게시물, 이미지 및 동영상을 아카이브해야 하는 분.
  • 개발자: API 또는 MCP를 통해 Xiaohongshu 데이터 추출을 자신의 워크플로우에 통합하려는 사용자.
  • 일반 사용자: 수동 작업 없이 플랫폼에서 고품질 미디어를 간단하게 다운로드하고 싶은 분.

주요 특징

  • 포괄적인 추출: 게시된 작품, 컬렉션, 좋아요, 앨범 및 검색 결과에서 링크 추출을 지원합니다.
  • 유연한 다운로드: 이미지, 동영상 및 LivePhotos를 지원하며 파일 이름과 형식(PNG, WEBP, JPEG, HEIC)을 사용자 정의할 수 있습니다.
  • 통합 준비 완료: 프로그래밍 방식의 액세스를 위해 API 모드와 MCP 모드를 제공합니다.
  • 자동화: 클립보드 모니터링 및 브라우저 스크립트 통합을 통해 원클릭 작업 전송 기능을 제공합니다.
  • 스마트 관리: 이미 다운로드된 파일을 건너뛰는 메커니즘과 파일을 작성자별로 별도 폴더에 정리하는 기능을 포함합니다.

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트