osfeed.dev
Projects/xpzouying / xiaohongshu-mcp

xiaohongshu-mcp

An MCP server for Xiaohongshu

Get it on GitHub
Unclaimed

Written by @iluxav from the project's code and releases, not by its maintainers. Last updated for v2.5.5 (2026-09-22), so it may lag behind newer releases.

Are you @xpzouying?Claim it, and your coding agent keeps it current with each release
v2.5.5 · 22 things you can do 16.2k stars 13 changes to know before upgrading

Search Xiaohongshu posts, read comments and profiles, and publish image or video posts through MCP or HTTP.

What you can do with xiaohongshu-mcp

Publish Xiaohongshu posts with a title, text, images and topic tags.

Present at v2025.10.08.0341-66aa36b
Good to know

Requires login and at least one image, supplied as an HTTP/HTTPS URL or absolute local path.

Share
Wrong?

Publish a local video to Xiaohongshu with a title, text and tags.

Present at v2025.10.08.0341-66aa36b
Good to know

Requires login and one absolute local video path; HTTP video URLs are unsupported.

Share
Wrong?

Search Xiaohongshu posts by keyword.

Present at v2025.10.08.0341-66aa36b
Good to know

Requires login.

Share
Wrong?

Read a post's content, images, author, interaction counts and comments.

Present at v2025.10.08.0341-66aa36b
Good to know

Requires login, the post ID and its xsec_token from a search or feed result.

Share
Wrong?

Read a Xiaohongshu user's profile, statistics and published notes.

Present at v2025.10.08.0341-66aa36b
Good to know

Requires login; other users' favorites and likes may be private. user_profile requires user_id and xsec_token.

Share
Wrong?

Post a comment on a Xiaohongshu note.

Present at v2025.10.08.0341-66aa36b
Good to know

Requires login, feed_id, xsec_token and comment text.

Share
Wrong?

Like or unlike a Xiaohongshu post.

Present at v2025.10.08.0341-66aa36b
Good to know

Requires login, feed_id and xsec_token; unlike=true reverses a like.

Share
Wrong?
Show all 22

Favorite or unfavorite a Xiaohongshu post.

Present at v2025.10.08.0341-66aa36b
Good to know

Requires login, feed_id and xsec_token; unfavorite=true removes the favorite.

Share
Wrong?

Log in with a QR code and check the saved login state.

Present at v2025.10.08.0341-66aa36b
Good to know

Cookies can expire; logging into the same account in another web session can invalidate this session.

Share
Wrong?

Call Xiaohongshu operations from MCP clients or the HTTP API.

Present at v2025.10.08.0341-66aa36b
Good to know

The local service must be running; individual operations require login.

Share
Wrong?

Run the Xiaohongshu service in a Docker container.

Present at v2025.10.08.0341-66aa36b
Good to know

Requires Docker and persistent storage for login cookies and images.

Share
Wrong?

Reply to a specific comment on a Xiaohongshu post.

Since v2026.01.05.1503-3cdfe46
Good to know

Requires login, feed_id, xsec_token and either comment_id or user_id.

Share
Wrong?

Schedule an image or video post to publish later.

Since v2026.01.17.0408-e467f84
Good to know

Requires login; schedule_at must be an RFC3339 timestamp between one hour and 14 days ahead.

Share
Wrong?

Attach products found by name or ID to an image or video post.

Since v2026.03.09.0605-0e16f4b
Good to know

The account must have product functionality enabled; the first matching search result is selected.

Share
Wrong?

Choose public, self-only or mutual-follower visibility for a post.

Since v2026.03.09.0605-0e16f4b
Good to know

The visibility value must be 公开可见, 仅自己可见 or 仅互关好友可见; omission defaults to public.

Share
Wrong?

Declare an image post as original when publishing.

Since v2026.03.09.0605-0e16f4b
Good to know

Requires is_original=true; publication stops if the originality declaration fails.

Share
Wrong?

Route the automated browser's Xiaohongshu traffic through a proxy.

Since v2026.03.09.0605-0e16f4b
Good to know

Configure XHS_PROXY with an HTTP, HTTPS or SOCKS5 proxy URL.

Share
Wrong?

Prepare and publish content from a URL with the bundled post-to-xhs workflow.

Since v2026.03.09.0605-0e16f4b
Good to know

Separate browser-based workflow; requires its browser setup and a logged-in account.

Share
Wrong?

Publish a long article with a layout template using the bundled post-to-xhs workflow.

Since v2026.03.09.0605-0e16f4b
Good to know

Uses the bundled skill's browser workflow, not a long-article MCP endpoint.

Share
Wrong?

Read unread counts and notifications, reply to comments, and like or unlike notification comments.

1 other tool for: Manage notifications
Since v2.4.3
Good to know

