mrkeyoor.com_
Tue 04 Aug 15:50 UTC
AI Toolsevaluationupdated 02 Aug 2026

xiaohongshu-mcp

xiaohongshu-mcp is a tool that creates a local server to let you, or more specifically, an AI assistant, programmatically control a Xiaohongshu account. It bridges the gap between AI agents and the popular Chinese social media platform, allowing them to perform actions like posting content, searching, commenting, and analyzing trends without manual intervention.

Verdict

If you need to give an AI agent the keys to a Xiaohongshu account, xiaohongshu-mcp is the most powerful and feature-rich open-source tool for the job. It’s well-maintained and impressively comprehensive. However, be prepared for a command-line-based setup and be fully aware of the inherent risks of automating any social media platform with an unofficial tool.

Setup3/5Binaries help, but the required headless browser download and troubleshooting links show it's not foolproof.
Docs4/5Excellent structure with videos, but primarily in Chinese which may be a hurdle for some.
Community4/5Extremely popular (15k stars) with recent updates, but has a fair number of open issues (70).
Maturity4/5At v2.4.3, with a stable feature set and clear risk warnings. Not a toy project.

Who it’s for

  • Social media managers and marketers automating content pipelines for the Chinese market.
  • Developers building AI agents or bots that need to interact with Xiaohongshu as part of a larger workflow.
  • Data analysts looking to programmatically extract post details, comments, and user information for trend analysis.
  • Go developers who want a server-based tool for social media automation that they can easily integrate with.

Who it’s NOT for

  • Non-technical users looking for a simple, graphical application. The project recommends its sister browser-extension project, x-mcp, for this audience for a reason.
  • Anyone managing mission-critical or high-value accounts who cannot tolerate any risk of account suspension. This is an unofficial tool and uses automation that could be flagged by the platform.
  • Users who are uncomfortable with command-line tools, managing files, or basic network concepts. While there are binaries, it's not a double-click-and-go experience.

Setup reality

The README promotes a "quick start" with pre-compiled binaries, which is a big plus over forcing everyone to compile from source. However, it's not as simple as it sounds. The first time you run the tool, it automatically downloads a headless browser that's around 150MB, which can be slow and surprising. The documentation also prominently links to a troubleshooting guide for common Docker deployment issues and repeatedly suggests that less technical users should opt for the simpler browser extension instead. This implies that while setup can be straightforward, it's common enough for users to run into problems that require some debugging.

Xiaohongshu, or "Little Red Book," is a titan in the Chinese social media and e-commerce landscape, blending content, community, and commerce in a way that few Western platforms have managed. For brands, marketers, and creators, it’s a critical channel. But managing it, especially at scale or as part of an automated workflow, is a manual, time-consuming process. xpzouying/xiaohongshu-mcp is a Go-based tool designed to solve exactly this problem by providing a programmatic interface to control a Xiaohongshu account.

More than just a simple API wrapper, this project implements the Model Context Protocol (MCP), positioning itself as a ready-made "skill" for AI agents like Claude. It runs a local server that translates simple commands into complex, automated browser actions, allowing an AI to post content, scrape data, and engage with the community on your behalf.

A Comprehensive Automation Toolkit

The most striking aspect of xiaohongshu-mcp is its feature depth. This isn't just a script for uploading posts; it's a nearly complete toolkit for platform interaction. The functionality covers the entire lifecycle of content management and community engagement.

On the content creation side, it supports both image and video posts. The developer has made smart choices here, such as recommending the use of local file paths over URLs for images to improve speed and reliability. For video, it only supports local files, acknowledging the complexities of video processing and providing a stable path forward. This shows a practical, experience-driven approach to design.

Beyond posting, the tool offers a rich set of data retrieval and interaction APIs. You can search for content by keyword, fetch the recommended feed, and pull detailed information about any post, including its engagement stats (likes, saves, comments) and the full comment thread. You can also retrieve user profile information. This makes it valuable not just for publishing but also for analysis and monitoring.

Where it truly shines for automation is in its interaction capabilities. The tool can post comments on your behalf, reply to specific existing comments, and handle likes and collections. The like/collect functions are even idempotent, meaning the tool is smart enough to check if a post is already liked before attempting the action, preventing errors from repeated commands. This level of detail is what separates a simple script from a robust automation tool.

Navigating Setup and Inherent Risks

The project offers multiple paths for setup, catering to different user types. For developers, there's source compilation and a Docker image. For a quicker start, the author provides pre-compiled binaries for major platforms (macOS, Windows, Linux), which is the recommended approach. However, the setup isn't entirely frictionless. The first run triggers a ~150MB download of a headless browser, a dependency used to perform the automation. This is a common pattern for such tools, but it's an important detail to be aware of.

The README is refreshingly honest about potential difficulties. It prominently links to a GitHub issue dedicated to troubleshooting and frequently suggests that non-technical users should use a separate, much simpler browser extension project (x-mcp). This self-awareness is commendable; it acknowledges that the core project, while powerful, requires a certain level of technical comfort.

More importantly, the author directly addresses the risks. Automating a social media account with an unofficial tool always carries the possibility of being flagged or banned. The author notes that their own accounts have been stable for over a year, with the main issue being cookie expiration. They also warn that new, unverified accounts are likely to be prompted for real-name verification, which is a platform requirement, not a fault of the tool. This transparency is crucial for any potential user to make an informed decision.

Community and Project Health

With over 15,000 stars on GitHub, xiaohongshu-mcp is clearly a popular and trusted project within its niche. The latest release was on the day of this review (August 2, 2026), and with 27 contributors, it's an active and collaborative effort. The project even collects donations for charity, adding a positive community-oriented touch.

The 70 open issues could be seen as a negative, but in a project this popular, it's more likely a sign of an engaged user base reporting edge cases and suggesting features. It does mean that while the core functionality is stable, you might encounter specific bugs depending on your use case.

The documentation in the README is excellent, featuring collapsible sections with video demonstrations for nearly every feature. Its primary language is Chinese, which is logical given the target platform, but might present a minor barrier for a global audience. However, the code snippets and commands are clear enough to be understood universally.

In a modern AI stack, xiaohongshu-mcp fits in as a specialized tool or "skill" that an orchestrator or agent framework (like the mentioned Openclaw) would call. It’s the hands and eyes on a specific platform, waiting for instructions from a higher-level AI brain. For any team building automated marketing or content systems targeting the Chinese market, this project provides a vital, ready-to-deploy component.

Alternatives

ProjectWhat it isPick it when
x-mcpA browser extension version of xiaohongshu-mcp for zero-configuration use.you are not a developer and want the easiest possible way to use these features without touching a terminal or Docker.
go-redbookA Go SDK (library) for interacting with the Xiaohongshu API.you are building a custom Go application and want to integrate Xiaohongshu functions directly as a library, rather than running a separate server.
xhs-apiA Python package for interacting with Xiaohongshu's API.your automation stack is built in Python and you prefer using a native Python library.

Sources

  1. xpzouying/xiaohongshu-mcp Repo
  2. Project Homepage