Source Code

Xiaohongshu Uploader Skill

This skill provides a Model Context Protocol (MCP) server that allows Clawdbot to upload content to Xiaohongshu.

Features

Smart Login: Automates login session persistence. Just scan the QR code once.
Auto-Upload: Supports uploading images with titles and descriptions via natural language commands.
Title Validation: Automatically validates and trims titles to under 20 characters to ensure proper saving.
Enhanced Save Functionality: Uses "暂存离开" (Save and Exit) button for more reliable draft saving.
Browser Automation: Leveraging Playwright for robust interaction with the Creator Platform.
Improved Error Handling: Better fallback mechanisms and error reporting.

Prerequisites

Node.js installed.
Playwright browsers installed (the setup script will handle this).

Setup

Navigate to the server directory:

cd server
npm install
npm run build
npx playwright install chromium

Add to your Clawdbot/Claude Desktop configuration:

{
  "mcpServers": {
    "xiaohongshu": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/xiaohongshu-upload-skill/server/build/index.js"
      ]
    }
  }
}

Note: Replace /ABSOLUTE/PATH/TO with the actual full path to this skill folder.

Usage

1. Login

First time use requires login.

Command: "Login to Xiaohongshu"
Action: Scan the QR code in the popped-up browser.
Confirmation: Wait for the browser to close or the tool to report success.

2. Upload

Command: "Upload [file] to Xiaohongshu with title [title] and description [content]"
Action: The agent will automate the upload process.
Automatic Title Validation: If your title exceeds 20 characters, it will be automatically truncated to ensure proper saving.

Troubleshooting

Login Failed: Ensure you didn't close the window manually before the success message.
Browser not opening: Check if npx playwright install was run.
Draft not saving: Titles must be under 20 characters. The system will automatically truncate longer titles.
Save button not found: The system now tries multiple save button variations including "暂存离开", "保存草稿", and "存草稿".

xiaohongshu-mcp