SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

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

Este repositorio público proporciona documentación de conexión pública y metadatos de MCP para un servicio alojado de 小红书 MCP / Xiaohongshu MCP / XHS MCP / RedNote MCP.

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

• metadatos públicos de MCP y ejemplos de configuración de cliente
• el endpoint alojado streamable-http para clientes que admiten MCP remoto
• un ejemplo de respaldo mcp-remote para clientes MCP que solo admiten comandos/stdio

La implementación del negocio está alojada de forma privada. Este repositorio expone únicamente la superficie de conexión pública para flujos de trabajo de inteligencia de contenido en redes sociales.

Alias de búsqueda

Frases de búsqueda comunes para este servicio MCP:

• 小红书 MCP
• 小红书 数据 MCP
• 小红书 搜索 MCP
• 小红书 XHS MCP
• Xiaohongshu MCP
• Xiaohongshu data MCP
• XHS MCP
• XHS data MCP
• RedNote MCP
• RedNote data MCP
• Xiaohongshu note search MCP

Servicio

• Endpoint MCP alojado: https://mcp.socialdatax.com/xhs/mcp
• Transporte alojado: streamable-http
• Autenticación: Authorization: Bearer <SOCIALDATAX_API_KEY>
• Producto: SocialDataX / 社媒数据助手
• Acceso al sitio web y a la clave API: https://socialdatax.com/ai?from=github
• Nombre del registro: com.52choujiang/xhs-insights
• Nombre futuro del registro: com.socialdatax/xhs-insights
• Versión de capacidad pública actual: 0.1.15 (35 herramientas)
• Producción alojada: 0.1.15 con 35 herramientas; implementación y descubrimiento de herramientas autenticadas verificado en 2026-10-14. Las notas de video siguen disponibles a través de xhs_search_notes(note_type="video").
• Registro oficial de MCP: 0.1.15 (active, isLatest=true), publicado y verificado en 2026-10-14.
• Tarjeta pública del servidor en GitHub: 0.1.15 con 35 herramientas, sincronizada y verificada en 2026-10-14.
• El catálogo público de herramientas se mantiene en server-card.json; las versiones del puente npm son independientes del catálogo de herramientas alojado.
• Puente stdio npm: xiaohongshu-xhs-rednote-mcp@0.1.18; las versiones del paquete puente son independientes de las versiones de capacidad alojadas.

La capacidad actual incluye resolución de ID de usuario cifrado, perfiles de creadores PGY, rendimiento de notas, perfiles y resúmenes de seguidores, búsqueda de respuestas a respuestas de reseñas de productos, búsqueda de detalles de productos por URL y el cambio de nombre del campo de detalles de producto (images a main_images; detail_images permanece sin cambios).

MCP de plataforma

Usa el endpoint alojado streamable-http directamente desde clientes que admiten MCP remoto autenticado. Para clientes que solo admiten servidores MCP de comandos/stdio, usa mcp-remote como proxy de compatibilidad local.

Puente stdio npm

Requiere Node.js 20.18.1 o posterior.

Los clientes MCP que solo admiten comandos/stdio pueden instalar e iniciar el puente directamente desde npm:

{
  "mcpServers": {
    "socialdatax-xhs": {
      "command": "npx",
      "args": ["-y", "xiaohongshu-xhs-rednote-mcp"],
      "env": {
        "SOCIALDATAX_API_KEY": "<SOCIALDATAX_API_KEY>"
      }
    }
  }
}

El paquete solo reenvía mensajes MCP stdio locales al endpoint alojado de SocialDataX XHS. No contiene la implementación del servicio privado ni almacena la clave API.

El catálogo público de herramientas se puede descubrir sin una clave API. Establece SOCIALDATAX_API_KEY para llamadas de herramientas comerciales; sin ella, el puente puede iniciarse para descubrimiento, mientras que el servicio alojado requiere autenticación para datos comerciales.

Alcance del flujo de trabajo

Este servicio MCP está diseñado para flujos de trabajo de inteligencia de contenido en redes sociales. No proporciona inicio de sesión de cuenta, publicación, edición, me gusta, comentarios ni otras acciones de cuenta.

Los flujos de trabajo admitidos incluyen:

