RedNote MCP

RedNote MCP - Ferramenta de Busca de Conteúdo do Xiaohongshu

Visão Geral

O RedNote MCP é um servidor de Protocolo de Contexto de Modelo (MCP) para buscar e recuperar conteúdo da plataforma Xiaohongshu (Livro Vermelho). Ele fornece extração inteligente de conteúdo com gerenciamento automático de login e capacidades de processamento paralelo.

Recursos

• Busca Inteligente: Busca de conteúdo baseada em palavras-chave no Xiaohongshu
• Login Automático: Gerenciamento automático de cookies e tratamento de login
• Processamento Paralelo: Recuperação eficiente de conteúdo concorrente
• Extração Rica de Dados:
  • Títulos e conteúdo das notas
  • Informações e descrições do autor
  • Métricas de interação (curtidas, favoritos, comentários)
  • Imagens e hashtags
  • Links diretos das notas

Stack Técnico

• Runtime: Node.js com TypeScript
• Automação de Navegador: Playwright
• Protocolo: SDK do Protocolo de Contexto de Modelo (MCP)
• Validação: Validação de esquema Zod
• Gerenciador de Pacotes: pnpm

Estrutura de Dados

interface RedBookNote {
  title: string;        // Note title
  content: string;      // Note content
  author: string;       // Author name
  authorDesc?: string;  // Author description
  link: string;         // Note URL
  likes?: number;       // Like count
  collects?: number;    // Favorite count
  comments?: number;    // Comment count
  tags?: string[];      // Hashtag list
  images?: string[];    // Image URLs (WebP format)
}

Instalação

Pré-requisitos

• Node.js 18+
• Gerenciador de pacotes pnpm

Configuração

1. Clone o repositório:

git clone <repository-url>
cd rednote-mcp

2. Instale as dependências:

pnpm install

3. Instale os navegadores do Playwright:

pnpm exec playwright install

4. Compile o projeto:

pnpm build

Uso

Executando o Servidor MCP

pnpm start

Modo de Desenvolvimento

pnpm dev

Testes

pnpm test

Configuração do Cliente MCP

Claude Desktop

Adicione a seguinte configuração ao arquivo de configuração do Claude Desktop:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "rednote-mcp": {
      "command": "node",
      "args": [
        "C:\\ABSOLUTE\\PATH\\TO\\rednote-mcp\\build\\index.js"
      ]
    }
  }
}

Para usuários de macOS/Linux:

{
  "mcpServers": {
    "rednote-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/rednote-mcp/build/index.js"
      ]
    }
  }
}

Substitua o caminho pelo diretório real do seu projeto.

Outros Clientes MCP

Para outros clientes compatíveis com MCP, use o arquivo do servidor compilado:

node build/index.js

Uso da Ferramenta

Após a configuração, você pode usar a ferramenta de busca no seu cliente MCP:

Search for "food recommendation" on Xiaohongshu

A ferramenta retornará dados estruturados incluindo títulos, conteúdo, informações do autor e imagens.

Notas Importantes

• Primeira Execução: É necessário login manual no Xiaohongshu no primeiro uso
• Desempenho: As buscas iniciais podem levar de 30 a 60 segundos devido à inicialização do navegador e ao carregamento do conteúdo
• Limite de Taxa: Solicitações concorrentes são limitadas a 3 para evitar restrições da plataforma
• Formato de Imagem: As imagens são fornecidas no formato WebP
• Gerenciamento de Cookies: O estado de login é salvo e reutilizado automaticamente

Desenvolvimento

Estrutura do Projeto

rednote-mcp/
├── src/
│   ├── index.ts          # MCP server entry point
│   └── xiaohongshu.ts    # Core scraping logic
├── cookies/              # Auto-generated cookie storage
├── results/              # Optional: saved search results
├── build/                # Compiled JavaScript output
├── package.json
├── tsconfig.json
└── README.md

Scripts Disponíveis

• pnpm build - Compila TypeScript para JavaScript
• pnpm start - Executa o servidor MCP compilado
• pnpm dev - Modo de desenvolvimento com recarga automática
• pnpm test - Executa testes (se disponíveis)
• pnpm clean - Limpa o diretório de compilação

Solução de Problemas

Problemas Comuns

1. Login Necessário: Se você vir avisos de login, exclua o diretório cookies/ e reinicie
2. Erros de Tempo Limite: Aumente as configurações de tempo limite do cliente MCP
3. Navegador Não Encontrado: Execute pnpm exec playwright install para instalar os navegadores
4. Erros de Permissão: Certifique-se de que o diretório do projeto tenha permissões adequadas de leitura/escrita

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

Aviso Legal

Esta ferramenta é para fins educacionais e de pesquisa. Por favor, respeite os termos de serviço e os limites de taxa do Xiaohongshu ao usar esta ferramenta.