SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

SocialDataX（社媒数据助手）é um MCP somente leitura para 小红书 / Xiaohongshu / XHS / RedNote, compatível com pesquisa de notas, detalhes de notas, comentários, respostas a comentários, informações do criador, lista de notas do criador, note search, note details, comments, comment replies, creator profiles e creator notes.

GitHub
1
Experimente este MCPPatrocinado

Documentação

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

Este repositório público fornece documentação de conexão pública e metadados MCP para um serviço hospedado de 小红书 MCP / Xiaohongshu MCP / XHS MCP / RedNote MCP.

Se você está procurando um 小红书 MCP, Xiaohongshu MCP, XHS MCP ou RedNote MCP para fluxos de trabalho de pesquisa em mídias sociais, este repositório inclui:

  • metadados MCP públicos e exemplos de configuração de cliente
  • o endpoint streamable-http hospedado para clientes que suportam MCP remoto
  • um exemplo de fallback mcp-remote para clientes MCP somente comando/stdio

A implementação comercial é hospedada de forma privada. Este repositório expõe apenas a superfície de conexão pública para fluxos de trabalho de inteligência de conteúdo em mídias sociais.

Aliases de Busca

Frases de busca comuns para este serviço 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

Serviço

  • Endpoint MCP hospedado: https://mcp.socialdatax.com/xhs/mcp
  • Transporte hospedado: streamable-http
  • Autenticação: Authorization: Bearer <SOCIALDATAX_API_KEY>
  • Produto: SocialDataX / 社媒数据助手
  • Acesso ao site e à chave de API: https://socialdatax.com/ai?from=github
  • Nome no registro: com.52choujiang/xhs-insights
  • Nome futuro no registro: com.socialdatax/xhs-insights
  • Versão atual da capacidade pública: 0.1.11. O tools/list de produção hospedado, o cartão do servidor e o repositório público do GitHub são sincronizados em 0.1.11 com todas as 24 ferramentas rastreadas. A ponte stdio do npm é publicada como xiaohongshu-xhs-rednote-mcp@0.1.11 e conecta-se à mesma superfície hospedada. O registro oficial mais recente permanece 0.1.10 até a publicação de 0.1.11. A versão 0.1.11 renomeia os campos públicos de busca/detalhe de produtos XHS de seller_* para shop_*.

MCP da Plataforma

Use o endpoint streamable-http hospedado diretamente a partir de clientes que suportam MCP remoto autenticado. Para clientes que suportam apenas servidores MCP comando/stdio, use mcp-remote como um proxy de compatibilidade local.

Ponte stdio do npm

Requer Node.js 20.18.1 ou posterior.

Clientes MCP somente comando/stdio podem instalar e iniciar a ponte diretamente do npm:

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

O pacote apenas encaminha mensagens MCP stdio locais para o endpoint XHS hospedado da SocialDataX. Ele não contém a implementação privada do serviço nem armazena a chave de API.

Escopo do Fluxo de Trabalho

Este serviço MCP é projetado para fluxos de trabalho de inteligência de conteúdo em mídias sociais. Ele não fornece login de conta, publicação, edição, curtidas, comentários ou outras ações de conta.