• Consultar el saldo de puntos de SocialDataX / 积分余额、剩余积分或点数 de la cuenta de la clave API actual.
• Buscar notas relacionadas de Xiaohongshu por palabra clave, con filtros opcionales de orden, tipo de nota y tiempo de publicación.
• Buscar productos de Xiaohongshu por palabra clave con continuación mediante page_token.
• Obtener detalles de producto mediante un sku_id completo proporcionado por el usuario o copiado de los resultados de búsqueda de productos.
• Obtener un detalle de nota mejorada PGY / 蒲公英 a partir de un note_id completo o un enlace de nota, enlace corto o texto compartido; las llamadas exitosas cuestan 20 puntos y los fallos no se cobran.
• PGY aplica solo a notas de creadores inscritos. Úsalo para datos comerciales solicitados; mantén las solicitudes de notas ordinarias en las herramientas de detalle ordinarias. Un resultado explícito de sin datos comerciales se trata como no inscrito (pgy_commercial_data_unavailable); detente sin reintentar la otra ruta de ID/URL. Los tiempos de espera, fallos de autenticación y saldo insuficiente mantienen sus propios errores.
• Obtener reseñas de productos mediante un sku_id completo proporcionado por el usuario o copiado de los resultados de búsqueda de productos.
• Obtener respuestas anidadas bajo una respuesta de reseña de producto mediante un review_id proporcionado por el usuario o copiado de xhs_get_product_review_replies; acepta continuación opaca page_token y no acepta root_review_id.
• Leer la lista de tendencias de búsqueda de Xiaohongshu con título y valor de calor.
• Leer sugerencias de búsqueda de Xiaohongshu para una palabra clave o frase parcial.
• Resolver un enlace de nota compartido, enlace corto o texto compartido en detalles estructurados de nota.
• Leer detalles de nota cuando el llamador ya tiene un ID de nota.
• Obtener comentarios de primer nivel paginados para análisis de comentarios.
• Obtener respuestas paginadas bajo un comentario de primer nivel.
• Leer datos de perfil de creador desde un enlace de perfil, enlace corto, texto compartido o ID de usuario.
• Obtener listas paginadas de notas de creador desde un ID de usuario, enlace de perfil, enlace corto o texto compartido para investigación de estilo de contenido y cuenta.
• Obtener listas paginadas de notas de páginas de etiqueta desde una URL de tema, enlace corto, texto compartido o ID de página.
• Enviar una tarea de transcripción de voz a texto para notas de video; la llamada de envío puede esperar hasta 240 segundos, y los trabajos no finalizados deben continuar consultando el mismo job_id hasta que terminen.

Herramientas