Requires login; list tabs are mentions, likes or connections, with a default limit of 20; non-normal entries are filtered.

Share
Wrong?

Restrict access to Xiaohongshu HTTP and MCP operations with a bearer token.

Since v2.5.0
Good to know

Set AUTH_TOKEN or -token and configure clients with Authorization: Bearer <token>; /health and CORS OPTIONS remain public.

Share
Wrong?

Before you upgrade xiaohongshu-mcp

Newest first
Show 10 older
Removed 3

Run the Xiaohongshu service and login tool on an Intel Mac.

Uses the darwin-amd64 release binaries.

Removedv2025.10.08.0341-66aa36b → v2.1.0

Run the Xiaohongshu service in an ARM64 Docker container.

Requires Docker and saved account cookies.

Removedv2025.11.05.1527-1947170 → v2.1.0

Run the service and login tool using Linux ARM64 release binaries.

Requires a browser and account login.

Removedv2026.02.18.0511-abe2afa → v2.1.0
xiaohongshu-mcp release history 15
v2.5.5
with v2.5.1, v2.5.2, v2.5.3

Apply search filters when duplicate hidden options or hover-panel movement previously prevented selection.

Details

Filter clicks stay inside the panel and choose visible options. Publishing initializes the creator session, and detail-page operations wait for required containers.

Also: Publishing handles creator-session setup and image-editor guides; post details no longer wait for the whole page to stop changing.

v2.5.5, including v2.5.1, v2.5.2 and v2.5.3; requires login.

Now works / inferred: Search Xiaohongshu posts by keyword.Now works / inferred: Publish Xiaohongshu posts with a title, text, image…Now works / inferred: Publish a local video to Xiaohongshu with a title,…Now works / inferred: Read a post's content, images, author, interaction…

Seeded by @iluxav with Codex

Read the evidence
v2.5.0

Require a bearer token before clients can call the HTTP API or MCP tools.

Details

`AUTH_TOKEN` or a nonempty `-token` enables optional authentication; the command-line value takes precedence. Health checks and CORS preflight remain public.

v2.5.0; authentication is disabled unless a token is configured.

Added: Restrict access to Xiaohongshu HTTP and MCP operati…

Seeded by @iluxav with Codex

Read the evidence
v2.4.3
with v2.1.1, v2.2.0, v2.2.1, v2.2.2, v2.2.3, v2.2.4, v2.2.5, v2.2.6, v2.2.7, v2.3.0, v2.4.0, v2.4.1, v2.4.2

Read and respond to Xiaohongshu notifications from MCP or HTTP.

Details

Notification tools read unread counts and lists, reply, and like comments. This group also changes browser selection, cookie storage, comment limits and client connection behavior.

Also: Profile tabs, video metadata, nested replies and direct MCP calls are available; browser and cookie changes require upgrade attention.

Through v2.4.3. Native support is macOS Apple Silicon, Windows x64 and Linux x64; the bundled browser is required.

Added: Read unread counts and notifications, reply to comm…Improved / inferred: Read a Xiaohongshu user's profile, statistics and p…Now works / inferred: Read a post's content, images, author, interaction…Now works / inferred: Reply to a specific comment on a Xiaohongshu post.Now works / inferred: Search Xiaohongshu posts by keyword.Behavior changed: Search Xiaohongshu posts by keyword.Behavior changed: Read posts recommended on the Xiaohongshu homepage.Improved: Call Xiaohongshu operations from MCP clients or the…Action required: Call Xiaohongshu operations from MCP clients or the…Now works / inferred: Log in with a QR code and check the saved login sta…Improved / inferred: Like or unlike a Xiaohongshu post.Improved / inferred: Favorite or unfavorite a Xiaohongshu post.Now works / inferred: Publish Xiaohongshu posts with a title, text, image…

Seeded by @iluxav with Codex

Read the evidence
v2.1.0
with v2026.07.20.0701-a7d1f2f, v2026.07.23.0205-85aed8b, v2026.07.26.0402-a32150a, v1.2.8, v2026.07.26.0642-cbcaec5, v1.2.9, v2026.07.26.0753-4082976, v2026.07.26.0755-efe6797, v2026.07.26.0810-98d65a4, v2026.07.26.0813-c473315, v2026.07.26.0816-e9e5781, v2026.07.26.0833-9b2a861, v2026.07.26.1004-d680e83, v2026.07.26.1021-4ceb2c3, v2026.07.26.1049-058e7b3, v2026.07.26.1327-b8412a2, v2.0.0, v2.0.1

Read video stream URLs and subtitles from Xiaohongshu post details.

Details

Post details return video metadata, and saved sessions retain their browser seed. The bundled browser becomes mandatory and cookie-file precedence changes.