Os fluxos de trabalho suportados incluem:

  • Consultar o saldo de pontos SocialDataX / 积分余额、剩余积分或点数 da conta da chave de API atual.
  • Pesquisar notas relacionadas do Xiaohongshu por palavra-chave, com filtros opcionais de ordenação, tipo de nota e data de publicação.
  • Pesquisar produtos do Xiaohongshu por palavra-chave com continuação via page_token.
  • Buscar detalhes de produto por um sku_id completo fornecido pelo usuário ou copiado dos resultados de busca de produtos.
  • Buscar um detalhe aprimorado de nota PGY / 蒲公英 a partir de um note_id completo ou de um link de nota, link curto ou texto de compartilhamento; chamadas bem-sucedidas custam 20 pontos e falhas não são cobradas.
  • Buscar avaliações de produtos por um sku_id completo fornecido pelo usuário ou copiado dos resultados de busca de produtos.
  • Ler a lista de tendências de busca do Xiaohongshu com título e valor de calor.
  • Ler sugestões de busca do Xiaohongshu para uma palavra-chave ou frase parcial.
  • Resolver um link de nota compartilhado, link curto ou texto de compartilhamento em detalhes estruturados da nota.
  • Ler detalhes da nota quando o chamador já possui um ID de nota.
  • Buscar comentários de primeiro nível paginados para análise de comentários.
  • Buscar respostas paginadas sob um comentário de primeiro nível.
  • Ler dados de perfil do criador a partir de um link de perfil, link curto, texto de compartilhamento ou ID de usuário.
  • Buscar listas paginadas de notas do criador a partir de um ID de usuário, link de perfil, link curto ou texto de compartilhamento para pesquisa de estilo de conteúdo e conta.
  • Buscar listas paginadas de notas de página de tag a partir de uma URL de tópico, link curto, texto de compartilhamento ou ID de página.
  • Enviar uma tarefa de transcrição de fala para texto de nota de vídeo; a chamada de envio pode aguardar até 240 segundos, e trabalhos não concluídos devem continuar consultando o mesmo job_id até o estado final.

Ferramentas

