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
3

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.15 (35 ferramentas)
  • Produção hospedada: 0.1.15 com 35 ferramentas; implantação e descoberta autenticada de ferramentas verificadas em 2026-10-14. Notas de vídeo permanecem disponíveis por meio de xhs_search_notes(note_type="video").
  • Registro MCP oficial: 0.1.15 (active, isLatest=true), publicado e verificado em 2026-10-14.
  • Cartão público do servidor no GitHub: 0.1.15 com 35 ferramentas, sincronizado e verificado em 2026-10-14.
  • O catálogo público de ferramentas é mantido em server-card.json; as versões da ponte npm são independentes do catálogo de ferramentas hospedado.
  • Ponte stdio npm: xiaohongshu-xhs-rednote-mcp@0.1.18; as versões do pacote da ponte são independentes das versões de capacidade hospedadas.

A capacidade atual inclui resolução de ID de usuário criptografado, perfis de criadores PGY, desempenho de notas, perfis e resumos de fãs, consulta de respostas a respostas de avaliações de produtos, consulta de detalhes de produtos por URL e a renomeação do campo de detalhes do produto (images para main_images; detail_images permanece inalterado).

MCP da Plataforma

Use o endpoint streamable-http hospedado diretamente 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 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 hospedado SocialDataX XHS. Ele não contém a implementação do serviço privado nem armazena a chave de API.

O catálogo público de ferramentas pode ser descoberto sem uma chave de API. Defina SOCIALDATAX_API_KEY para chamadas de ferramentas comerciais; sem ela, a ponte pode iniciar para descoberta, enquanto o serviço hospedado exige autenticação para dados comerciais.

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 em contas, 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 tempo de publicação.
  • Pesquisar produtos do Xiaohongshu por palavra-chave com continuação via page_token.
  • Buscar detalhes de produtos por um sku_id completo fornecido pelo usuário ou copiado dos resultados da pesquisa de produtos.
  • Buscar um detalhe de nota aprimorada 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.
  • PGY aplica-se apenas a notas de criadores inscritos. Use-o para dados comerciais solicitados; mantenha solicitações de notas comuns nas ferramentas de detalhes comuns. Um resultado explícito de sem dados comerciais é tratado como não inscrito (pgy_commercial_data_unavailable); pare sem tentar novamente a outra rota de ID/URL. Timeouts, falhas de autenticação e saldo insuficiente mantêm seus próprios erros.
  • Buscar avaliações de produtos por um sku_id completo fornecido pelo usuário ou copiado dos resultados da pesquisa de produtos.
  • Buscar respostas aninhadas sob uma resposta de avaliação de produto por um review_id fornecido pelo usuário ou copiado de xhs_get_product_review_replies; aceita continuação opaca page_token e não aceita root_review_id.
  • 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áginas de tópicos 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

