RedNote MCP

RedNote MCP - Herramienta de Búsqueda de Contenido de Xiaohongshu

Resumen

RedNote MCP es un servidor de Protocolo de Contexto de Modelo (MCP) para buscar y recuperar contenido de la plataforma Xiaohongshu (Libro Rojo). Proporciona extracción inteligente de contenido con gestión automática de inicio de sesión y capacidades de procesamiento en paralelo.

Características

• Búsqueda Inteligente: Búsqueda de contenido basada en palabras clave en Xiaohongshu
• Inicio de Sesión Automático: Gestión automática de cookies y manejo de inicio de sesión
• Procesamiento en Paralelo: Recuperación eficiente de contenido concurrente
• Extracción de Datos Enriquecidos:
  • Títulos y contenido de notas
  • Información y descripciones del autor
  • Métricas de interacción (me gusta, favoritos, comentarios)
  • Imágenes y hashtags
  • Enlaces directos a notas

Stack Técnico

• Runtime: Node.js con TypeScript
• Automatización de Navegador: Playwright
• Protocolo: SDK de Protocolo de Contexto de Modelo (MCP)
• Validación: Validación de esquema Zod
• Gestor de Paquetes: pnpm

Estructura de Datos

interface RedBookNote {
  title: string;        // Note title
  content: string;      // Note content
  author: string;       // Author name
  authorDesc?: string;  // Author description
  link: string;         // Note URL
  likes?: number;       // Like count
  collects?: number;    // Favorite count
  comments?: number;    // Comment count
  tags?: string[];      // Hashtag list
  images?: string[];    // Image URLs (WebP format)
}

Instalación

Requisitos Previos

• Node.js 18+
• Gestor de paquetes pnpm

Configuración

1. Clonar el repositorio:

git clone <repository-url>
cd rednote-mcp

2. Instalar dependencias:

pnpm install

3. Instalar navegadores de Playwright:

pnpm exec playwright install

4. Compilar el proyecto:

pnpm build

Uso

Ejecutar el Servidor MCP

pnpm start

Modo de Desarrollo

pnpm dev

Pruebas

pnpm test

Configuración del Cliente MCP

Claude Desktop

Agregue la siguiente configuración a su archivo de configuración de Claude Desktop:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "rednote-mcp": {
      "command": "node",
      "args": [
        "C:\\ABSOLUTE\\PATH\\TO\\rednote-mcp\\build\\index.js"
      ]
    }
  }
}

Para usuarios de macOS/Linux:

{
  "mcpServers": {
    "rednote-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/rednote-mcp/build/index.js"
      ]
    }
  }
}

Reemplace la ruta con su directorio real del proyecto.

Otros Clientes MCP

Para otros clientes compatibles con MCP, use el archivo de servidor compilado:

node build/index.js

Uso de la Herramienta

Una vez configurado, puede usar la herramienta de búsqueda en su cliente MCP:

Search for "food recommendation" on Xiaohongshu

La herramienta devolverá datos estructurados que incluyen títulos, contenido, información del autor e imágenes.

Notas Importantes

• Primera Ejecución: Se requiere inicio de sesión manual en Xiaohongshu en el primer uso
• Rendimiento: Las búsquedas iniciales pueden tardar 30-60 segundos debido al inicio del navegador y la carga de contenido
• Límite de Velocidad: Las solicitudes concurrentes están limitadas a 3 para evitar restricciones de la plataforma
• Formato de Imágenes: Las imágenes se proporcionan en formato WebP
• Gestión de Cookies: El estado de inicio de sesión se guarda y reutiliza automáticamente

Desarrollo

Estructura del Proyecto

rednote-mcp/
├── src/
│   ├── index.ts          # MCP server entry point
│   └── xiaohongshu.ts    # Core scraping logic
├── cookies/              # Auto-generated cookie storage
├── results/              # Optional: saved search results
├── build/                # Compiled JavaScript output
├── package.json
├── tsconfig.json
└── README.md

Scripts Disponibles

• pnpm build - Compilar TypeScript a JavaScript
• pnpm start - Ejecutar el servidor MCP compilado
• pnpm dev - Modo de desarrollo con recarga automática
• pnpm test - Ejecutar pruebas (si están disponibles)
• pnpm clean - Limpiar directorio de compilación

Solución de Problemas

Problemas Comunes

1. Inicio de Sesión Requerido: Si ve avisos de inicio de sesión, elimine el directorio cookies/ y reinicie
2. Errores de Tiempo de Espera: Aumente la configuración de tiempo de espera del cliente MCP
3. Navegador No Encontrado: Ejecute pnpm exec playwright install para instalar navegadores
4. Errores de Permisos: Asegúrese de que el directorio del proyecto tenga permisos adecuados de lectura/escritura

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulte el archivo LICENSE para más detalles.

Aviso Legal

Esta herramienta es para fines educativos y de investigación. Por favor, respete los términos de servicio y los límites de velocidad de Xiaohongshu al usar esta herramienta.