FerramentaPropósito público
socialdatax_get_points_balanceConsultar o saldo de pontos SocialDataX / 积分余额、剩余积分或点数 da conta da chave de API atual.
xhs_search_notesPesquisar notas do Xiaohongshu / 小红书 por palavra-chave com filtros opcionais de ordenação, tipo de nota, data de publicação e continuação via page_token. Use a ferramenta de detalhes correspondente quando o chamador já possui um link de nota ou note_id e precisa dos detalhes de uma nota; use a ferramenta de URL/ID correspondente para comentários, respostas ou fala para texto. Para continuar a paginação da busca, passe o next_page_token retornado completo de volta inalterado como page_token; omita page_token na primeira solicitação. Em todo uso de um note_url retornado, como respostas finais, exibição, referências, armazenamento, saída ou encaminhamento, preserve a URL completa exatamente, incluindo xsec_token; não reconstrua links a partir de note_id.
xhs_search_productsPesquisar produtos do Xiaohongshu por nome do produto, marca, categoria ou consulta relacionada ao produto, com continuação via page_token. Use esta ferramenta para termos de busca; se um sku_id completo já estiver disponível, incluindo um fornecido pelo usuário, use xhs_get_product_detail ou xhs_get_product_reviews em vez disso. Não use links de produto, sku_id, spu_id ou page_token como palavra-chave. Para continuar a paginação da busca de produtos, passe o next_page_token retornado completo de volta inalterado como page_token; não trunque, resuma, mascare ou substitua o meio por reticências.
xhs_get_product_detailBuscar detalhes de produto do Xiaohongshu por um sku_id completo fornecido pelo usuário ou copiado dos resultados de xhs_search_products. Esta ferramenta não aceita spu_id, links de produto ou palavras-chave de busca.
xhs_pgy_get_note_detail_by_note_idBuscar um detalhe aprimorado de nota PGY / 蒲公英 do Xiaohongshu quando o chamador já possui um note_id completo, incluindo conteúdo, imagens ou um resumo de vídeo, autor, alcance, leituras, contagens de engajamento e preços de imagem/vídeo. Estes são dados comerciais PGY, não detalhes públicos comuns de nota; chamadas bem-sucedidas custam 20 pontos e falhas não são cobradas.
xhs_pgy_get_note_detail_by_note_urlBuscar um detalhe aprimorado de nota PGY / 蒲公英 do Xiaohongshu a partir de um link de nota completo, link curto ou texto de compartilhamento, com a mesma saída comercial PGY. Chamadas bem-sucedidas custam 20 pontos e falhas não são cobradas.
xhs_get_product_reviewsBuscar avaliações de produtos do Xiaohongshu por um sku_id completo fornecido pelo usuário ou copiado dos resultados de xhs_search_products; aceita sort_type: general (ordenação abrangente, o padrão) ou time_descending, has_image e continuação via page_token. Para continuar a paginação, passe o next_page_token retornado completo de volta inalterado como page_token; não trunque, resuma, mascare ou substitua o meio por reticências. Esta ferramenta não aceita spu_id, links de produto ou palavras-chave de busca.
xhs_get_product_review_repliesBuscar respostas sob uma avaliação de produto de primeiro nível do Xiaohongshu. Use um review_id fornecido pelo usuário ou obtenha um de xhs_get_product_reviews; aceita continuação opaca via page_token. Para continuar a paginação, passe o next_page_token retornado completo de volta inalterado como page_token; não trunque, resuma, mascare ou substitua o meio por reticências. Esta ferramenta não aceita root_review_id.
xhs_get_search_hot_listObter a lista de tendências de busca do Xiaohongshu / 小红书 com o título e o valor de calor de cada item.
xhs_search_suggestionsObter sugestões de busca do Xiaohongshu / 小红书 para uma palavra-chave ou frase parcial, incluindo texto da sugestão, alvo da busca e uma descrição opcional.
xhs_get_note_detail_by_note_urlResolver um link XHS compartilhado, link curto ou texto de compartilhamento em detalhes estruturados da nota. Em todo uso de um note_url retornado, como respostas finais, exibição, referências, armazenamento, saída ou encaminhamento, preserve a URL completa exatamente, incluindo xsec_token; não reconstrua links a partir de note_id. Se note_url for nulo, não sintetize ou reconstrua um link público a partir de note_id.
xhs_get_note_detail_by_note_idBuscar detalhes estruturados da nota quando o chamador já possui um ID de nota. Se note_url for retornado, preserve a URL completa exatamente em todo uso, como respostas finais, exibição, referências, armazenamento, saída ou encaminhamento, incluindo xsec_token; não reconstrua links a partir de note_id. Se note_url for nulo, não sintetize ou reconstrua um link público a partir de note_id.
xhs_get_note_comments_by_note_idBuscar comentários de primeiro nível paginados quando o chamador já possui um ID de nota; aceita sort_type opcional de comentário: default, time_descending ou like_count_descending. Para continuar a paginação, passe o next_page_token retornado completo de volta inalterado como page_token; não trunque, resuma, mascare ou substitua o meio por reticências.
xhs_get_note_comments_by_note_urlBuscar comentários de primeiro nível paginados diretamente de uma URL de nota compartilhada, link curto ou texto de compartilhamento; aceita sort_type opcional de comentário: default, time_descending ou like_count_descending. Para continuar a paginação, passe o next_page_token retornado completo de volta inalterado como page_token; não trunque, resuma, mascare ou substitua o meio por reticências.
xhs_get_note_sub_comments_by_comment_idBuscar respostas paginadas sob um comentário de primeiro nível por ID de nota e ID de comentário. Para continuar a paginação, passe o next_page_token retornado completo de volta inalterado como page_token; não trunque, resuma, mascare ou substitua o meio por reticências.
xhs_get_user_info_by_user_idBuscar dados de perfil do criador quando o chamador já possui um ID de usuário.
xhs_get_user_info_by_profile_urlResolver um link de perfil, link curto ou texto de compartilhamento em dados de perfil do criador.
xhs_get_user_posted_notes_by_user_idBuscar uma lista paginada de notas publicadas por um criador quando o chamador já possui um ID de usuário. Para continuar a paginação, passe o next_page_token retornado completo de volta inalterado como page_token; não trunque, resuma, mascare ou substitua o meio por reticências.
xhs_get_user_posted_notes_by_profile_urlBuscar uma lista paginada de notas publicadas por um criador a partir de um link de perfil, link curto ou texto de compartilhamento. Para continuar a paginação, passe o next_page_token retornado completo de volta inalterado como page_token; não trunque, resuma, mascare ou substitua o meio por reticências.
xhs_get_topic_notes_by_topic_urlBuscar uma lista paginada de notas de página de tag a partir de uma URL de tópico, link curto ou texto de compartilhamento; aceita sort_type: hot ou time_descending. Para continuar a paginação, passe o next_page_token retornado completo de volta inalterado como page_token; não trunque, resuma, mascare ou substitua o meio por reticências.
xhs_get_topic_notes_by_page_idBuscar uma lista paginada de notas de página de tag quando o chamador já possui o page_id da página de tag; aceita sort_type: hot ou time_descending. Para continuar a paginação, passe o next_page_token retornado completo de volta inalterado como page_token; não trunque, resuma, mascare ou substitua o meio por reticências.
xhs_submit_video_speech_text_by_note_urlEnviar uma tarefa de transcrição de fala para texto de nota de vídeo a partir de um link de nota, link curto ou texto de compartilhamento. A chamada de envio pode aguardar até 240 segundos; se não concluída, continue consultando o mesmo job_id até o estado final.
xhs_submit_video_speech_text_by_note_idEnviar uma tarefa de transcrição de fala para texto de nota de vídeo a partir de um note_id. A chamada de envio pode aguardar até 240 segundos; se não concluída, continue consultando o mesmo job_id até o estado final.
xhs_get_video_speech_text_jobVerificar um trabalho de transcrição de fala para texto de nota de vídeo usando um job_id válido fornecido pelo usuário ou um job_id retornado por uma ferramenta de envio; esta ferramenta não aceita note_id ou links de nota e não cria uma nova tarefa. Cada chamada aguarda até 240 segundos. Se não concluída, continue consultando o mesmo job_id até o estado final. Esta superfície v1 retorna transcrição mais contexto de conteúdo, não resumo.