FerramentaFinalidade pública
socialdatax_get_points_balanceConsultar o saldo de pontos / 积分余额、剩余积分或点数 da conta da chave de API atual no SocialDataX.
xhs_search_usersPesquisar usuários, contas ou criadores do Xiaohongshu / 小红书 por palavra-chave com paginação via page_token. Quando um ID de usuário ou URL de perfil já estiver disponível, use a ferramenta de perfil de usuário correspondente.
xhs_search_notesPesquisar notas do Xiaohongshu / 小红书, incluindo notas de vídeo com note_type="video" e notas de imagem com note_type="image"; suporta ordenação, filtros de data de publicação e continuação via page_token. Use a ferramenta de detalhes correspondente quando o chamador já tiver um link de nota ou note_id e precisar dos detalhes de uma única nota; use a ferramenta de URL/ID correspondente para comentários, respostas ou transcrição de fala para texto. Para continuar a paginação da pesquisa, passe o next_page_token completo retornado 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_imagesPesquisar imagens do Xiaohongshu por palavra-chave; cada resultado é uma imagem com sua nota associada, e uma nota pode contribuir com várias imagens. A paginação pode não retornar mais resultados. Para notas de imagem, use xhs_search_notes com note_type="image".
xhs_search_productsPesquisar produtos do Xiaohongshu por nome do produto, marca, categoria ou consulta relacionada a produto, com continuação via page_token. Use esta ferramenta para termos de pesquisa; se um sku_id completo já estiver disponível, incluindo um fornecido pelo usuário, use xhs_get_product_detail_by_sku_id 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 pesquisa de produtos, passe o next_page_token completo retornado de volta inalterado como page_token; não trunque, resuma, mascare ou substitua o meio por reticências.
xhs_get_product_detail_by_sku_idBuscar detalhes de produto do Xiaohongshu por um sku_id completo fornecido pelo usuário ou copiado dos resultados de xhs_search_products. Para links de produto ou texto de compartilhamento, use xhs_get_product_detail_by_url. Esta ferramenta de ID não aceita spu_id, links de produto ou palavras-chave de pesquisa.
xhs_get_product_detail_by_urlBuscar detalhes de produto do Xiaohongshu a partir de uma URL de produto, link curto ou texto de compartilhamento contendo um link de produto, sem pesquisar primeiro. Retorna os mesmos campos que xhs_get_product_detail_by_sku_id; o sku_id retornado pode ser usado para ler avaliações do produto. Links de notas, links de perfil e códigos de compartilhamento avulsos não são suportados.
xhs_pgy_get_note_detail_by_note_idBuscar um detalhe aprimorado de nota PGY / 蒲公英 do Xiaohongshu quando o chamador já tiver um note_id completo, incluindo conteúdo, imagens ou um resumo de vídeo, autor, alcance, leituras, curtidas, salvamentos, comentários, compartilhamentos e cotações de colaboração de imagem/vídeo do criador em yuan chinês. As cotações não são o preço de transação da nota. Apenas notas de criadores inscritos no PGY são elegíveis. Estes são dados comerciais do 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 do PGY e cotações de colaboração de imagem/vídeo do criador em yuan chinês. As cotações não são o preço de transação da nota. Apenas notas de criadores inscritos são elegíveis. Chamadas bem-sucedidas custam 20 pontos e falhas não são cobradas.
xhs_pgy_get_creator_profileBuscar um perfil de criador PGY / 蒲公英 do Xiaohongshu por um user_id completo, incluindo escala do criador e de notas comerciais, indústrias de cooperação, medianas de notas, tags de conteúdo e cotações de colaboração de imagem/vídeo do criador em yuan chinês. Use ferramentas comuns de perfil de usuário para dados de contas não-PGY. Chamadas bem-sucedidas custam 20 pontos e falhas não são cobradas.
xhs_pgy_get_creator_notes_performanceBuscar desempenho de notas de criador PGY / 蒲公英 do Xiaohongshu por um user_id completo, incluindo contagens de notas, medianas de alcance/leitura/interação, taxa de interação, taxa de conclusão de vídeo, taxa de leitura de três segundos de imagem, tags de conteúdo e itens de nota. O note_scope opcional seleciona daily (padrão) ou cooperation; a resposta ecoa o escopo. Os itens de nota cobrem no máximo as 15 notas mais recentes. Apenas taxas de comparação notes[] são diferenças assinadas relativas às medianas da plataforma e podem ser negativas ou exceder 1; campos de comparação resumidos com o mesmo nome são valores opacos de 0 a 1 da plataforma e não devem ser misturados. Chamadas bem-sucedidas custam 20 pontos e falhas não são cobradas.
xhs_pgy_get_creator_fans_profileBuscar distribuições de fãs do PGY e sua data de dados por um user_id completo. As proporções usam decimais de 0 a 1; as distribuições podem estar incompletas. Chamadas bem-sucedidas custam 20 pontos; falhas não são cobradas.
xhs_pgy_get_creator_fans_summaryBuscar contagens de seguidores do PGY, crescimento, atividade, leitura e métricas de engajamento por um user_id completo. Datas de término da janela e períodos de crescimento não são especificados. Chamadas bem-sucedidas custam 20 pontos; falhas não são cobradas.
xhs_pgy_get_creator_metrics_trendBuscar medianas indexadas por data e custos estimados. Requer user_id; note_scope padroniza para diário, enquanto cooperação inclui métricas de loja externa. Imagem + vídeo fixos, últimos 30 dias, todo o tráfego para medianas; custos usam escopos específicos de campo. Lacunas são preservadas; valores não podem ser somados entre datas. Chamadas bem-sucedidas custam 20 pontos; falhas não são cobradas.
xhs_pgy_get_creator_commercial_overviewBuscar métricas comerciais do PGY e custos estimados. Requer user_id; note_scope padroniza para diário, enquanto cooperação inclui visitas a lojas externas. Chamadas bem-sucedidas custam 20 pontos; falhas não são cobradas.
xhs_get_product_reviewsBuscar avaliações de produto 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 completo retornado 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 pesquisa.
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 completo retornado 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_product_review_reply_repliesBuscar respostas aninhadas sob uma resposta de avaliação de produto do Xiaohongshu. Use um review_id de resposta fornecido pelo usuário ou obtenha um de xhs_get_product_review_replies; aceita continuação opaca via page_token. Para continuar a paginação, passe o next_page_token completo retornado 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 de 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 de nota quando o chamador já tiver 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á tiver um ID de nota; aceita sort_type de comentário opcional: default, time_descending ou like_count_descending. Para continuar a paginação, passe o next_page_token completo retornado 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 de comentário opcional: default, time_descending ou like_count_descending. Para continuar a paginação, passe o next_page_token completo retornado 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 completo retornado de volta inalterado como page_token; não trunque, resuma, mascare ou substitua o meio por reticências.
xhs_get_user_id_by_encrypted_user_idResolver um ID de usuário XHS criptografado completo para um user_id estável, que pode então ser usado com ferramentas de perfil de criador e notas publicadas.
xhs_get_user_info_by_user_idBuscar dados de perfil de criador quando o chamador já tiver 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 de criador.
xhs_get_user_posted_notes_by_user_idBuscar uma lista paginada de notas publicadas por um criador quando o chamador já tiver um ID de usuário. Para continuar a paginação, passe o next_page_token completo retornado 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 completo retornado 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 completo retornado 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á tiver 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 completo retornado 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 esperar até 240 segundos; se não for concluída, continue consultando o mesmo job_id até o estado terminal.
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 esperar até 240 segundos; se não for concluída, continue consultando o mesmo job_id até o estado terminal.
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 espera até 240 segundos. Se não for concluída, continue consultando o mesmo job_id até o estado terminal. 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 Secret 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-fonte privado para a entrada atual do com.52choujiang/xhs-insights.
  • mcp.json: configuração comando/stdio usando a ponte npm; a descoberta de ferramentas funciona sem uma chave de API.
  • glama.json: metadados de propriedade do repositório Glama.
  • SUBMISSION_CHECKLIST.md: lista de verificação para submissões de diretórios 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.