xhs-publisher_skill

Overview

This skill automates publishing image-and-text posts to Xiaohongshu (Red) using a browser connected via CDP (agent-browser). It navigates to the Creator Center, uploads one or more images, fills title and body, and triggers one-click publishing. The tool runs from a simple shell wrapper and requires the browser to be already logged into the Creator Center.

How this skill works

The script connects to a running browser via CDP, opens the Xiaohongshu creation page, programmatically interacts with upload controls to add images, populates the title and content fields, and executes the publish action. It accepts command-line arguments for title, images, content (inline or from file), and CDP port, validating inputs before performing the automated UI steps.

When to use it

• Automate regular content publishing to Xiaohongshu to save manual effort.
• Bulk post scheduling or one-off batch uploads with consistent formatting.
• CI or server-side workflows that need to publish generated images and captions.
• Integration with content pipelines that produce images and copy programmatically.
• Testing or validation of publishing flows in a controlled environment.

Best practices

• Ensure the browser session is already logged into Xiaohongshu Creator Center before running the script.
• Keep titles under 20 characters as required by the platform and validated by the tool.
• Provide valid image file paths; verify files exist and are supported image formats.
• Use content file (-f) for longer posts or to avoid shell-escaping issues with special characters.
• Run against a dedicated automation profile or headless browser instance to avoid interfering with manual use.

Example use cases

• Publish a single-image test post from a CI job to verify image generation output.
• Upload a carousel of photos from a travel blog pipeline with a prepared caption file.
• Daily automated posts for social accounts that use templated titles and generated images.
• Batch migration of archived image posts by scripting repeated publish commands.