Início Rápido

Para clientes que suportam streamable-http autenticado, use o endpoint hospedado diretamente:

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

Um exemplo pronto para copiar está disponível em examples/streamable_http_config.json.

Para clientes MCP somente comando/stdio, use 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>"
      }
    }
  }
}

O Claude Code pode usar HTTP remoto diretamente:

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

Persista SOCIALDATAX_API_KEY no ambiente de execução ou no segredo do cliente antes de reiniciar o Claude Code.

O Claude Desktop deve usar a interface remota de MCP / Connectors quando disponível. Se um arquivo de configuração local na sua versão suportar apenas servidores comando/stdio, use o fallback mcp-remote.

Exemplos de Clientes

Exemplos de configuração estão disponíveis em examples:

Chave de API

Solicite ou gerencie o acesso à API no site do produto:

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

Use a chave como token Bearer no cabeçalho da requisição Authorization. Não envie valores reais de chave de API para código, documentação, issues ou capturas de tela.

Metadados do Diretório

Arquivos de metadados públicos neste repositório:

  • server-card.json: metadados orientados a diretório para o serviço hospedado. A publicação oficial no Registro MCP usa o registry/xhs/server.json do repositório de origem privado para a entrada atual do com.52choujiang/xhs-insights.
  • mcp.json: configuração genérica de fallback comando/stdio usando mcp-remote.
  • glama.json: metadados de propriedade do repositório Glama.
  • SUBMISSION_CHECKLIST.md: lista de verificação para submissões de diretório MCP.

Licença

Os arquivos neste repositório público são lançados sob a Licença MIT. A licença cobre apenas a documentação pública e os exemplos de configuração neste repositório. Ela não cobre a implementação do serviço gerenciado, a infraestrutura hospedada ou qualquer código de backend privado fora deste repositório.