Herramienta	Propósito público
socialdatax_get_points_balance	Consultar el saldo de puntos / 积分余额, puntos restantes o créditos de SocialDataX de la cuenta de la API Key actual.
xhs_search_users	Buscar usuarios, cuentas o creadores de Xiaohongshu / 小红书 por palabra clave con paginación page_token. Cuando ya se dispone de un ID de usuario o URL de perfil, usar la herramienta de perfil de usuario correspondiente.
xhs_search_notes	Buscar notas de Xiaohongshu / 小红书, incluidas notas de video con note_type="video" y notas de imagen con note_type="image"; admite ordenación, filtros por fecha de publicación y continuación page_token. Usar la herramienta de detalle correspondiente cuando el llamador ya tiene un enlace de nota o note_id y necesita los detalles de una nota; usar la herramienta de URL/ID correspondiente para comentarios, respuestas o conversión de voz a texto. Para continuar la paginación de búsqueda, pasar el next_page_token completo devuelto sin cambios como page_token; omitir page_token en la primera solicitud. En cada uso de un note_url devuelto, como respuestas finales, visualización, referencias, almacenamiento, salida o reenvío, conservar la URL completa exactamente, incluido xsec_token; no reconstruir enlaces a partir de note_id.
xhs_search_images	Buscar imágenes de Xiaohongshu por palabra clave; cada resultado es una imagen con su nota asociada, y una nota puede contribuir con múltiples imágenes. La paginación puede no devolver más resultados. Para notas de imagen, usar xhs_search_notes con note_type="image".
xhs_search_products	Buscar productos de Xiaohongshu por nombre de producto, marca, categoría o consulta relacionada con el producto, con continuación page_token. Usar esta herramienta para términos de búsqueda; si ya se dispone de un sku_id completo, incluido uno proporcionado por el usuario, usar xhs_get_product_detail_by_sku_id o xhs_get_product_reviews en su lugar. No usar enlaces de producto, sku_id, spu_id o page_token como palabra clave. Para continuar la paginación de búsqueda de productos, pasar el next_page_token completo devuelto sin cambios como page_token; no truncar, resumir, enmascarar ni reemplazar el medio con puntos suspensivos.
xhs_get_product_detail_by_sku_id	Obtener detalles de un producto de Xiaohongshu mediante un sku_id completo proporcionado por el usuario o copiado de resultados de xhs_search_products. Para enlaces de producto o texto compartido, usar xhs_get_product_detail_by_url. Esta herramienta de ID no acepta spu_id, enlaces de producto ni palabras clave de búsqueda.
xhs_get_product_detail_by_url	Obtener detalles de un producto de Xiaohongshu desde una URL de producto, enlace corto o texto compartido que contenga un enlace de producto, sin buscar primero. Devuelve los mismos campos que xhs_get_product_detail_by_sku_id; el sku_id devuelto se puede usar para leer reseñas del producto. No se admiten enlaces de notas, enlaces de perfil ni códigos de compartir independientes.
xhs_pgy_get_note_detail_by_note_id	Obtener el detalle mejorado de una nota PGY / 蒲公英 de Xiaohongshu cuando el llamador ya tiene un note_id completo, incluidos contenido, imágenes o un resumen de video, autor, exposición, lecturas, me gusta, guardados, comentarios, compartidos y cotizaciones de colaboración de imagen/video del creador en yuanes chinos. Las cotizaciones no son el precio de transacción de la nota. Solo son elegibles las notas de creadores inscritos en PGY. Estos son datos comerciales de PGY, no detalles públicos ordinarios de notas; las llamadas exitosas cuestan 20 puntos y los fallos no se cobran.
xhs_pgy_get_note_detail_by_note_url	Obtener el detalle mejorado de una nota PGY / 蒲公英 de Xiaohongshu desde un enlace de nota completo, enlace corto o texto compartido, con la misma salida comercial de PGY y cotizaciones de colaboración de imagen/video del creador en yuanes chinos. Las cotizaciones no son el precio de transacción de la nota. Solo son elegibles las notas de creadores inscritos. Las llamadas exitosas cuestan 20 puntos y los fallos no se cobran.
xhs_pgy_get_creator_profile	Obtener el perfil de un creador PGY / 蒲公英 de Xiaohongshu mediante un user_id completo, incluidos la escala del creador y de notas comerciales, industrias de cooperación, medianas de notas, etiquetas de contenido y cotizaciones de colaboración de imagen/video del creador en yuanes chinos. Usar herramientas de perfil de usuario ordinarias para datos de cuentas no PGY. Las llamadas exitosas cuestan 20 puntos y los fallos no se cobran.
xhs_pgy_get_creator_notes_performance	Obtener el rendimiento de notas de un creador PGY / 蒲公英 de Xiaohongshu mediante un user_id completo, incluidos recuentos de notas, medianas de exposición/lectura/interacción, tasa de interacción, tasa de finalización de video, tasa de lectura de tres segundos de imagen, etiquetas de contenido y elementos de nota. El note_scope opcional selecciona daily (predeterminado) o cooperation; la respuesta refleja el alcance. Los elementos de nota cubren como máximo las 15 notas más recientes. Solo las tasas de comparación notes[] son diferencias firmadas relativas a las medianas de la plataforma y pueden ser negativas o superar 1; los campos de comparación resumidos con el mismo nombre son valores opacos de plataforma de 0 a 1 y no deben mezclarse. Las llamadas exitosas cuestan 20 puntos y los fallos no se cobran.
xhs_pgy_get_creator_fans_profile	Obtener las distribuciones de fans de PGY y su fecha de datos mediante un user_id completo. Las proporciones usan decimales de 0 a 1; las distribuciones pueden estar incompletas. Las llamadas exitosas cuestan 20 puntos; los fallos no se cobran.
xhs_pgy_get_creator_fans_summary	Obtener recuentos de seguidores de PGY, crecimiento, actividad, métricas de lectura y participación mediante un user_id completo. Las fechas de fin de ventana y los períodos de crecimiento no están especificados. Las llamadas exitosas cuestan 20 puntos; los fallos no se cobran.
xhs_pgy_get_creator_metrics_trend	Obtener medianas indexadas por fecha y costos estimados. Requiere user_id; note_scope se establece por defecto en diario, mientras que la cooperación incluye métricas de tienda externa. Imagen + video fijos, últimos 30 días, todo el tráfico para medianas; los costos usan alcances específicos de campo. Los vacíos se conservan; los valores no se pueden sumar entre fechas. Las llamadas exitosas cuestan 20 puntos; los fallos no se cobran.
xhs_pgy_get_creator_commercial_overview	Obtener métricas comerciales de PGY y costos estimados. Requiere user_id; note_scope se establece por defecto en diario, mientras que la cooperación incluye visitas a tienda externa. Las llamadas exitosas cuestan 20 puntos; los fallos no se cobran.
xhs_get_product_reviews	Obtener reseñas de productos de Xiaohongshu mediante un sku_id completo proporcionado por el usuario o copiado de resultados de xhs_search_products; acepta sort_type: general (ordenación integral, la predeterminada) o time_descending, con continuación has_image y page_token. Para continuar la paginación, pasar el next_page_token completo devuelto sin cambios como page_token; no truncar, resumir, enmascarar ni reemplazar el medio con puntos suspensivos. Esta herramienta no acepta spu_id, enlaces de producto ni palabras clave de búsqueda.
xhs_get_product_review_replies	Obtener respuestas bajo una reseña de producto de Xiaohongshu de primer nivel. Usar un review_id proporcionado por el usuario u obtenerlo de xhs_get_product_reviews; acepta continuación opaca page_token. Para continuar la paginación, pasar el next_page_token completo devuelto sin cambios como page_token; no truncar, resumir, enmascarar ni reemplazar el medio con puntos suspensivos. Esta herramienta no acepta root_review_id.
xhs_get_product_review_reply_replies	Obtener respuestas anidadas bajo una respuesta de reseña de producto de Xiaohongshu. Usar un review_id de respuesta proporcionado por el usuario u obtenerlo de xhs_get_product_review_replies; acepta continuación opaca page_token. Para continuar la paginación, pasar el next_page_token completo devuelto sin cambios como page_token; no truncar, resumir, enmascarar ni reemplazar el medio con puntos suspensivos. Esta herramienta no acepta root_review_id.
xhs_get_search_hot_list	Obtener la lista de tendencias de búsqueda de Xiaohongshu / 小红书 con el título y el valor de calor de cada elemento.
xhs_search_suggestions	Obtener sugerencias de búsqueda de Xiaohongshu / 小红书 para una palabra clave o frase parcial, incluido el texto de la sugerencia, el objetivo de búsqueda y una descripción opcional.
xhs_get_note_detail_by_note_url	Resolver un enlace XHS compartido, enlace corto o texto compartido en detalles estructurados de nota. En cada uso de un note_url devuelto, como respuestas finales, visualización, referencias, almacenamiento, salida o reenvío, conservar la URL completa exactamente, incluido xsec_token; no reconstruir enlaces a partir de note_id. Si note_url es nulo, no sintetizar ni reconstruir un enlace público a partir de note_id.
xhs_get_note_detail_by_note_id	Obtener detalles estructurados de nota cuando el llamador ya tiene un ID de nota. Si se devuelve note_url, conservar la URL completa exactamente en cada uso, como respuestas finales, visualización, referencias, almacenamiento, salida o reenvío, incluido xsec_token; no reconstruir enlaces a partir de note_id. Si note_url es nulo, no sintetizar ni reconstruir un enlace público a partir de note_id.
xhs_get_note_comments_by_note_id	Obtener comentarios de primer nivel paginados cuando el llamador ya tiene un ID de nota; acepta sort_type de comentario opcional: default, time_descending o like_count_descending. Para continuar la paginación, pasar el next_page_token completo devuelto sin cambios como page_token; no truncar, resumir, enmascarar ni reemplazar el medio con puntos suspensivos.
xhs_get_note_comments_by_note_url	Obtener comentarios de primer nivel paginados directamente desde una URL de nota compartida, enlace corto o texto compartido; acepta sort_type de comentario opcional: default, time_descending o like_count_descending. Para continuar la paginación, pasar el next_page_token completo devuelto sin cambios como page_token; no truncar, resumir, enmascarar ni reemplazar el medio con puntos suspensivos.
xhs_get_note_sub_comments_by_comment_id	Obtener respuestas paginadas bajo un comentario de primer nivel por ID de nota e ID de comentario. Para continuar la paginación, pasar el next_page_token completo devuelto sin cambios como page_token; no truncar, resumir, enmascarar ni reemplazar el medio con puntos suspensivos.
xhs_get_user_id_by_encrypted_user_id	Resolver un ID de usuario XHS cifrado completo a un user_id estable, que luego se puede usar con las herramientas de perfil de creador y notas publicadas.
xhs_get_user_info_by_user_id	Obtener datos de perfil de creador cuando el llamador ya tiene un ID de usuario.
xhs_get_user_info_by_profile_url	Resolver un enlace de perfil, enlace corto o texto compartido en datos de perfil de creador.
xhs_get_user_posted_notes_by_user_id	Obtener una lista paginada de notas publicadas por un creador cuando el llamador ya tiene un ID de usuario. Para continuar la paginación, pasar el next_page_token completo devuelto sin cambios como page_token; no truncar, resumir, enmascarar ni reemplazar el medio con puntos suspensivos.
xhs_get_user_posted_notes_by_profile_url	Obtener una lista paginada de notas publicadas por un creador desde un enlace de perfil, enlace corto o texto compartido. Para continuar la paginación, pasar el next_page_token completo devuelto sin cambios como page_token; no truncar, resumir, enmascarar ni reemplazar el medio con puntos suspensivos.
xhs_get_topic_notes_by_topic_url	Obtener una lista paginada de notas de una página de etiqueta desde una URL de tema, enlace corto o texto compartido; acepta sort_type: hot o time_descending. Para continuar la paginación, pasar el next_page_token completo devuelto sin cambios como page_token; no truncar, resumir, enmascarar ni reemplazar el medio con puntos suspensivos.
xhs_get_topic_notes_by_page_id	Obtener una lista paginada de notas de una página de etiqueta cuando el llamador ya tiene el page_id de la página de etiqueta; acepta sort_type: hot o time_descending. Para continuar la paginación, pasar el next_page_token completo devuelto sin cambios como page_token; no truncar, resumir, enmascarar ni reemplazar el medio con puntos suspensivos.
xhs_submit_video_speech_text_by_note_url	Enviar una tarea de transcripción de voz a texto de una nota de video desde un enlace de nota, enlace corto o texto compartido. La llamada de envío puede esperar hasta 240 segundos; si no está terminada, continuar consultando el mismo job_id hasta que sea terminal.
xhs_submit_video_speech_text_by_note_id	Enviar una tarea de transcripción de voz a texto de una nota de video desde un note_id. La llamada de envío puede esperar hasta 240 segundos; si no está terminada, continuar consultando el mismo job_id hasta que sea terminal.
xhs_get_video_speech_text_job	Verificar un trabajo de transcripción de voz a texto de una nota de video usando un job_id válido proporcionado por el usuario, o un job_id devuelto por una herramienta de envío; esta herramienta no acepta note_id ni enlaces de nota y no crea una nueva tarea. Cada llamada espera hasta 240 segundos. Si no está terminada, continuar consultando el mismo job_id hasta que sea terminal. Esta superficie v1 devuelve transcripción más contexto de contenido, no resumen.

