功能描述

Automate Xiaohongshu (RedNote) content operations using a Python client for the xiaohongshu-mcp server. Use for: (1) Publishing image, text, and video content, (2) Searching for notes and trends, (3) Analyzing post details and comments, (4) Managing user profiles and content feeds. Triggers: xiaohongshu automation, rednote content, publish to xiaohongshu, xiaohongshu search, social media management.

使用说明 (SKILL.md)

Xiaohongshu MCP Skill (with Python Client)

Name: Xiaohongshu (小红书) Automation
Author: borye

Automate content operations on Xiaohongshu (小红书) using a bundled Python script that interacts with the xpzouying/xiaohongshu-mcp server (8.4k+ stars).

Project: xpzouying/xiaohongshu-mcp

1. Local Server Setup

This skill requires the xiaohongshu-mcp server to be running on your local machine.

Step 1: Download Binaries

Download the appropriate binaries for your system from the GitHub Releases page.

Platform	MCP Server	Login Tool
macOS (Apple Silicon)	`xiaohongshu-mcp-darwin-arm64`	`xiaohongshu-login-darwin-arm64`
macOS (Intel)	`xiaohongshu-mcp-darwin-amd64`	`xiaohongshu-login-darwin-amd64`
Windows	`xiaohongshu-mcp-windows-amd64.exe`	`xiaohongshu-login-windows-amd64.exe`
Linux	`xiaohongshu-mcp-linux-amd64`	`xiaohongshu-login-linux-amd64`

Grant execute permission to the downloaded files:

chmod +x xiaohongshu-mcp-darwin-arm64 xiaohongshu-login-darwin-arm64

Step 2: Login (First Time Only)

Run the login tool. It will open a browser window with a QR code. Scan it with your Xiaohongshu mobile app.

./xiaohongshu-login-darwin-arm64

Important: Do not log into the same Xiaohongshu account on any other web browser, as this will invalidate the server's session.

Step 3: Start the MCP Server

Run the MCP server in a separate terminal window. It will run in the background.

# Run in headless mode (recommended)
./xiaohongshu-mcp-darwin-arm64

# Or, run with a visible browser for debugging
./xiaohongshu-mcp-darwin-arm64 -headless=false

The server will be available at http://localhost:18060.

2. Using the Skill

This skill includes a Python client (scripts/xhs_client.py) to interact with the local server. You can use it directly from the shell.

Available Commands

Command	Description	Example
`status`	Check login status	`python scripts/xhs_client.py status`
`search \x3Ckeyword>`	Search for notes	`python scripts/xhs_client.py search "咖啡"`
`detail \x3Cid> \x3Ctoken>`	Get note details	`python scripts/xhs_client.py detail "note_id" "xsec_token"`
`feeds`	Get recommended feed	`python scripts/xhs_client.py feeds`
`publish \x3Ctitle> \x3Ccontent> \x3Cimages>`	Publish a note	`python scripts/xhs_client.py publish "Title" "Content" "url1,url2"`

Example Workflow: Market Research

Check Status: First, ensure the server is running and you are logged in.
```
python ~/clawd/skills/xiaohongshu-mcp/scripts/xhs_client.py status
```
Search for a Keyword: Find notes related to your research topic. The output will include the feed_id and xsec_token needed for the next step.
```
python ~/clawd/skills/xiaohongshu-mcp/scripts/xhs_client.py search "户外电源"
```
Get Note Details: Use the feed_id and xsec_token from the search results to get the full content and comments of a specific note.
```
python ~/clawd/skills/xiaohongshu-mcp/scripts/xhs_client.py detail "64f1a2b3c4d5e6f7a8b9c0d1" "security_token_here"
```
Analyze: Review the note's content, comments, and engagement data to gather insights.

安全使用建议

Install only if you trust the upstream xiaohongshu-mcp binaries and are comfortable giving a local service access to your Xiaohongshu account. Verify releases where possible, use a low-risk account, stop the server when not in use, and manually review every title, body, image URL, and tag before running the publish command.

功能分析

Type: OpenClaw Skill Name: xiaohongshu-mcp Version: 1.0.0 The skill is classified as suspicious due to its reliance on external, third-party binaries for core functionality. The `SKILL.md` explicitly instructs the user to download and execute `xiaohongshu-mcp` and `xiaohongshu-login` binaries from a GitHub repository, which then run a local server. While the bundled Python client (`scripts/xhs_client.py`) only communicates with this local server (`http://localhost:18060`) and does not exhibit direct malicious behavior (e.g., data exfiltration, remote execution), the requirement to run untrusted external executables introduces a significant supply chain risk and places a high trust burden on the user for a component outside the skill bundle's direct control.

能力评估

⚠ Purpose & Capability

The purpose matches the artifacts: search, read details, feeds, and publish Xiaohongshu content through a local server. The concern is that publishing is a high-impact, public account action and the client sends it directly to the publish endpoint.

⚠ Instruction Scope

The documentation discloses the commands and localhost server, but it does not require a preview, dry run, or explicit confirmation before posting live content. The trigger phrase 'social media management' is also broader than Xiaohongshu-specific use.

⚠ Install Mechanism

Setup instructs users to download, chmod, and run external GitHub release binaries for login and server operation without a pinned version, checksum, or signature verification in the skill artifacts.

⚠ Credentials

An authenticated Xiaohongshu session is expected for the skill's purpose, but it gives the local server account-level authority including posting and reading account-related/feed data.

ℹ Persistence & Privilege

The server is intentionally run as a local background service on localhost:18060. This is disclosed, but users need to stop it when finished because it remains tied to the authenticated session.

版本历史

v1.0.0

Initial release of xiaohongshu-mcp skill. - Automate Xiaohongshu (RedNote) content operations via Python client for the xiaohongshu-mcp local server. - Supports publishing image, text, and video content to Xiaohongshu. - Enables searching for notes and trending topics, analyzing post details and comments, and managing user feeds and profiles. - Provides clear setup instructions for running the required local server and login steps. - Includes CLI Python script with commands for status checks, searching, publishing, and retrieving detailed note information.

元数据

Slug xiaohongshu-mcp

版本 1.0.0

许可证 —

累计安装 337

当前安装数 316

历史版本数 1

常见问题

Xiaohongshu (小红书) Automation 是什么？

Automate Xiaohongshu (RedNote) content operations using a Python client for the xiaohongshu-mcp server. Use for: (1) Publishing image, text, and video content, (2) Searching for notes and trends, (3) Analyzing post details and comments, (4) Managing user profiles and content feeds. Triggers: xiaohongshu automation, rednote content, publish to xiaohongshu, xiaohongshu search, social media management. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 38549 次。

如何安装 Xiaohongshu (小红书) Automation？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install xiaohongshu-mcp」即可一键安装，无需额外配置。

Xiaohongshu (小红书) Automation 是免费的吗？

是的，Xiaohongshu (小红书) Automation 完全免费（开源免费），可自由下载、安装和使用。

Xiaohongshu (小红书) Automation 支持哪些平台？

Xiaohongshu (小红书) Automation 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Xiaohongshu (小红书) Automation？

由 Borye（@borye）开发并维护，当前版本 v1.0.0。

Xiaohongshu (小红书) Automation