小红书 MCP | Xiaohongshu MCP | XHS MCP | RedNote MCP

Este repositorio público proporciona un puente MCP mínimo además de documentación de conexión pública para un servicio alojado de 小红书 MCP / Xiaohongshu MCP / XHS MCP / RedNote MCP.

Si está buscando un 小红书 MCP, Xiaohongshu MCP, XHS MCP o RedNote MCP para flujos de trabajo de investigación en redes sociales, este repositorio incluye:

• un puente stdio local mínimo para clientes MCP e inspección en Glama

• metadatos MCP públicos y ejemplos de configuración de cliente

• el endpoint streamable-http alojado directamente para clientes que ya admiten MCP remoto

La implementación empresarial está alojada de forma privada. Este repositorio expone solo la superficie de conexión pública para flujos de trabajo de inteligencia de redes sociales de solo lectura.

Alias de búsqueda

Frases de búsqueda comunes para este servicio MCP:

• 小红书 MCP

• 小红书 XHS MCP

• Xiaohongshu MCP

• XHS MCP

• RedNote MCP

• Xiaohongshu note search MCP

Related MCP server: RedNote MCP Server

Servicio

• Endpoint MCP ascendente alojado: https://mcp.52choujiang.com/xhs/mcp

• Transporte ascendente alojado: streamable-http

• Autenticación: Authorization: Bearer <XHS_MCP_API_KEY>

• Sitio web: https://52choujiang.com/assistant

• Nombre de registro: com.52choujiang/xhs-insights

• Versión actual de capacidad pública: 0.1.3

Puente

Este repositorio también incluye un puente stdio local mínimo. Reenvía las solicitudes MCP al servicio ascendente alojado y mantiene el repositorio público ejecutable para la inspección del servidor Glama y los clientes MCP que prefieren servidores basados en comandos.

El puente no contiene la implementación del servicio privado. Solo retransmite el tráfico MCP al endpoint alojado.

Entorno del puente

• XHS_MCP_API_KEY Requerido para llamadas a herramientas autenticadas. Los métodos de descubrimiento como initialize y tools/list aún pueden inspeccionarse sin una clave.

• XHS_MCP_UPSTREAM_URL Anulación opcional para la URL ascendente alojada. Predeterminado: https://mcp.52choujiang.com/xhs/mcp

Ejecución local

npm install
XHS_MCP_API_KEY="<your_api_key>" npm start

Ejecución en Docker

docker build -t xhs-mcp-bridge .
docker run --rm -i -e XHS_MCP_API_KEY="<your_api_key>" xhs-mcp-bridge

Si Docker Hub es lento desde su red, mantenga la imagen predeterminada sin cambios para el uso normal y anúlela solo durante las compilaciones locales:

docker build --build-arg NODE_IMAGE=mirror.gcr.io/library/node:20-alpine -t xhs-mcp-bridge .

Alcance de solo lectura

Este servicio MCP está diseñado para flujos de trabajo de inteligencia de redes sociales de solo lectura. No proporciona inicio de sesión en cuentas, publicación, edición, dar "me gusta", comentar u otras acciones de cuenta.

Los flujos de trabajo admitidos incluyen:

• Buscar notas de Xiaohongshu relacionadas por palabra clave.

• Resolver un enlace de nota compartido o texto compartido en detalles de nota estructurados.

• Leer detalles de notas cuando el llamador ya tiene un ID de nota.

• Obtener comentarios de primer nivel paginados para el análisis de comentarios.

• Leer datos del perfil del creador desde un enlace de perfil o ID de usuario.

• Obtener listas de notas de creadores paginadas para el estilo de contenido y la investigación de cuentas.

Herramientas

Inicio rápido

Para clientes MCP basados en comandos, utilice el puente local publicado por este repositorio:

{
  "mcpServers": {
    "xiaohongshu-xhs-rednote-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "github:DevinChen2014/xiaohongshu-xhs-rednote-mcp"
      ],
      "env": {
        "XHS_MCP_API_KEY": "<XHS_MCP_API_KEY>"
      }
    }
  }
}

Para clientes que ya admiten streamable-http autenticado, utilice el endpoint ascendente alojado directamente. Un ejemplo listo para copiar está disponible en examples/streamable_http_config.json.

Ejemplos de cliente

Los ejemplos de configuración están disponibles en examples:

• Configuración de MCP genérica basada en comandos

• Configuración del puente de Claude Desktop

• Configuración del puente de Cursor

• Configuración del puente de Codex

• Configuración directa de HTTP streamable

Clave de API

Solicite o gestione el acceso a la API desde el sitio web del producto:

https://52choujiang.com/assistant

Utilice la clave como token Bearer en el encabezado de solicitud Authorization. No confirme claves de API reales en código, documentos, problemas o capturas de pantalla.

Metadatos del directorio

Archivos de metadatos públicos en este repositorio:

• server-card.json: metadatos de estilo de registro MCP para el servicio ascendente alojado.

• mcp.json: configuración genérica basada en comandos para el puente local en este repositorio.

• glama.json: metadatos de propiedad del repositorio de Glama.

• SUBMISSION_CHECKLIST.md: lista de verificación para envíos al directorio MCP.

Licencia

Los archivos en este repositorio público se publican bajo la Licencia MIT. La licencia cubre solo el contenedor del puente público, la documentación y los ejemplos de configuración en este repositorio. No cubre la implementación del servicio gestionado, la infraestructura alojada ni ningún código de backend privado fuera de este repositorio.