CommunityCoding & Developmentgithub.com

xcbbdg1-maker/post-to-xhs

Xiaohongshu (RED) image-text/video posting, content search, and creator data dashboard Codex Skill

What is post-to-xhs?

This skill enables AI agents (like Codex, Cursor) to interact with Xiaohongshu (RED), a popular social media and e-commerce platform in China. It supports posting image-text articles and videos, searching for content, and accessing creator data dashboards. Developers and users can leverage this skill to automate content publishing, retrieve analytics, and manage their Xiaohongshu presence programmatically. It works through an API or CLI interface, handling authentication and media uploads. By integrating this skill, agents can streamline social media workflows, monitor engagement metrics, and respond to trends efficiently.

Works with~Claude Code✓Codex CLI~Cursor
npx skills add xcbbdg1-maker/post-to-xhs

Installed? Explore more Coding & Development skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

What does post-to-xhs do?

Xiaohongshu (RED) image-text/video posting, content search, and creator data dashboard Codex Skill

Overview

This skill allows AI agents to interact with the Xiaohongshu (RED) platform. It provides capabilities for:

  • Posting: Create and publish image-text articles and videos to Xiaohongshu.
  • Content Search: Search for posts, tags, and user content on the platform.
  • Creator Dashboard: Retrieve analytics and performance data for your creator account.

Usage

Prerequisites

  • A valid Xiaohongshu developer account or API key.
  • Authentication credentials (configurable via environment variables).

Commands

  • post-image-text [file] [caption] — Post an image-text article.
  • post-video [file] [title] [description] — Upload a video with metadata.
  • search [query] — Search for content on Xiaohongshu.
  • dashboard — Retrieve creator account statistics and insights.

Configuration

Set the following environment variables:

  • XHS_API_KEY — Your Xiaohongshu API key.
  • XHS_SECRET — Your API secret.
  • XHS_ACCOUNT_ID — Your creator account ID.

Example

# Post an image-text article
post-image-text ./image.jpg "My latest travel adventure"

# Search for trending tags
search "digital marketing"

Notes

  • Ensure you comply with Xiaohongshu's terms of service when using this skill.
  • Rate limiting may apply; check the API documentation for limits.

Related Skills