XHS Downloader

XHS-Downloader es una herramienta que extrae enlaces y descarga el contenido publicado en Xiaohongshu (también conocida como XiaoHongShu o RedNote): publicaciones de una cuenta, favoritos, me gusta, álbumes, resultados de búsqueda y perfiles de usuario. A partir de un enlace de una publicación obtiene la información completa de la obra y las direcciones de descarga de sus archivos, y puede bajar directamente las imágenes, vídeos o livePhotos asociados.

En modo MCP, el servidor expone esa misma funcionalidad a un agente: consultar los datos de una publicación a partir de su URL y descargar sus archivos, incluyendo la posibilidad de elegir qué imágenes concretas de una publicación con varias fotos se quieren bajar. El comportamiento (formato de nombre de archivo, carpetas por autor, formato de imagen, etc.) se controla desde el archivo de configuración settings.json del proyecto.

Para ponerlo en marcha se ejecuta el proyecto en modo servidor con `python main.py mcp`, ya sea desde el código fuente o mediante la imagen Docker oficial, exponiendo un endpoint Streamable HTTP en `http://127.0.0.1:5556/mcp/`. La configuración de Cookie de Xiaohongshu es opcional, pero sin ella los vídeos solo se descargan en baja resolución.