XHS-Downloader

Überblick

XHS-Downloader (von JoeanAmier) ist ein beliebtes Open-Source-Python-Tool für Xiaohongshu (小红书, auch bekannt als REDnote oder XHS). Es zeichnet sich durch Link-Extraktion, Erfassung von Notizen-Informationen und den Download hochwertiger Mediendateien (Bilder, Videos, Live Photos) ohne Wasserzeichen aus.

Das Projekt unterstützt Stapelverarbeitungen für Nutzerbeiträge, Sammlungen, Likes, Alben und Suchergebnisse. Wichtig ist, dass es einen nativen MCP (Model Context Protocol) Server-Modus enthält, der es KI-Coding-Agenten und Assistenten (wie Claude Desktop, Cursor, etc.) ermöglicht, Download-, Extraktions- und Inhaltserfassungsaufgaben direkt zu steuern.

Hauptmerkmale

• Link-Extraktion: Extrahiere veröffentlichte Beiträge, Favoriten, Likes, Album-Links, Suchergebnisse und Nutzerlinks.
• Notizen-Informationen Erfassung: Sammle detaillierte Metadaten für Xiaohongshu Notizen.
• Downloads ohne Wasserzeichen: Lade Bilder, Videos und Live Photos in hoher Qualität herunter.
• Stapelverarbeitung & Deduplizierung: Automatisches Überspringen bereits heruntergeladener Notizen mithilfe einer lokalen Datenbank.
• MCP Server-Modus: Als MCP-Server ausführen (python main.py mcp) für die KI-Agenten-Integration.
• Unterbrechungsfortsetzung & Benutzerdefinierte Benennung: Unterstützung für wiederaufnehmbare Downloads und anpassbare Dateinamenformate.
• API & Nutzer-Skript Unterstützung: Funktioniert mit Browser-Userscripts für Ein-Klick-Aufgabenweitergabe.
• CLI + GUI Modi: Einfache Programmausführung oder Quellcode-Ausführung.

Funktionsweise (MCP-Modus)

1. Starte den MCP-Server:

   python main.py mcp
   

2. Der Server lauscht auf http://127.0.0.1:5556/mcp/ (oder konfiguriertem Port).
3. Füge den MCP-Server zu deiner KI-Client-Konfiguration hinzu.
4. KI-Agenten können Tools aufrufen, um Links zu extrahieren, Notizendaten zu sammeln oder Downloads direkt auszulösen.

Dadurch wird XHS-Downloader zu einer leistungsstarken Backend-Komponente für agentenbasierte Workflows mit Xiaohongshu-Inhalten.

Anwendungsfälle

• KI-gestütztes Content-Archivieren: Lass KI-Agenten automatisch bestimmte Nutzernotizen oder Themen sammeln und herunterladen.
• Stapel-Medien-Download: Recherche, Kuratierung oder Sicherung von Xiaohongshu-Beiträgen in großem Umfang.
• Medienspeicherung ohne Wasserzeichen: Erhalte saubere Medienressourcen für persönliche, pädagogische oder kreative Nutzung.
• Datenerfassungs-Pipelines: Integration mit anderen MCP-Tools zur Erforschung oder Analyse von XHS-Trends. . -mation Scripts**: Kombination mit Browser-Userscripts für nahtlose Workflows.

Erste Schritte

Schnellstart (Empfohlen)

• Lade die neueste Version von GitHub Releases herunter.
• Entpacke und führe die ausführbare Datei aus (main unter Windows/macOS).

Quellcode + MCP-Modus

git clone https://github.com/JoeanAmier/XHS-Downloader.git
cd XHS-Downloader
pip install -r requirements.txt
python main.py mcp   # Starte MCP-Server

Für alle Funktionen inklusive Nutzer-Skripts und API-Nutzung, siehe die README.

Vorteile

XHS-Downloader zeichnet sich durch Zuverlässigkeit, Deduplizierung, unterbrechbare Downloads und direkte MCP-Unterstützung aus – was ihn zu einem der fortschrittlichsten Open-Source-Tools für die Handhabung von Xiaohongshu-Inhalten macht. Er eignet sich gleichermaßen für manuelle Nutzer und KI-Agenten-Ökosysteme, bleibt dabei leichtgewichtig und wird aktiv gepflegt.

Hinweis: Nutzen Sie das Tool verantwortungsbewusst und beachten Sie die Nutzungsbedingungen sowie Urheberrechte von Xiaohongshu.