# xiaohongshu-mcp-integration

The xiaohongshu-mcp-integration skill connects an MCP server for Xiaohongshu to an AI coding agent, covering search, publishing, account actions, and content workflows.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 235 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/xiaohongshu-mcp-integration/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/xiaohongshu-mcp-integration

## What it does

The skill lets an AI agent use Xiaohongshu through an MCP server backed by browser automation. It covers sign-in and session checks, image and video publishing, keyword search, recommendation feeds, post details, user profiles, comments, replies, likes, and favorites.

An account login is needed before most operations. Post titles are limited to 20 characters and post text to 1000 characters; video uploads accept local files only. That local-file limit affects how video publishing requests must be prepared. The server can run from a released binary, in Docker, or from a source build, with settings for session storage and the HTTP port.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill xiaohongshu-mcp-integration -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/xiaohongshu-mcp-integration/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/xiaohongshu-mcp-integration/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill xiaohongshu-mcp-integration -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/xiaohongshu-mcp-integration/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill xiaohongshu-mcp-integration -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/xiaohongshu-mcp-integration/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/xiaohongshu-mcp-integration
```

2. **Manually: put the files in place**
- File: `.github/skills/xiaohongshu-mcp-integration/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill xiaohongshu-mcp-integration -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/xiaohongshu-mcp-integration
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/xiaohongshu-mcp-integration/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill xiaohongshu-mcp-integration -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/xiaohongshu-mcp-integration/SKILL.md

## When to use it
- search Xiaohongshu posts by keyword
- publish image posts with local media
- upload a video from a local file
- inspect post details and engagement data
- reply to comments and update reactions

## Example prompts
- Search Xiaohongshu for posts about home cooking and return their details.
- Create an image post from `/Users/me/Pictures/food1.jpg` and `/Users/me/Pictures/food2.jpg`, then publish it.
- Check whether the Xiaohongshu account is logged in, then reply to a comment on the selected post.

## Similar
- [xiaohongshu-auto-posting](https://affpapa.org/en/nevibecode/skills/xiaohongshu-auto-posting.md) — skill · 1 install
- [xiaohongshu-cli](https://affpapa.org/en/nevibecode/skills/xiaohongshu-cli.md) — skill · 1400 installs
- [xiaohongshu-images](https://affpapa.org/en/nevibecode/skills/xiaohongshu-images.md) — skill · 2000 installs
- [xiaohongshu-cover-generator](https://affpapa.org/en/nevibecode/skills/xiaohongshu-cover-generator.md) — skill · 1900 installs
- [brand-operation](https://affpapa.org/en/nevibecode/skills/brand-operation.md) — skill · 339 installs
- [user-generated-content](https://affpapa.org/en/nevibecode/skills/user-generated-content.md) — skill · 160 installs

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
