XHS-Downloader

Descripción general

XHS-Downloader (por JoeanAmier) es una popular herramienta de código abierto en Python dedicada a Xiaohongshu (小红书, también conocida como REDnote o XHS). Se destaca en la extracción de enlaces, la recopilación de información de notas y la descarga de archivos multimedia de alta calidad (imágenes, videos, fotos en vivo) sin marcas de agua.

El proyecto admite operaciones por lotes para publicaciones de usuarios, colecciones, "me gusta", álbumes y resultados de búsqueda. Es importante destacar que incluye un modo nativo de servidor MCP (Model Context Protocol), permitiendo que agentes de programación de IA y asistentes (como Claude Desktop, Cursor, etc.) controlen directamente las tareas de descarga, extracción y recolección de contenido.

Características principales

• Extracción de enlaces: Extraer publicaciones, favoritos, "me gusta", enlaces de álbumes, resultados de búsqueda y enlaces de usuarios.
• Recopilación de información de notas: Recopilar metadatos detallados para las notas de Xiaohongshu.
• Descargas sin marca de agua: Descargar imágenes, videos y fotos en vivo en alta calidad.
• Lotes y deduplicación: Omisión automática de notas previamente descargadas mediante una base de datos local.
• Modo servidor MCP: Ejecutar como servidor MCP (python main.py mcp) para integración con agentes de IA.
• Reanudación de puntos de interrupción y nomenclatura personalizada: Soporte para descargas reanudables y formatos de nombres de archivo personalizables.
• Soporte para API y scripts de usuario: Funciona con userscripts del navegador para empujar tareas con un clic.
• Modos CLI + GUI: Ejecución fácil del programa o ejecución del código fuente.

Cómo funciona (Modo MCP)

1. Ejecuta el servidor MCP:

   python main.py mcp
   

2. El servidor escucha en http://127.0.0.1:5556/mcp/ (o puerto configurado).
3. Agrega el servidor MCP a la configuración de tu cliente de IA.
4. Los agentes de IA pueden llamar herramientas para extraer enlaces, recopilar datos de notas o activar descargas directamente.

Esto convierte a XHS-Downloader en un potente backend para flujos de trabajo agénticos que involucran contenido de Xiaohongshu.

Casos de uso

• Archivado de contenido impulsado por IA: Permitir que agentes de IA recopilen y descarguen automáticamente notas o temas específicos de usuarios.
• Descarga de medios por lotes: Investigación, curación o respaldo de publicaciones de Xiaohongshu a gran escala.
• Guardado de medios sin marca de agua: Obtener recursos limpios para uso personal, educativo o creativo.
• Canalizaciones de recolección de datos: Integrar con otras herramientas MCP para investigación o análisis de tendencias en XHS.
• Scripts de automatización: Combinar con userscripts del navegador para un flujo de trabajo fluido.

Primeros pasos

Ejecución rápida (Recomendado)

• Descarga la última versión desde GitHub Releases.
• Descomprime y ejecuta el ejecutable (main en Windows/macOS).

Código fuente + Modo MCP

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

Para todas las funciones, incluidos los scripts de usuario y el uso de la API, consulta el README.

Beneficios

XHS-Downloader destaca por su fiabilidad, deduplicación, descargas reanudables y soporte directo para MCP, lo que lo convierte en una de las herramientas de código abierto más avanzadas para el manejo de contenido de Xiaohongshu. Sirve de manera efectiva tanto a usuarios manuales como a ecosistemas de agentes de IA, manteniéndose ligero y en mantenimiento activo.

Nota: Úsalo de forma responsable y respeta los términos de servicio y los derechos de autor de Xiaohongshu.