xiaohongshu-aio 0.1.0

Xiaohongshu MCP REST API Client

Xiaohongshu MCP Client

English | 简体中文

A Python client for Xiaohongshu MCP (Model Context Protocol) REST API, providing a comprehensive command-line interface for managing Xiaohongshu accounts and interacting with the platform.

Features

• Account Management

  • Add, remove, list, and switch between multiple accounts
  • Import and export cookies
  • Track last used time and account notes
  • Automatic username detection - auto-detects current login nickname when username is not provided
  • Current account management - easily check and switch between accounts

• Login Management

  • Check login status
  • Get login QR code
  • Logout (clear cookies)

• Content Publishing

  • Publish image content with images and tags
  • Publish video content
  • Support for visibility settings

• Feed Management

  • List recommended feeds
  • Search feeds by keyword
  • Get detailed feed information

• Interaction

  • Like/unlike feeds
  • Favorite/unfavorite feeds
  • Post comments

• User Information

  • Get current user profile
  • Get other user profiles

Installation

Prerequisites

• Python 3.12+
• Xiaohongshu MCP server running (default: http://localhost:18060)

Install from source

cd xiaohongshu-aio
pip install -e .

Usage

Command Structure

xhs <command> [options]

Account Management

# List all accounts
xhs account list

# Add a new account (auto-detects username from current login)
xhs account add

# Add a new account with custom username and notes
xhs account add --username myaccount --notes "My personal account"

# Remove an account
xhs account remove --username myaccount

# Switch to another account
xhs account switch --username myaccount

# Import cookies for an account (auto-detects username)
xhs account import

# Import cookies with custom username
xhs account import --username myaccount

# Get current account
xhs account current

Login Management

# Check login status
xhs login status

# Check login status with custom server URL
xhs login status --base-url http://localhost:18060

# Get login QR code
xhs login qrcode

# Logout
xhs login logout

Publishing Content

# Publish image content
xhs publish "Title" "Content" "https://example.com/image1.jpg" "https://example.com/image2.jpg" --tags food travel

# Publish video content
xhs publish "Video Title" "Video content" "C:\path\to\video.mp4" --is-video

# Publish with custom server URL
xhs publish "Title" "Content" "https://example.com/image.jpg" --base-url http://localhost:18060

Feed Management

# List feeds
xhs feed list

# Search feeds
xhs feed search --keyword "coffee"

# Get feed detail
xhs feed detail --feed-id "feed123" --xsec-token "token123"

# Use custom server URL
xhs feed list --base-url http://localhost:18060

Interaction

# Like a feed
xhs interact like "feed123" "token123"

# Unlike a feed
xhs interact like "feed123" "token123" --unlike

# Favorite a feed
xhs interact favorite "feed123" "token123"

# Post a comment
xhs interact comment "feed123" "token123" --content "Great post!"

# Use custom server URL
xhs interact like "feed123" "token123" --base-url http://localhost:18060

User Information

# Get current user profile
xhs user me

# Get other user profile
xhs user profile --user-id "user123" --xsec-token "token123"

# Use custom server URL
xhs user me --base-url http://localhost:18060

Configuration

You can configure the client using environment variables:

Environment Variable	Default Value	Description
XHS_MCP_BASE_URL	http://localhost:18060	MCP server base URL (preferred)
XHS_BASE_URL	http://localhost:18060	MCP server base URL (fallback)
XHS_TIMEOUT	60	HTTP request timeout in seconds
XHS_VERIFY_SSL	true	Whether to verify SSL certificates

Project Structure

xiaohongshu-aio/
├── src/
│   └── xiaohongshu_aio/
│       ├── __init__.py          # Package initialization
│       ├── client.py            # REST API client
│       ├── account.py           # Account management
│       └── cli.py               # Command-line interface
├── pyproject.toml               # Project configuration
├── README.md                    # This file
├── README_en.md                 # English README
└── user_cookies.json            # Account cookies storage

Dependencies

• httpx - Modern HTTP client
• typer - Command-line interface
• pydantic - Data validation
• pydantic-settings - Settings management
• rich - Rich console output

Acknowledgments

This project is based on the xiaohongshu-mcp project. Thanks to the original project author for their contribution.

License

MIT