# xiaohongshu-mcp | zy | Knowledge Base | Instagit

MCP for xiaohongshu.com

GitHub Stars: 10.9k

Repository: https://github.com/xpzouying/xiaohongshu-mcp

---

## Articles

### [Does xiaohongshu-mcp Support Video Uploads? A Complete Technical Guide](/xpzouying/xiaohongshu-mcp/does-xiaohongshu-mcp-support-video-uploads)

Discover if xiaohongshu-mcp supports video uploads. This guide details the process using the /api/publish_video endpoint and MCP tool for seamless Xiaohongshu integration.

- Tags: how-to-guide
- Published: 2026-03-09

### [How to Enable Non-Headless Mode for Debugging in xiaohongshu-mcp](/xpzouying/xiaohongshu-mcp/how-to-enable-non-headless-mode-for-debugging-in-xiaohongshu-mcp)

Debug xiaohongshu-mcp interactively by enabling non-headless mode. Launch with the -headless=false flag to see the Chrome browser window for easier troubleshooting.

- Tags: how-to-guide
- Published: 2026-03-09

### [How to Debug MCP Connection Issues in Docker: A Complete Guide for Xiaohongshu-MCP](/xpzouying/xiaohongshu-mcp/how-to-debug-mcp-connection-issues-especially-in-docker)

Troubleshoot MCP connection issues in Docker. Resolve problems with health endpoints, ROD_BROWSER_BIN, COOKIES_PATH volumes, and port mappings for a stable MCP setup.

- Tags: how-to-guide
- Published: 2026-03-09

### [Troubleshooting Publishing Issues in xiaohongshu-mcp: A Complete Guide](/xpzouying/xiaohongshu-mcp/what-are-common-troubleshooting-steps-for-publishing-issues-in-xiaohongshu-mcp)

Resolve xiaohongshu-mcp publishing issues by troubleshooting DOM blocking, tab switching, and upload timeouts. Learn essential debugging steps to fix failures in this comprehensive guide.

- Tags: how-to-guide
- Published: 2026-03-09

### [How to Configure xiaohongshu-mcp for Cursor or VSCode: Complete Setup Guide](/xpzouying/xiaohongshu-mcp/how-to-configure-xiaohongshu-mcp-for-cursor-or-vscode)

Easily configure xiaohongshu-mcp for Cursor or VSCode. Follow our guide to set up the JSON file and reload your editor for seamless integration.

- Tags: how-to-guide
- Published: 2026-03-09

### [How to Deploy xiaohongshu-mcp Using Docker Compose: Complete Setup Guide](/xpzouying/xiaohongshu-mcp/how-to-deploy-xiaohongshu-mcp-using-docker-compose)

Deploy xiaohongshu-mcp using Docker Compose with a complete setup guide. Follow instructions to pull the image, mount volumes, and expose the port for a seamless deployment.

- Tags: how-to-guide
- Published: 2026-03-09

### [Configuring xiaohongshu-mcp: Complete Guide to Environment Variables](/xpzouying/xiaohongshu-mcp/what-environment-variables-can-be-used-to-configure-xiaohongshu-mcp)

Learn how to configure xiaohongshu-mcp using ROD_BROWSER_BIN, COOKIES_PATH, and XHS_PROXY environment variables. Customize Chrome path, cookies, and proxy settings easily.

- Tags: how-to-guide
- Published: 2026-03-09

### [How to Start the xiaohongshu-mcp Server with Command-Line Arguments](/xpzouying/xiaohongshu-mcp/how-to-start-the-xiaohongshu-mcp-server-with-command-line-arguments)

Start the xiaohongshu-mcp server using command-line arguments. Control browser visibility headless mode executable path and HTTP port for flexible setup.

- Tags: how-to-guide
- Published: 2026-03-09

### [What Is the Default Service Address for the MCP Endpoint in Xiaohongshu MCP?](/xpzouying/xiaohongshu-mcp/what-is-the-default-service-address-for-the-mcp-endpoint)

Discover the default MCP endpoint service address for Xiaohongshu MCP in the xpzouying/xiaohongshu-mcp repository. Learn about its port and path.

- Tags: faq
- Published: 2026-03-09

### [How the MCP Endpoint is Configured Using Gin and the MCP SDK](/xpzouying/xiaohongshu-mcp/how-is-the-mcp-endpoint-configured-using-gin-and-the-mcp-sdk)

Learn to configure your MCP endpoint with Gin and the MCP SDK. Wrap the MCP SDK handler with Gin WrapH, register the route, and initialize the *mcp.Server for seamless integration.

- Tags: how-to-guide
- Published: 2026-03-09

### [xiaohongshu-mcp HTTP API Endpoints: Complete REST Reference](/xpzouying/xiaohongshu-mcp/what-are-the-available-http-api-endpoints-for-xiaohongshu-mcp)

Explore over 20 comprehensive xiaohongshu-mcp HTTP API endpoints. Access our complete REST reference for health monitoring, content publishing, feed operations, and social interactions.

