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.
Update scripts reading saved sessions to accept the v2 object containing `cookies`. Old arrays load automatically; after downgrading, scan the login QR code again.
Action requiredInferredAffects: External cookie-file readers and users downgrading to a pre-v2 release.
Replace the `filters` array of `filters_index`/`tags_index` pairs with an object using `sort_by`, `note_type`, `publish_time`, `search_scope` and `location`.
Action requiredInferredAffects: MCP and HTTP callers using the previous search filter array.
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…
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…
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…
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.
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…
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…
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.
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.
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.