xhs-mcp-py

# xhs-mcp-py [](https://www.python.org/) [](LICENSE) 小红书 MCP 工具的 Python 实现，基于 Playwright 浏览器自动化，支持登录、发布、搜索、点赞、收藏、评论等功能。 ## 特性 - 🔐 **扫码登录** - 支持二维码扫码登录，自动保存 cookies - 📝 **发布内容** - 支持发布图文、视频、文字配图，支持定时发布 - 🔍 **搜索内容** - 支持关键词搜索（高级筛选能力在 MCP API 中提供） - ❤️ **互动功能** - 支持点赞、收藏、评论、回复评论 - 📊 **数据获取** - 获取首页推荐、笔记详情、用户主页，支持高级评论加载配置 - 🤖 **MCP 协议** - 支持 MCP 协议，可与 AI 助手集成 ## 安装 ```bash pip install xhs-mcp-py # 首次运行需安装浏览器 playwright install chromium ``` ## 快速开始 ### 使用流程 1. **首次使用必须先登录**：运行 `xhs-mcp login-browser` 弹出浏览器登录 或 `xhs-mcp login-qrcode --terminal` 在终端中显示二维码登录 2. **检查登录状态**：运行 `xhs-mcp status`（输出 `✅ 已登录` 或 `❌ 未登录`） 3. **执行操作**：登录成功后即可使用各种功能 4. **Cookies 有效期**：约 7-30 天，过期后需重新登录 > 💡 **MCP 使用提示**：让 AI 助手先调用 `check_login_status` 检查登录状态，如果未登录： > - 通过 MCP：调用 `login_with_browser` > - 或直接在命令行执行：`xhs-mcp login-browser` ## MCP 客户端配置 ### Claude Desktop 编辑配置文件 * `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS） * `%APPDATA%\Claude\claude_desktop_config.json`（Windows）： ```json { "mcpServers": { "xiaohongshu": { "command": "xhs-mcp", "args": ["serve"] } } } ``` 如果 `xhs-mcp` 不在系统 PATH 中，使用完整路径： ```json { "mcpServers": { "xiaohongshu": { "command": "/path/to/your/python/bin/xhs-mcp", "args": ["serve"] } } } ``` 可通过 `which xhs-mcp`（macOS/Linux）或 `where xhs-mcp`（Windows）查看完整路径。 配置完成后重启 Claude Desktop。 ### Claude Code ```bash # 添加 MCP 服务 claude mcp add xhs-mcp -- xhs-mcp serve # 查看已添加的 MCP claude mcp list # 移除 MCP 服务 claude mcp remove xhs-mcp ``` ### Cursor 在 Cursor 设置中添加 MCP 配置： 1. 打开 Cursor Settings → Features → MCP Servers 2. 点击 "Add Server" 3. 填写： - Name: `xhs-mcp` - Command: `xhs-mcp serve` ### 其他 MCP 客户端 任何支持 MCP 协议的客户端都可以使用，启动命令为： ```bash xhs-mcp serve ``` ## 发布 ### 图文 ``` 图：~/Downloads/vc.png 文字标题：Vibe Coding 真的心累💔 文字正文内容：强如 Opus，也只是傻乎乎地解决当下的指令... …