- Tags: api-reference
- Published: 2026-03-09

### [How Images Are Uploaded Programmatically in xiaohongshu-mcp: A Complete Technical Guide](/xpzouying/xiaohongshu-mcp/how-are-images-uploaded-programmatically-in-xiaohongshu-mcp)

Learn how images are uploaded programmatically in xiaohongshu-mcp using the Rod headless browser. This guide details direct DOM file input injection and upload completion monitoring.

- Tags: how-to-guide
- Published: 2026-03-09

### [How to Publish Content with xiaohongshu-mcp: A Complete Technical Guide](/xpzouying/xiaohongshu-mcp/what-are-the-detailed-steps-for-publishing-content-with-xiaohongshu-mcp)

Publish content with xiaohongshu-mcp by validating API requests, processing media, automating browser interaction with go-rod, and submitting posts via image-text or video workflows. Get the complete technical guide.

- Tags: how-to-guide
- Published: 2026-03-09

### [How User Login Status Is Managed and Checked in Xiaohongshu-MCP](/xpzouying/xiaohongshu-mcp/how-is-user-login-status-managed-and-checked-in-xiaohongshu-mcp)

Learn how Xiaohongshu-MCP manages user login status by checking DOM elements and using persistent session cookies for automatic re-authentication. Explore the technical details.

- Tags: internals
- Published: 2026-03-09

### [How go-rod Facilitates Browser Automation in xiaohongshu-mcp](/xpzouying/xiaohongshu-mcp/how-does-the-go-rod-library-facilitate-browser-automation-in-xiaohongshu-mcp)

Learn how go-rod powers browser automation in xiaohongshu-mcp. This Go library simplifies page navigation, DOM manipulation, and JavaScript execution for the Xiaohongshu creator platform.

- Tags: how-to-guide
- Published: 2026-03-09

### [MCP Tool Arguments Data Types and Schemas in the Xiaohongshu MCP Server](/xpzouying/xiaohongshu-mcp/what-are-the-data-types-and-schemas-for-mcp-tool-arguments)

Understand MCP tool arguments schemas and data types in the Xiaohongshu MCP server. Learn how Go structs and jsontags ensure automatic JSON validation and type conversion.

- Tags: api-reference
- Published: 2026-03-09

### [How to Specify Parameters for MCP Tools like `publish_content` in xiaohongshu-mcp](/xpzouying/xiaohongshu-mcp/how-to-specify-parameters-for-mcp-tools-like-publish-content)

Learn how to specify parameters for MCP tools like publish_content in xiaohongshu-mcp. Understand mandatory requirements for title, content, and images, plus optional scheduling and visibility settings.

- Tags: how-to-guide
- Published: 2026-03-09

### [Available MCP Tools in xiaohongshu-mcp: Complete 13-Function Reference and Usage Guide](/xpzouying/xiaohongshu-mcp/what-are-the-available-mcp-tools-in-xiaohongshu-mcp-and-their-functions)

Explore 13 MCP tools in xiaohongshu-mcp for automated XiaoHongShu (RED) platform tasks including content publishing and social interactions. Get a full reference and usage guide.

- Tags: api-reference
- Published: 2026-03-09

### [Directory Structure of xiaohongshu-mcp: Complete Guide to the Go-Based MCP Server](/xpzouying/xiaohongshu-mcp/what-is-the-directory-structure-of-xiaohongshu-mcp)

Explore the xiaohongshu-mcp directory structure. Understand the Go SDK, browser automation, API server, and deployment assets in this comprehensive guide. Optimize your MCP server setup.

- Tags: tutorial
- Published: 2026-03-09

### [Understanding the xiaohongshu-mcp System Architecture: A Technical Deep Dive](/xpzouying/xiaohongshu-mcp/how-does-the-xiaohongshu-mcp-system-architecture-work)

Explore the xiaohongshu-mcp system architecture. This Go microservice uses headless Chrome automation to bridge HTTP and MCP requests, detailing its four-layer pipeline from CLI to web UI.

- Tags: deep-dive
- Published: 2026-03-09

### [Core Technologies Used in xiaohongshu-mcp: Go, MCP SDK, and Browser Automation](/xpzouying/xiaohongshu-mcp/what-are-the-core-technologies-used-in-xiaohongshu-mcp)

Explore the core technologies behind xiaohongshu-mcp, including Go, the MCP SDK, and go-rod browser automation. Discover how they power Xiaohongshu platform operations.

- Tags: deep-dive
- Published: 2026-03-09

### [How to Set Up the xiaohongshu-mcp Server: Complete Installation Guide](/xpzouying/xiaohongshu-mcp/how-to-set-up-xiaohongshu-mcp-server)

Learn how to set up the xiaohongshu-mcp server with this complete installation guide. Deploy this Go-based HTTP service easily via binaries, Docker, or source for automating Xiaohongshu.

- Tags: how-to-guide
- Published: 2026-03-09