XHS-Downloader

Vue d'ensemble

XHS-Downloader (par JoeanAmier) est un outil Python open-source populaire dédié à Xiaohongshu (小红书, aussi connu sous le nom de REDnote ou XHS). Il excelle dans l'extraction de liens, la collecte d'informations sur les notes et le téléchargement de fichiers multimédias de haute qualité (images, vidéos, Live Photos) sans filigrane.

Le projet prend en charge les opérations par lots pour les publications utilisateur, les collections, les likes, les albums et les résultats de recherche. Il inclut de manière importante un mode serveur MCP (Model Context Protocol) natif, permettant aux agents d'intelligence artificielle et assistants de codage (comme Claude Desktop, Cursor, etc.) de contrôler directement les tâches de téléchargement, d'extraction et de collecte de contenu.

Fonctionnalités Clés

• Extraction de liens : Extraire les publications, favoris, likes, liens d'albums, résultats de recherche et liens utilisateur.
• Collecte d'informations sur les notes : Rassembler les métadonnées détaillées des notes Xiaohongshu.
• Téléchargements sans filigrane : Télécharger images, vidéos et Live Photos en haute qualité.
• Opérations par lots & déduplication : Saut automatique des notes déjà téléchargées grâce à une base de données locale.
• Mode Serveur MCP : Exécuter en tant que serveur MCP (python main.py mcp) pour une intégration avec les agents IA.
• Reprise de point d'arrêt & Nommage personnalisé : Prise en charge des téléchargements reprenables et formats de nom de fichier personnalisables.
• Support API & Scripts utilisateur : Fonctionne avec les scripts utilisateur du navigateur pour un envoi de tâche en un clic.
• Modes CLI + GUI : Exécution facile du programme ou exécution du code source.

Fonctionnement (Mode MCP)

1. Lancez le serveur MCP :

   python main.py mcp
   

2. Le serveur écoute à http://127.0.0.1:5556/mcp/ (ou sur le port configuré).
3. Ajoutez le serveur MCP à la configuration de votre client IA.
4. Les agents IA peuvent appeler des outils pour extraire des liens, collecter des données de note, ou déclencher des téléchargements directement.

Cela fait de XHS-Downloader un backend puissant pour les flux de travail agentiques impliquant du contenu Xiaohongshu.

Cas d'utilisation

• Archivage de contenu piloté par IA : Permettre aux agents IA de collecter et télécharger automatiquement des notes ou sujets utilisateur spécifiques.
• Téléchargement de médias par lots : Recherche, curation ou sauvegarde à grande échelle de publications Xiaohongshu. . Sauvegarde de médias sans filigrane : Obtenir des ressources propres pour un usage personnel, éducatif ou créatif.
• Pipelines de collecte de données : S'intégrer avec d'autres outils MCP pour la recherche ou l'analyse des tendances XHS.
• Scripts d'automatisation : Combiner avec les scripts utilisateur du navigateur pour un flux de travail transparent.

Démarrage

Exécution Rapide (Recommandée)

• Téléchargez la dernière version depuis GitHub Releases.
• Dézippez et exécutez le fichier exécutable (main sous Windows/macOS).

Code Source + Mode MCP

git clone https://github.com/JoeanAmier/XHS-Downloader.git
cd XHS-Downloader
pip install -r requirements.txt
python main.py mcp   # Démarrer le serveur MCP

Pour toutes les fonctionnalités, y compris les scripts utilisateur et l'utilisation de l'API, consultez le README.

Avantages

XHS-Downloader se distingue par sa fiabilité, la déduplication, les téléchargements repriseables et la prise en charge directe de MCP — ce qui en fait l'un des outils open-source les plus avancés pour la gestion de contenu de Xiaohongshu. Il sert efficacement tant les utilisateurs manuels que les écosystèmes d'agents d'IA, tout en restant léger et activement maintenu.

Note: À utiliser de manière responsable et dans le respect des conditions d'utilisation et des droits d'auteur de Xiaohongshu.