xhs-kit-publisher

What This Skill Does

The xhs-kit-publisher skill is a specialized automation tool designed for efficient content management on the Xiaohongshu (Little Red Book) platform. Unlike traditional browser-based automation that relies on heavy UI rendering and prone-to-failure interactions, this skill utilizes a lightweight Python-based approach. It enables users to authenticate via QR code, maintain multiple persistent session cookies, and trigger content publishing directly from their terminal or automated scripts. By eliminating the need for a GUI, it significantly reduces system resource consumption and increases the stability of mass-publishing workflows.

Installation

To get started with xhs-kit-publisher, ensure you have Python 3.8+ installed on your system. Follow these steps in your terminal:

1. Create a dedicated virtual environment for the project: python3 -m venv xhs-env && source xhs-env/bin/activate.
2. Install the core library: pip install -U xhs-kit.
3. Ensure browser drivers are available: playwright install chromium.
4. Install necessary support libraries: pip install pillow requests markdown pyyaml. Finally, execute clawhub install openclaw/skills/skills/glittering/xhs-kit-publisher to register the skill within the OpenClaw environment.

Use Cases

• Social Media Marketing: Manage multiple brand accounts simultaneously for consistent cross-posting of promotional content.
• Content Scheduling: Automate the publishing of batches of content at optimal engagement times without manual intervention.
• Mass Posting Operations: Efficiently distribute high volumes of localized content using simple scripts while ensuring safety intervals between posts.
• Automated Reporting & Debugging: Use the built-in debug mode to validate metadata, images, and content formatting before committing to a live publish.

Example Prompts

1. "Publish a new post with title 'Summer Travel Hacks' and content 'Follow these 5 tips for a cheaper vacation' using the account stored in account1.json, and include the image located at ./images/summer.jpg."
2. "Schedule my upcoming promotional content for tomorrow at 10 AM, making sure to use the primary cookie file configured in my environment."
3. "Run a debug test for my draft article to ensure the tags and image size comply with Xiaohongshu platform standards before I perform the final batch upload."

Tips & Limitations

• Rate Limiting: Always include a sleep delay in your scripts if publishing more than five items in quick succession to avoid account flagging.
• Image Optimization: While the tool supports various image formats, keeping file sizes under 2MB ensures faster uploads and better reliability.
• Cookie Security: The generated session cookies grant full access to your account. Ensure the config/ directory permissions are restricted to your user account to prevent unauthorized access.
• Maintenance: Small updates to the platform UI can occasionally break API endpoints; always check the library documentation for updates if you encounter authentication errors.