Xiaohongshu Uploader

What This Skill Does

The Xiaohongshu Uploader is a powerful OpenClaw AI agent skill designed to streamline content distribution to the Xiaohongshu Creator Platform. By leveraging a local Model Context Protocol (MCP) server, this tool automates the repetitive browser interactions required to publish posts. It handles the complex lifecycle of browser automation using Playwright, ensuring that session persistence is maintained after a single initial QR code scan. Beyond simple uploads, the skill introduces intelligent safeguards, such as automatic title validation that truncates text to fit within platform constraints, and multi-modal save button detection (including '暂存离开') to ensure your drafts are securely preserved even if network interruptions occur.

Installation

To integrate this skill, navigate to the server folder within the skill directory and run npm install. Once dependencies are resolved, execute the build process and ensure the browser environment is ready by running npx playwright install chromium. Finally, register the MCP server in your Clawdbot or Claude Desktop configuration file. You must provide the absolute file path to the index.js file to allow the MCP host to spawn the server process successfully. This local execution model ensures that your session cookies and authentication credentials remain solely under your control on your machine.

Use Cases

This skill is ideal for content creators, social media managers, and digital marketers who rely on Xiaohongshu for reach. It is perfect for automating the upload of product images, batch posting creative assets, or maintaining a consistent draft queue without needing to manually click through browser menus. If you are producing media at scale, this tool removes the manual friction of the platform's web interface.

Example Prompts

1. "Login to Xiaohongshu so I can start scheduling my posts for this week."
2. "Upload the photo at ./travel_vlog.jpg to Xiaohongshu with the title 'Must visit cafes in Shanghai' and description 'Here are my top 5 picks for the best coffee in the city.'"
3. "Upload the latest product teaser video to my Xiaohongshu account with the caption 'Check out our new summer collection!'"

Tips & Limitations

For optimal performance, always ensure you wait for the initial login session to be confirmed before attempting bulk uploads. The system performs automatic title truncation to under 20 characters; if your title needs to be longer, please provide it in the body content instead. The skill relies on browser automation, meaning it may need to be updated if the Xiaohongshu platform updates its CSS selectors or UI layout. Avoid closing the browser window manually while a tool is active, as this may interrupt the session persistence mechanism. If you encounter save issues, verify that you have a stable internet connection and that you haven't exceeded the daily posting limits set by the platform.