xiaohongshu-uploader

name	Xiaohongshu Uploader
description	Upload images and videos to Xiaohongshu Creator Platform using a local MCP server with browser automation. Features enhanced title validation and improved draft saving.

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

1. Navigate to the server directory:

   cd server
   npm install
   npm run build
   npx playwright install chromium
   

2. 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 "存草稿".