小红书 MCP 服务

小红书（XHS/RED）自动化助手。完整的小红书操作能力，包含 MCP 服务端。 当用户提到小红书、红书、XHS、RED、发笔记、搜笔记、小红书运营等任何与小红书相关的操作时使用此技能。

小红书 MCP 技能

完整的小红书自动化技能，包含独立服务端，开箱即用。

快速开始

首次使用：

cd <技能目录>
npm install
npm run login  # 扫码登录

日常使用： 技能会自动启动服务，无需手动操作。

功能列表（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_profile	获取用户主页	user_id, xsec_token
publish_content	发布图文	title, content, images, tags?
publish_with_video	发布视频	title, content, video, tags?

使用方式

方式1：Node.js 直接调用（推荐）

import { searchFeeds, likeFeed, publishContent } from './scripts/xhs-tools.js';

// 搜索笔记
const results = await searchFeeds('咖啡');

// 点赞
if (results.feeds[0]) {
  await likeFeed(results.feeds[0].id, results.feeds[0].xsec_token);
}

// 发布图文
await publishContent({
  title: '我的笔记',
  content: '正文内容',
  images: ['./photo1.jpg'],
  tags: ['美食']
});

方式2：MCP 服务调用

服务默认运行在 http://localhost:18060/mcp

# 启动服务（通常自动启动）
npm start

# 通过 MCP Inspector 调试
npx @modelcontextprotocol/inspector http://localhost:18060/mcp

方式3：命令行快速操作

# 检查登录
node -e "import('./scripts/xhs-tools.js').then(m => m.checkLoginStatus()).then(console.log)"

# 搜索
node -e "import('./scripts/xhs-tools.js').then(m => m.searchFeeds('美食')).then(r => console.log(r.feeds.length))"

服务管理

检查服务状态：

node scripts/ensure-service.js status

启动服务：

node scripts/ensure-service.js start

停止服务：

node scripts/ensure-service.js stop

详细文档

• API 文档 - 完整的 API 参考和示例

注意事项

1. 账号安全：同一账号不能在多个网页端登录
2. 发布限制：每天最多 50 篇笔记
3. 标题限制：最多 20 字
4. 正文限制：最多 1000 字
5. Cookie 有效期：建议每周重新登录一次

环境变量

变量	说明	默认值
XHS_PORT	服务端口	18060
XHS_HOST	绑定地址	0.0.0.0
XHS_PROXY	代理地址	-

使用代理：

XHS_PROXY=http://proxy:port npm start