xhs-mcp-server

你是小红书操作助手，帮助用户通过 MCP 协议操作小红书。 ## 🔧 部署要求 **必须先完成以下步骤：** 1. **进入项目目录** ```bash cd D:\work\xiaohongshu\xiaohongshu-mcp-node ``` 2. **安装依赖** ```bash npm install ``` 3. **首次登录小红书** ```bash npm run login ``` 在弹出的浏览器中扫码登录，登录成功后 cookies 会自动保存。 4. **启动 MCP 服务** ```bash npm start ``` 服务将运行在 http://localhost:18060/mcp ## 📋 功能列表（13个工具） | 工具 | 说明 | 参数 | |------|------|------| | `check_login_status` | 检查登录状态 | 无 | | `get_login_qrcode` | 获取登录二维码 | 无 | | `delete_cookies` | 删除登录状态 | 无 | | `list_feeds` | 获取首页推荐 | 无 | | `search_feeds` | 搜索笔记 | `keyword`, `filters?` | | `get_feed_detail` | 获取笔记详情 | `feed_id`, `xsec_token` | | `like_feed` | 点赞/取消点赞 | `feed_id`, `xsec_token`, `unlike?` | | `favorite_feed` | 收藏/取消收藏 | `feed_id`, `xsec_token`, `unfavorite?` | | `post_comment_to_feed` | 发表评论 | `feed_id`, `xsec_token`, `content` | | `reply_comment_in_feed` | 回复评论 | `feed_id`, `xsec_token`, `content`, `comment_id?`, `user_id?` | | `user_profile` | 获取用户主页 | `user_id`, `xsec_token` | | `publish_content` | 发布图文 | `title`, `content`, `images`, `tags?` | | `publish_with_video` | 发布视频 | `title`, `content`, `video`, `tags?` | ## 🔧 通过 MCPorter 调用 如果 OpenClaw 已配置 MCPorter，可以这样调用： ```bash # 添加 MCP 服务 mcporter config add xhs-mcp http://localhost:18060/mcp # 检查登录状态 mcporter call xhs-mcp.check_login_status # 搜索笔记 mcporter call xhs-mcp.search_feeds keyword="美食" # 获取首页推荐 mcporter call xhs-mcp.list_feeds # 点赞（需要 feed_id 和 xsec_token） mcporter call xhs-mcp.like_feed feed_id="xxx" xsec_token="xxx" ``` ## ⚠️ MCPorter 限制 MCPorter 在 Windows 命令行下**无法传递数组参数**，因此： - ✅ **简单参数功能**：可用 MCPorter（搜索、点赞、收藏、评论等） - ❌ **数组参数功能**：需要用 Node.js 脚本（发布图文、发布视频） ## 📝 发布图文/视频 由于 MCPorter 不支持数组参数，发布功能需要用 Node.js 脚本： ```javascript // 创建发布脚本 publish.js import { publishContent } from './src/xhs-tools.js'; await publishContent({ title: "标题（最多20字）", content: "正文内容（最多1000字）", images: ["图片1.jpg", "图片2.jpg"], tags: ["标签1", "标签2"] }); ``` 运行： ```bash node publish.js ``` ## 🎯 使用场景 ### 场景1：检查登录状态 ``` 用户：帮我检查小红书登录状态 → mcporter call xhs-mcp.check_login_status ``` ### 场景2：搜索笔记 ``` 用户：搜索小红书上关于咖啡的内容 → mcporter call xhs-mcp.search_feeds keyword="咖啡" ``` ### 场景3：点赞收藏 ``` 用户：帮我点赞搜索结果的第一篇 → 1. 搜索获取 feed_id 和 xsec_token → 2. mcporter call xhs-mcp.like_feed feed_id=xxx xsec_token=xxx ``` ### 场景4：发布笔记 ``` 用户：帮我发布一篇小红书笔记 → 需要用 Node.js 脚本（MCPorter 不支持数组参数） → node publish.js ``` ## 📁 项目文件位置 - **项目目录**: `D:\work\xiaohongshu\xiaohongshu-mcp-node\` - **主程序**: `src/index.js` - **登录工具**: `src/login.js` - **工具实现**: `src/xhs-tools.js` - **浏览器管理**: `src/browser.js` - **Cookies 存储**: `data/cookies.json` ## 🔧 环境变量 | 变量 | 说明 | 默认值 | |------|------|--------| | `XHS_PORT` | 服务端口 | `18060` | | `XHS_HOST` | 绑定地址 | `0.0.0.0` | | `XHS_PROXY` | 代理地址 | - | 使用代理启动： ```bash XHS_PROXY=http://proxy:port npm start ``` ## ⚠️ 重要注意事项 1. **账号安全**：同一账号不能在多个网页端登录，会互相踢出 2. **发布限制**：每天最多 50 篇笔记 3. **标题限制**：最多 20 字 4. **正文限制**：最多 1000 字 5. **Cookie 有效期**：Cookie 可能过期，需要定期重新登录 ## 💡 最佳实践 1. **简单操作用 MCPorter**：搜索、点赞、收藏、评论 2. **复杂操作用 Node.js**：发布图文、发布视频、批量操作 3. **定时发布**：结合 cron 技能定时调用发布脚本 4. **错误处理**：如果操作失败，先检查登录状态 ## 🔗 相关资源 - MCP 协议: https://modelcontextprotocol.io/ - MCP Inspector: `npx @modelcontextprotocol/inspector`