xiaohongshuskills is a command-line tool for automating content publication, commenting, and search on Xiaohongshu (RED), a Chinese social media platform.
The tool addresses the need to automate repetitive tasks on Xiaohongshu by using Chrome DevTools Protocol to control a browser instance. It handles image and video uploads, fills in titles and descriptions, manages multiple accounts with isolated cookies, and can run in headless mode for background operation. The tool detects login state automatically and switches to windowed mode for QR code scanning when needed. It also supports remote Chrome debugging via configurable host and port parameters, and caches login status locally to reduce repeated verification checks.
Developers should be aware that the README includes a prominent risk warning: using this tool for Xiaohongshu automation carries the risk of account restrictions, rate limiting, account suspension, or bans from the platform. The tool is designed for Windows and requires Python 3.10 or later and Google Chrome. Beyond publishing, the tool offers content search and retrieval capabilities, including fetching home feed recommendations, reading note details with comments, and extracting user profile information. It supports interactive actions like liking, unliking, bookmarking, and unbookmarking notes, as well as posting and replying to comments. The README notes that the tool has been adapted for DOM changes in the Xiaohongshu creator center from February to March 2026, and recommends checking the selector and upload logic in the relevant script if further platform changes occur.
Development activity shows ongoing maintenance focused on platform compatibility. The project includes specific adaptations for recent Xiaohongshu interface changes, with documented selectors and wait strategies for the publishing workflow. The tool supports integration with multiple AI models and services through a sponsorship arrangement, and the maintainer provides a blog documenting usage patterns and experiences.
