← all repositories
xpzouying/xiaohongshu-mcp

Automating China's Instagram Without an Official API

This MCP server pilots a headless browser to let AI assistants post, search, like, and comment on Xiaohongshu, which offers no public API.

14.8k stars Go Coding Assistants
xiaohongshu-mcp
Velocity · 7d
+17
★ / day
Trend
accelerating
star history

What it does Wraps the Chinese lifestyle platform Xiaohongshu in a Model Context Protocol server, exposing login, publishing, search, and social interaction as tools for AI assistants. It handles text-and-image posts, video uploads, comments, likes, favorites, and profile scraping—essentially the full surface area of a human user.

The interesting bit Xiaohongshu offers no official API, so the project drives a headless browser to simulate real user behavior. The author claims a predecessor automation ran for over a year without bans, and this MCP version was validated with Claude Code for weeks before release.

Key highlights

  • Full read-write access: publish posts (images or local video), search feeds, read comments, reply, like, and favorite
  • Anti-duplicate smarts: like and favorite tools check current state before acting to avoid redundant requests
  • Browser plugin alternative (x-mcp) available for users who want zero configuration
  • All donations go to charity; the project is explicit about its educational purpose
  • Account restrictions apply: new accounts may need real-name verification, and simultaneous web logins kick the MCP session offline

Caveats

  • First run downloads a ~150MB headless browser
  • Many actions require both a post ID and an xsec_token scraped from feed or search results
  • Video uploads only work from local file paths, not URLs
  • The README notes a daily posting ceiling of roughly 50 posts and warns that content must avoid banned words and reposting

Verdict Social media managers and developers building AI agents for Chinese platforms should look here; anyone needing a stable, officially supported API should look elsewhere.

Frequently asked

What is xpzouying/xiaohongshu-mcp?
This MCP server pilots a headless browser to let AI assistants post, search, like, and comment on Xiaohongshu, which offers no public API.
Is xiaohongshu-mcp open source?
Yes — xpzouying/xiaohongshu-mcp is an open-source project tracked on heatdrop.
What language is xiaohongshu-mcp written in?
xpzouying/xiaohongshu-mcp is primarily written in Go.
How popular is xiaohongshu-mcp?
xpzouying/xiaohongshu-mcp has 14.8k stars on GitHub and is currently accelerating.
Where can I find xiaohongshu-mcp?
xpzouying/xiaohongshu-mcp is on GitHub at https://github.com/xpzouying/xiaohongshu-mcp.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.