Also: Cookie storage and browser requirements change; unsupported platforms are dropped.

Through v2.1.0; macOS Apple Silicon, Windows x64 and Linux x64 are supported.

Improved / inferred: Read a post's content, images, author, interaction…Behavior changed: Read a post's content, images, author, interaction…Action required: Call Xiaohongshu operations from MCP clients or the…Action required / inferred: Log in with a QR code and check the saved login sta…Behavior changed: Log in with a QR code and check the saved login sta…Now works / inferred: Log in with a QR code and check the saved login sta…Removed: Run the Xiaohongshu service and login tool on an In…Removed: Run the service and login tool using Linux ARM64 re…Removed / inferred: Run the Xiaohongshu service in an ARM64 Docker cont…Behavior changed: Post a comment on a Xiaohongshu note.Behavior changed: Publish a local video to Xiaohongshu with a title,…Behavior changed: Declare an image post as original when publishing.

Seeded by @iluxav with Codex

Read the evidence

Start the Docker service without downloading its browser at runtime.

Details

Docker images preinstall CloakBrowser Chromium and use it as their default browser.

Available at v2026.06.12.1403-5c43e3d; requires a Xiaohongshu login for account operations.

Behavior changed: Run the Xiaohongshu service in a Docker container.

Seeded by @iluxav with Codex

Read the evidence

Submit posts using Xiaohongshu's updated publishing button.

Details

Image and video publishing recognize the new publish control while retaining the older selector.

Available at v2026.05.15.0445-dee6c25; requires a Xiaohongshu login for account operations.

Now works / inferred: Publish Xiaohongshu posts with a title, text, image…Now works / inferred: Publish a local video to Xiaohongshu with a title,…

Seeded by @iluxav with Codex

Read the evidence
v2026.04.17.0444-c63748f
with v2026.04.16.1657-c63748f

Publish image posts when hidden duplicate upload tabs are present.

Details

The upload-tab selector ignores hidden elements that previously prevented image publishing.

Available at v2026.04.17.0444-c63748f; requires a Xiaohongshu login for account operations.

Now works / inferred: Publish Xiaohongshu posts with a title, text, image…

Seeded by @iluxav with Codex

Read the evidence
v2026.03.09.0605-0e16f4b
with v2026.02.25.1452-8cafba9, v2026.02.25.1520-7f94dad, v2026.02.27.1514-5d22c52, v2026.02.27.1638-fcbf554, v2026.02.27.1731-97a7b1e, v2026.02.28.1611-d26b9ce, v2026.02.28.1720-8a7fe21, v2026.03.01.1500-f697ed7, v2026.03.01.1740-ed7e493, v2026.03.03.1615-fa6bc02, v2026.03.04.0225-db81fd8, v2026.03.04.0227-8158d06, v2026.03.04.0230-a6795dc, v2026.03.04.0231-db81fd8, v2026.03.08.0858-cbd592c, v2026.03.08.0905-c294829, v2026.03.08.0909-8ce415f, v2026.03.08.0919-5c8a6cc, v2026.03.08.1419-38be3ba

Attach matching products to Xiaohongshu image or video posts.

Details

Publishing accepts product keywords, visibility choices and an optional image-post originality declaration; browser traffic can use a proxy.

Available at v2026.03.09.0605-0e16f4b; requires a Xiaohongshu login for account operations.

Added: Attach products found by name or ID to an image or…Added: Choose public, self-only or mutual-follower visibil…Added / inferred: Declare an image post as original when publishing.Added: Route the automated browser's Xiaohongshu traffic t…Now works / inferred: Publish Xiaohongshu posts with a title, text, image…Added: Prepare and publish content from a URL with the bun…Added: Publish a long article with a layout template using…

Seeded by @iluxav with Codex

Read the evidence
v2026.02.18.0511-abe2afa
with v2026.02.03.1740-5c76f97, v2026.02.04.1639-12d9cb4, v2026.02.04.1707-b4c579f, v2026.02.06.1239-0220aaa, v2026.02.06.1308-dfa94e8, v2026.02.07.0352-4878524, v2026.02.07.0404-44061fd, v2026.02.10.1504-a790a97, v2026.02.13.1653-52d0205, v2026.02.13.1706-90a6b5c, v1.2.2, v2026.02.13.1721-0476ba3, v2026.02.16.0507-e7792e8, v2026.02.17.1425-3734daf

Upload multiple images without losing later images after page changes.

Details

Publishing adapts to the creator page and waits for each image upload; title counting and protected image downloads are corrected.

Available at v2026.02.18.0511-abe2afa; requires a Xiaohongshu login for account operations.

Now works / inferred: Publish Xiaohongshu posts with a title, text, image…Now works / inferred: Publish Xiaohongshu posts with a title, text, image…Added / inferred: Run the service and login tool using Linux ARM64 re…

