This project provides an integrated, AI-powered platform for Xiaohongshu (XHS) operations, addressing the fragmentation of existing tools. It targets content creators and marketers seeking to streamline their workflow from data collection and content creation to automated publishing. The platform offers a comprehensive solution, enabling users to manage XHS operations within a single interface, significantly boosting efficiency.

How It Works

XHS_ALL_IN_ONE employs a full-stack architecture combining a Python (FastAPI) backend with a React frontend, leveraging a reverse-engineered XHS PC client SDK for core interactions. It centralizes data scraping, content management in a unified library, AI-driven content rewriting and image enhancement, and automated publishing. The system supports multi-account management and integrates with OpenAI-compatible APIs for its AI features, offering a novel, end-to-end operational pipeline.

Quick Start & Requirements

• Requirements: Python 3.10+, Node.js 20+.
• Installation: Clone the repository, install Python dependencies (pip install -r requirements.txt), and Node.js dependencies (npm install in root and frontend directories).
• Running: Execute python main.py --with-frontend for backend and frontend. Docker Compose is also available.
• Access: Frontend at http://localhost:5173, API documentation at http://localhost:8000/docs.
• Links: Project GitHub, Frontend, API Docs.

Highlighted Details

• End-to-End Workflow: Integrates data scraping, content management, AI rewriting/enhancement, and automated publishing for Xiaohongshu.
• Account Management: Supports multi-account binding (PC/Creator) with secure storage, QR/Cookie login, and automated health checks.
• AI Capabilities: Features AI-powered content rewriting, title polishing, tag generation, and image enhancement using reference images. Supports OpenAI-compatible APIs.
• Automation: Enables fully automated content production pipelines based on configurable keywords and schedules.
• Underlying SDK: Utilizes a reverse-engineered XHS PC client SDK for core platform interactions.

Maintenance & Community

The project is actively developed with a clear roadmap for expanding to other platforms like Douyin, Kuaishou, Weibo, Xianyu, and Taobao. Community interaction is encouraged via a WeChat group for those interested in crawlers and AI Agents. The project is licensed under MIT.

Licensing & Compatibility

The project is released under the MIT License. However, the README explicitly states: "This project is for learning and exchange only, commercial use is prohibited. Consequences are the user's responsibility." This restriction overrides the permissive nature of the MIT license for commercial applications.

Limitations & Caveats

Commercial use is strictly prohibited, despite the MIT license. The platform is currently focused solely on Xiaohongshu, with other platform integrations planned but not yet implemented. Reliance on reverse-engineered SDKs introduces potential fragility against platform updates. AI functionalities require external API key configuration.