Inicio rápido

Para clientes que admiten streamable-http autenticado, usar el endpoint alojado directamente:

{
  "mcpServers": {
    "socialdatax-xhs": {
      "type": "streamable_http",
      "url": "https://mcp.socialdatax.com/xhs/mcp",
      "headers": {
        "Authorization": "Bearer <SOCIALDATAX_API_KEY>"
      }
    }
  }
}

Un ejemplo listo para copiar está disponible en examples/streamable_http_config.json.

Para clientes MCP que solo admiten comandos/stdio, usa mcp-remote:

{
  "mcpServers": {
    "socialdatax-xhs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.socialdatax.com/xhs/mcp",
        "--header",
        "Authorization: Bearer ${SOCIALDATAX_API_KEY}"
      ],
      "env": {
        "SOCIALDATAX_API_KEY": "<SOCIALDATAX_API_KEY>"
      }
    }
  }
}

Claude Code puede usar HTTP remoto directamente:

claude mcp add --transport http socialdatax-xhs https://mcp.socialdatax.com/xhs/mcp --header 'Authorization: Bearer ${SOCIALDATAX_API_KEY}'

Persiste SOCIALDATAX_API_KEY en el entorno de ejecución o en el secreto del cliente antes de reiniciar Claude Code.

Claude Desktop debe usar su interfaz remota de MCP / Connectors cuando esté disponible. Si un archivo de configuración local en tu versión solo admite servidores de comandos/stdio, usa la alternativa mcp-remote.

Ejemplos de Clientes

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

• Configuración alternativa de comandos/stdio
• Configuración alternativa de Claude Desktop
• Configuración HTTP remota de Cursor
• Configuración HTTP remota de Codex
• Configuración HTTP transmisible directa

Clave de API

Solicita o gestiona el acceso a la API desde el sitio web del producto:

https://socialdatax.com/ai?from=github

Usa la clave como token Bearer en el encabezado de solicitud Authorization. No comprometas valores reales de claves de API en código, documentación, problemas o capturas de pantalla.

Metadatos del Directorio

Archivos de metadatos públicos en este repositorio:

• server-card.json: metadatos orientados al directorio para el servicio alojado. La publicación oficial del Registro MCP usa el registry/xhs/server.json del repositorio fuente privado para la entrada actual de com.52choujiang/xhs-insights.
• mcp.json: configuración de comandos/stdio usando el puente npm; el descubrimiento de herramientas funciona sin una clave de API.
• 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 la documentación pública 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 backend privado fuera de este repositorio.