Seeded by @iluxav with Codex

Read the evidence

Schedule a Xiaohongshu image or video post for a future time.

Details

Both publishing tools accept an optional RFC3339 timestamp in `schedule_at`; omitting it keeps immediate publishing.

Available at v2026.01.17.0408-e467f84; requires a Xiaohongshu login for account operations.

Added: Schedule an image or video post to publish later.

Seeded by @iluxav with Codex

Read the evidence
v2026.01.05.1503-3cdfe46
with v2025.12.03.1615-6bef535, v2025.12.07.0704-13ac2e3, v2025.12.07.0856-9f1eeed, v2025.12.07.1002-a375a74, v2025.12.08.1810-d4b1830, v2025.12.09.1544-486cfa0, v2025.12.10.1522-e2af06e, v2025.12.14.1639-7af8557, v2025.12.16.1619-8916dac, v2025.12.18.1527-a7b7786, v2025.12.19.1700-e87401e, v2025.12.26.1451-d843178, v2025.12.26.1508-ed6d9c6, v2025.12.26.1526-61eccf1, v2026.01.01.1247-e5303ba, v2026.01.01.1305-e79e78c, v2026.01.02.0602-302426c

Reply to a specific comment on a Xiaohongshu post.

Details

Replies can target a comment or user ID, and detail requests can scroll to load more comments. Image publishing checks the page's title and body length errors.

Available at v2026.01.05.1503-3cdfe46; requires a Xiaohongshu login for account operations.

Added: Reply to a specific comment on a Xiaohongshu post.Improved / inferred: Read a post's content, images, author, interaction…Action required / inferred: Publish Xiaohongshu posts with a title, text, image…Now works / inferred: Run the Xiaohongshu service in a Docker container.

Seeded by @iluxav with Codex

Read the evidence

Keep mixed local and remote images in the requested publishing order.

Details

Image processing preserves the input order when a post combines file paths and downloaded images.

Available at v2025.11.16.1557-2f8aa1d; requires a Xiaohongshu login for account operations.

Now works / inferred: Publish Xiaohongshu posts with a title, text, image…

Seeded by @iluxav with Codex

Read the evidence
v2025.11.05.1527-1947170
with v2025.10.23.1552-94ed5d4, v2025.10.26.1336-adbfc43, v2025.11.02.1102-11a937b

Reset a Xiaohongshu login by deleting its saved cookies.

Details

The service adds login reset and ARM64 Docker support; search callers must use the revised filter object.

Available at v2025.11.05.1527-1947170; requires a Xiaohongshu login for account operations.

Improved / inferred: Log in with a QR code and check the saved login sta…Added / inferred: Run the Xiaohongshu service in an ARM64 Docker cont…Action required / inferred: Search Xiaohongshu posts by keyword.

Seeded by @iluxav with Codex

Read the evidence
v2025.10.16.1532-b326d8c
with v2025.10.16.1315-d5138d3, v2025.10.16.1317-844ff8c, v2025.10.16.1501-df623ca, v2025.10.16.1510-d11cb1c

Narrow Xiaohongshu searches by post type, date, popularity and location.

Details

Search gains filters and a POST endpoint; the HTTP API can also return the logged-in user's profile.

Available at v2025.10.16.1532-b326d8c; requires a Xiaohongshu login for account operations.

Improved / inferred: Search Xiaohongshu posts by keyword.Improved / inferred: Read a Xiaohongshu user's profile, statistics and p…

Seeded by @iluxav with Codex

Read the evidence
v2025.10.08.0341-66aa36b
Starting point

Publish image posts to Xiaohongshu from an MCP client.

Details

This baseline records the publishing, search, reading and account interactions already present before the history window.

Tagged source and binaries; Go 1.24 for source builds. Login is required, and first use downloads a browser.

Added: Publish Xiaohongshu posts with a title, text, image…Added: Publish a local video to Xiaohongshu with a title,…Added: Search Xiaohongshu posts by keyword.Added: Read posts recommended on the Xiaohongshu homepage.Added: Read a post's content, images, author, interaction…Added: Read a Xiaohongshu user's profile, statistics and p…Added: Post a comment on a Xiaohongshu note.Added: Like or unlike a Xiaohongshu post.Added: Favorite or unfavorite a Xiaohongshu post.Added: Log in with a QR code and check the saved login sta…Added: Call Xiaohongshu operations from MCP clients or the…Added: Run the Xiaohongshu service and login tool on an In…Added: Run the Xiaohongshu service in a Docker container.

Seeded by @iluxav with Codex

Read the evidence

Share

LinkedIn takes the link and its card only; write your text there.

X LinkedIn Reddit Hacker News Bluesky