# XHS-Downloader

XHS-Downloader es una potente herramienta de código abierto para extraer enlaces, recopilar información y descargar imágenes, videos y notas sin marca de agua de Xiaohongshu (Little Red Book / REDnote / XHS). Incluye soporte integrado para servidor MCP, permitiendo que los agentes de IA automaticen la recolección y descarga de contenido.

Canonical URL: https://a2a-mcp.org/entry/xhs-downloader-es

Language: es

Category: MCP Servers

Updated: 2026-04-11

## 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:
   ```bash
   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](https://github.com/JoeanAmier/XHS-Downloader/releases).
- Descomprime y ejecuta el ejecutable (`main` en Windows/macOS).

### Código fuente + Modo MCP
```bash
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](https://github.com/JoeanAmier/XHS-Downloader/blob/master/README_EN.md).

## 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.

## Tags

- xhs
- xiaohongshu
- rednote
- descargador
- mcp
- servidor-mcp
- python
- scraper
- descargador-de-videos
- descargador-de-imágenes
- sin-marca-de-agua

## Sources

- [Project website](https://github.com/JoeanAmier/XHS-Downloader)