This toolkit provides automated content creation and publishing for Xiaohongshu (Little Red Book) creators, integrating with AI clients like Claude Desktop via the MCP protocol. It targets Xiaohongshu creators seeking to streamline their workflow, automate data collection, and leverage AI for content optimization and analysis.

How It Works

The toolkit utilizes a Python-based framework that interacts with Xiaohongshu through automated browser control (Selenium/ChromeDriver) and the Message Communication Protocol (MCP). It manages user cookies for authentication, automates the posting of text, images (local and URL), and videos, and collects creator data from the dashboard and content analytics. The MCP server allows AI clients to trigger these actions through conversational prompts, enabling AI-assisted content generation and data analysis.

Quick Start & Requirements

• Install: Clone the repository and run ./xhs (Mac/Linux) or xhs.bat (Windows). Dependencies can be installed via install_deps.py or pip install -r requirements.txt.
• Prerequisites: Google Chrome (latest version recommended), matching ChromeDriver version.
• Configuration: Requires setting CHROME_PATH and WEBDRIVER_CHROME_DRIVER in a .env file.
• Docs: https://github.com/aki66938/xhs-toolkit

Highlighted Details

• Supports AI-driven content creation and publishing via MCP protocol integration with clients like Claude Desktop.
• Automates data collection for creator dashboards, content performance, and fan analytics, with CSV storage.
• Features a user-friendly interactive menu system (./xhs) and manual operation tools (./xhs manual ...).
• Includes support for local and network image URLs in posts.

Maintenance & Community

The project is actively maintained with recent updates including an interactive menu system, manual operation tools, and improved dependency management. Community contributions are welcomed via Pull Requests or Issues.

Licensing & Compatibility

• License: MIT License.
• Compatibility: Permissive MIT license allows for commercial use and integration with closed-source applications.

Limitations & Caveats

The project relies heavily on the stability of Xiaohongshu's web interface and ChromeDriver compatibility. Version mismatches between Chrome and ChromeDriver are a common source of issues. Future development includes headless login, multi-account management, and Dockerization.