xhs_mcp: Instructions file for Claude Code

xhs-toolkit 项目说明

项目概述

小红书 MCP 工具包，通过 MCP 协议与小红书交互。

重要路径信息

项目根目录

必须使用绝对路径: D:\AI\xhs-toolkit

所有配置文件和数据文件都在此目录下：

• .env - 环境配置文件（已使用绝对路径）
• xhs_cookies.json - 小红书登录 cookies
• xhs_toolkit.log - 日志文件
• temp_images/ - 临时图片目录

MCP 配置

配置文件位置: C:\Users\Administrator\AppData\Roaming\Claude\claude_desktop_config.json

关键配置：

{
  "mcpServers": {
    "xhs-toolkit": {
      "command": "python",
      "args": ["-m", "src.server.mcp_server", "--stdio"],
      "cwd": "D:\\AI\\xhs-toolkit",
      "env": {
        "PYTHONPATH": "D:\\AI\\xhs-toolkit",
        "XHS_TOOLKIT_HOME": "D:\\AI\\xhs-toolkit",
        "COOKIES_FILE": "D:\\AI\\xhs-toolkit\\xhs_cookies.json",
        "LOG_FILE": "D:\\AI\\xhs-toolkit\\xhs_toolkit.log"
      }
    }
  }
}

重要环境变量：

• XHS_TOOLKIT_HOME - 项目根目录（用于定位 .env 和其他资源文件）
• COOKIES_FILE - cookies 文件绝对路径
• LOG_FILE - 日志文件绝对路径

工作目录要求

⚠️ 重要：此项目必须在 D:\AI\xhs-toolkit 目录下运行！

原因：

1. .env 配置文件使用绝对路径
2. xhs_cookies.json 需要被正确加载
3. temp_images/ 临时目录相对路径

常用 MCP 工具

账号相关

• login_xiaohongshu - 智能登录小红书
• get_creator_data_analysis - 获取创作者中心数据
• test_connection - 测试 MCP 连接

内容分析

• analyze_note_detail - 分析笔记详细数据
• search_and_analyze_accounts - 搜索并分析账号

互动功能

• like_note - 点赞笔记
• comment_note - 评论笔记
• analyze_and_comment_note - 分析并自动评论

发布功能

• smart_publish_note - 智能发布笔记（支持自动生成配图）

AI 媒体生成

• generate_ai_media_by_content - 根据正文生成图片/视频
• generate_hot_topics_image - 抓取热点并生成配图

配置检查清单

使用前确保：

• xhs_cookies.json 存在且有效（已登录小红书）
• .env 文件使用绝对路径
• MCP 配置正确（包含绝对路径的环境变量）
• Chrome 浏览器已安装

故障排查

问题：找不到 cookies

解决：运行 login_xiaohongshu 工具重新登录

问题：MCP 连接失败

解决：

1. 检查 MCP 配置文件中的路径是否正确
2. 确保 cwd 指向 D:\AI\xhs-toolkit
3. 重启 Claude Desktop

问题：相对路径文件找不到

解决：已修复 - .env 和 MCP 配置都使用绝对路径