Rednote MCP

Uma ferramenta automatizada para pesquisar e comentar na plataforma de mídia social Xiaohongshu (Rednote) usando Playwright.

Documentação

Ferramenta de comentários automáticos do Xiaohongshu (MCP Server) Esta é uma ferramenta de pesquisa e comentários automáticos do Xiaohongshu desenvolvida com base no Playwright. Como MCP Server, pode ser conectada a um MCP Client por meio de configuração específica, ajudando os usuários a realizar automaticamente operações como fazer login no Xiaohongshu, pesquisar palavras-chave, obter conteúdo de notas e publicar comentários inteligentes.

一、Características Login automático: suporta login manual por leitura de código QR. Após o primeiro login bem-sucedido, o estado de login é salvo e não é necessário escanear o código novamente nos usos seguintes. Pesquisa por palavras-chave: pesquisa notas do Xiaohongshu de acordo com a palavra-chave inserida pelo usuário, podendo especificar a quantidade de resultados retornados. Obtenção de conteúdo de notas: insira o URL da nota para obter o conteúdo detalhado da mesma. Obtenção de comentários de notas: obtém as informações de comentários da nota correspondente por meio do URL da nota. Publicação de comentários inteligentes: suporta vários tipos de comentários, incluindo atração de tráfego (orientar o usuário a seguir ou conversar no privado), curtida (interação simples para obter simpatia), consulta (aumentar interação em forma de pergunta) e profissional (demonstrar conhecimento especializado para estabelecer autoridade), podendo ser escolhido conforme a necessidade.

二、Etapas de instalação Verificação do ambiente Python: garanta que o sistema tenha Python 3.8 ou versão superior instalado. Caso não esteja instalado, faça o download e a instalação a partir do site oficial do Python. Obtenção do projeto: clone ou faça o download deste projeto para o ambiente local.

Instalação das dependências: abra o terminal no diretório do projeto e execute o seguinte comando para instalar as dependências necessárias: pip install -r requirements.txt

Instalação do navegador: na primeira execução da ferramenta, o navegador necessário será instalado automaticamente.

三、Configuração do MCP Server Adicione o seguinte conteúdo ao arquivo de configuração do MCP Client para configurar esta ferramenta como MCP Server: json { "mcpServers": { "xiaohongshu MCP": { "command": "python", "args": [ "/ABSOLUTE/PATH/TO/PARENT/FOLDER/xiaohongshu_mcp.py", "--stdio" ] } } } Ajuste o caminho do arquivo em "args" de acordo com a situação real.

四、Método de uso (一)Iniciar a ferramenta Se iniciar pelo MCP Client, siga o fluxo de operação do MCP Client para iniciar.

Se executar diretamente, execute no terminal do diretório do projeto: bash python main.py (二)Operações das principais funções Fazer login no Xiaohongshu: após iniciar a ferramenta, se ainda não tiver feito login, uma janela do navegador será aberta aguardando o usuário escanear o código QR manualmente. Após o login bem-sucedido, a ferramenta salvará o estado de login. Pesquisar notas: chame a função "search_notes" no código, conforme o exemplo abaixo: python

Pesquisar notas relacionadas a gastronomia, retornando os 3 primeiros resultados

await search_notes("美食", 3) Obter conteúdo de notas: use a função "get_note_content" para obter o conteúdo da nota com o URL especificado, conforme o exemplo abaixo: python

Obter o conteúdo da nota com o URL especificado

await get_note_content("https://www.xiaohongshu.com/search_result/xxxx") Obter comentários de notas: chame a função "get_note_comments" para obter os comentários da nota com o URL especificado, conforme o exemplo abaixo: python

Obter os comentários da nota com o URL especificado

await get_note_comments("https://www.xiaohongshu.com/search_result/xxxx") Publicar comentários inteligentes: use a função "post_smart_comment" para publicar comentários em uma nota específica, podendo escolher diferentes tipos de comentários, conforme o exemplo abaixo: python

Publicar um comentário do tipo consulta na nota especificada

await post_smart_comment("https://www.xiaohongshu.com/search_result/xxxx", "咨询") Valores possíveis para o parâmetro de tipo de comentário: "引流" (padrão): orientar o usuário a seguir ou conversar no privado "点赞": interação simples para obter simpatia "咨询": aumentar interação em forma de pergunta "专业": demonstrar conhecimento especializado para estabelecer autoridade 五、Estrutura do código docs/xiaohongshu_mcp.py: arquivo principal que implementa as funcionalidades, contendo a lógica de código para login, pesquisa, obtenção de conteúdo e comentários, publicação de comentários, entre outras funções. main.py: script de chamada de exemplo, usado para demonstrar como chamar as funcionalidades de "xiaohongshu_mcp.py". requirements.txt: registra as bibliotecas de dependência necessárias para o projeto, instaladas pelo comando "pip install -r requirements.txt".

六、Observações Modo do navegador: a ferramenta é executada no modo não oculto do Playwright, abrindo uma janela real do navegador durante a execução. Método de login: o primeiro login exige escaneamento manual do código QR; nos usos seguintes, se o estado de login for válido, não é necessário escanear novamente. Regras da plataforma: durante o uso, siga rigorosamente as normas pertinentes da plataforma Xiaohongshu, evite operações excessivas e previna riscos como banimento da conta. Compatibilidade das funcionalidades: como a plataforma Xiaohongshu pode passar por atualizações e ajustes, a disponibilidade dos resultados de pesquisa e das funções de comentários pode ser afetada. Caso ocorram anomalias, fique atento às atualizações do projeto ou entre em contato com o desenvolvedor.

七、Aviso de isenção de responsabilidade Esta ferramenta destina-se apenas a fins de aprendizado e pesquisa. Os usuários devem cumprir rigorosamente as leis e regulamentos relevantes, bem como as normas da plataforma Xiaohongshu. O desenvolvedor deste projeto não se responsabiliza por quaisquer problemas decorrentes do uso inadequado.