小红书 MCP 技能

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

快速开始

首次使用：

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

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

功能列表（13个工具）

使用方式

方式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_PROXY=http://proxy:port npm start