小红书多平台自动化工具

一款用于自动化与小红书平台交互的多渠道工具,支持搜索笔记、收集详情和解析评论。

  • by Mikedu141319
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Mikedu141319/xhs-mcp

使用说明

小红树MCP工具

这是一个多通道平台(MCP)工具,用于自动化与小红书(小红书)的交互,包括搜索笔记、收集细节和解析评论。

🚀 Deployment on a New Machine / 迁移部署指南

要在另一台计算机上运行此工具,请执行以下步骤:

1. Prerequisites / 环境准备

  • 安装Docker桌面:通过运行验证安装 docker --version 和 docker-compose --version 在终端。
    • 下载并安装 Docker Desktop (Windows/Mac) 或 Docker Engine (Linux).

2. Copy Files / 文件拷贝

复制整个项目文件夹 3k-rednote-mcp 新机器。

  • 关键文件:
    • docker-compose.yml:服务配置。
    • src/:源代码。
    • cookies.json: 重要 -包含您的登录会话。复制此内容将保留您的登录状态。(如果您想重新登录,请在新计算机上删除此文件)。
    • data/:包含下载的笔记和图像。

3. Run the Service / 启动服务

  1. 打开终端(PowerShell或CMD)并导航到项目文件夹。
    cd path/to/3k-rednote-mcp
    
  2. 使用Docker Compose启动服务:
    docker-compose up -d --build
    
    • -d:在后台运行。
    • --build:重建映像以确保应用代码更改。

4. Verification / 验证

  • 检查服务是否正在运行:
    docker-compose ps
    
  • 查看日志:
    docker-compose logs -f
    

5. Troubleshooting / 常见问题

  • 登录失败:如果 cookies.json 无效或已过期,工具日志将显示登录失败。
    • 解决方案:通过VNC或CDP连接到正在运行的容器的浏览器以手动登录,或删除 cookies.json 并重新启动以触发新的登录流(如果实现)。
  • 权限问题:确保用户具有项目文件夹的读/写权限。

🛠️ 配置

  • server.py:定义MCP工具的主要入口点(auto_execute等等)。
  • src/services/note_service.py:纸币收集的核心逻辑。
  • src/utils/output_cleaner.py:清理JSON输出的逻辑。