SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

SocialDataX（社媒数据助手）es un MCP de solo lectura para 小红书 / Xiaohongshu / XHS / RedNote, compatible con búsqueda de notas, detalles de notas, comentarios, respuestas a comentarios, información del creador, lista de notas del creador, búsqueda de notas, detalles de notas, comentarios, respuestas a comentarios, perfiles de creadores y notas de creadores.

GitHub

Prueba este MCPPatrocinado

Documentación

小红书 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 buscas 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 streamable-http alojado para clientes que admiten MCP remoto
Un ejemplo de respaldo mcp-remote para clientes MCP que solo admiten command/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.11. El tools/list de producción alojado, la tarjeta de servidor y el repositorio público de GitHub están sincronizados en 0.1.11 con las 24 herramientas rastreadas. El puente npm stdio se publica como xiaohongshu-xhs-rednote-mcp@0.1.11 y se conecta a la misma superficie alojada. El registro oficial más reciente sigue siendo 0.1.10 pendiente de la publicación de 0.1.11. La versión 0.1.11 renombra los campos públicos de búsqueda/detalle de productos XHS de seller_* a shop_*.

MCP de plataforma

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

Puente npm stdio

Requiere Node.js 20.18.1 o posterior.

Los clientes MCP que solo admiten command/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 XHS alojado de SocialDataX. No contiene la implementación privada del servicio ni almacena la clave API.

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 u otras acciones de cuenta.

Los flujos de trabajo admitidos incluyen:

Consultar el saldo de puntos 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 de 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.
Obtener reseñas de productos mediante un sku_id completo proporcionado por el usuario o copiado de los resultados de búsqueda de productos.
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ágina 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 de una nota 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 termine.

Herramientas

Herramienta	Propósito público
`socialdatax_get_points_balance`	Consultar el saldo de puntos SocialDataX / 积分余额、剩余积分或点数 de la cuenta de la clave API actual.
`xhs_search_notes`	Buscar notas de Xiaohongshu / 小红书 por palabra clave con filtros opcionales de orden, tipo de nota, tiempo de publicación y continuación `page_token`. Usa la herramienta de detalle correspondiente cuando el llamador ya tiene un enlace de nota o `note_id` y necesita los detalles de una nota; usa la herramienta de URL/ID correspondiente para comentarios, respuestas o voz a texto. Para continuar la paginación de búsqueda, pasa el `next_page_token` completo devuelto sin cambios como `page_token`; omite `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, conserva la URL completa exactamente, incluido `xsec_token`; no reconstruyas enlaces a partir de `note_id`.
`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`. Usa esta herramienta para términos de búsqueda; si ya hay un `sku_id` completo disponible, incluido uno proporcionado por el usuario, usa `xhs_get_product_detail` o `xhs_get_product_reviews` en su lugar. No uses enlaces de producto, `sku_id`, `spu_id` o `page_token` como palabra clave. Para continuar la paginación de búsqueda de productos, pasa el `next_page_token` completo devuelto sin cambios como `page_token`; no trunques, resumas, enmascares ni reemplaces el medio con puntos suspensivos.
`xhs_get_product_detail`	Obtener detalles de producto de Xiaohongshu mediante un `sku_id` completo proporcionado por el usuario o copiado de los resultados de `xhs_search_products`. Esta herramienta no acepta `spu_id`, enlaces de producto ni palabras clave de búsqueda.
`xhs_pgy_get_note_detail_by_note_id`	Obtener un detalle de nota mejorada PGY / 蒲公英 de Xiaohongshu cuando el llamador ya tiene un `note_id` completo, incluido contenido, imágenes o un resumen de video, autor, exposición, lecturas, recuentos de interacción y precios de imagen/video. Estos son datos comerciales de PGY, no detalles públicos ordinarios de nota; las llamadas exitosas cuestan 20 puntos y los fallos no se cobran.
`xhs_pgy_get_note_detail_by_note_url`	Obtener un detalle de nota mejorada PGY / 蒲公英 de Xiaohongshu desde un enlace de nota completo, enlace corto o texto compartido, con la misma salida comercial de PGY. Las llamadas exitosas cuestan 20 puntos y 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 los resultados de `xhs_search_products`; acepta `sort_type`: `general` (orden integral, el predeterminado) o `time_descending`, `has_image` y continuación `page_token`. Para continuar la paginación, pasa el `next_page_token` completo devuelto sin cambios como `page_token`; no trunques, resumas, enmascares ni reemplaces 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. Usa un `review_id` proporcionado por el usuario u obtén uno de `xhs_get_product_reviews`; acepta continuación opaca `page_token`. Para continuar la paginación, pasa el `next_page_token` completo devuelto sin cambios como `page_token`; no trunques, resumas, enmascares ni reemplaces 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 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, conserva la URL completa exactamente, incluido `xsec_token`; no reconstruyas enlaces a partir de `note_id`. Si `note_url` es nulo, no sintetices ni reconstruyas 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`, conserva la URL completa exactamente en cada uso, como respuestas finales, visualización, referencias, almacenamiento, salida o reenvío, incluido `xsec_token`; no reconstruyas enlaces a partir de `note_id`. Si `note_url` es nulo, no sintetices ni reconstruyas 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, pasa el `next_page_token` completo devuelto sin cambios como `page_token`; no trunques, resumas, enmascares ni reemplaces 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, pasa el `next_page_token` completo devuelto sin cambios como `page_token`; no trunques, resumas, enmascares ni reemplaces 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, pasa el `next_page_token` completo devuelto sin cambios como `page_token`; no trunques, resumas, enmascares ni reemplaces el medio con puntos suspensivos.
`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, pasa el `next_page_token` completo devuelto sin cambios como `page_token`; no trunques, resumas, enmascares ni reemplaces 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, pasa el `next_page_token` completo devuelto sin cambios como `page_token`; no trunques, resumas, enmascares ni reemplaces el medio con puntos suspensivos.
`xhs_get_topic_notes_by_topic_url`	Obtener una lista paginada de notas de 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, pasa el `next_page_token` completo devuelto sin cambios como `page_token`; no trunques, resumas, enmascares ni reemplaces el medio con puntos suspensivos.
`xhs_get_topic_notes_by_page_id`	Obtener una lista paginada de notas de 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, pasa el `next_page_token` completo devuelto sin cambios como `page_token`; no trunques, resumas, enmascares ni reemplaces 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 termina, continúa consultando el mismo `job_id` hasta que termine.
`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 termina, continúa consultando el mismo `job_id` hasta que termine.
`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 termina, continúa consultando el mismo `job_id` hasta que termine. Esta superficie v1 devuelve transcripción más contexto de contenido, no resumen.

Inicio rápido

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

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

Hay un ejemplo listo para copiar disponible en examples/streamable_http_config.json.

Para clientes MCP solo de comando/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 de MCP remoto / Connectors cuando esté disponible. Si un archivo de configuración local en tu versión solo admite servidores de comando/stdio, usa el respaldo mcp-remote.

Ejemplos de Clientes

Hay ejemplos de configuración disponibles en examples:

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 en el 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 genérica de respaldo de comando/stdio usando mcp-remote.
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.