setup-xhs-mcp
This skill walks you through installing and configuring the xiaohongshu-mcp service, from initial deployment to verifying MCP connectivity. It supports Docker Compose (recommended), binary downloads, and source compilation, with built-in guidance for macOS, Linux, and Windows. After setup, it helps you register the MCP endpoint with Claude Code, Cursor, or other compatible clients.
setup-xhs-mcp guides you through deploying and configuring the xiaohongshu-mcp service end-to-end.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-03-05
setup-xhs-mcp guides you through deploying and configuring the xiaohongshu-mcp service end-to-end. This skill walks you through installing and configuring the xiaohongshu-mcp service, from initial deployment to verifying MCP connectivity. It supports Docker Compose (recommended), binary downloads, and source compilation, with built-in guidance for macOS, Linux, and Windows. After setup, it helps you register the MCP endpoint with Claude Code, Cursor, or other compatible clients.
Use it when
- setup-xhs-mcp provides troubleshooting steps for MCP connection issues.
- setup-xhs-mcp guides you through Claude Code integration.
Verify before relying
Read SKILL.md below before installing (1 file). Open directory: indexed for reading, not audited.
Install
autoclaw-cc/xiaohongshu-mcp-skills/setup-xhs-mcp
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I install xiaohongshu mcp?
setup-xhs-mcp offers three installation paths. For Docker Compose (recommended), clone the repository and run `docker compose up`. For binary installation, download the prebuilt executable for your OS from the releases page. For source compilation, clone the repo and run `cargo build --release`. All methods set up the MCP server on localhost:18060 by default. Choose Docker Compose for easiest setup across macOS, Linux, and Windows.
What should I do if xiaohongshu mcp connection fails?
setup-xhs-mcp provides troubleshooting steps for MCP connection issues. First, verify the server is running on localhost:18060 with `curl http://localhost:18060/health`. Check that your firewall allows port 18060. If using Docker, ensure the container is active via `docker ps`. Confirm your client (Claude Code, Cursor) has the correct endpoint URL configured. Review server logs for authentication or network errors, then restart the service and retry.
How do I configure mcp connection xiaohongshu with Claude Code?
setup-xhs-mcp guides you through Claude Code integration. In Claude Code settings, add a new MCP server with endpoint `http://localhost:18060`. Provide your xiaohongshu credentials when prompted. Test the connection by invoking a tool like `check_login_status`. If tools remain unavailable, verify the server is running and credentials are correct. Cursor setup follows the same pattern—add the endpoint and authenticate through the MCP configuration panel.
Why are xiaohongshu mcp tools not available after setup?
setup-xhs-mcp helps resolve tool availability issues by checking several factors. Confirm the MCP server process is running and listening on port 18060. Verify your xiaohongshu account credentials are valid and stored correctly in the service configuration. Restart both the MCP server and your client application. Check server logs for authentication failures or permission errors. If `check_login_status` fails, re-authenticate your xiaohongshu account through the setup wizard.
What are the setup xhs-mcp service deployment options?
setup-xhs-mcp supports three deployment methods tailored to your environment. Docker Compose is recommended for reproducible, isolated setups on any OS. Binary installation works for quick standalone deployments without container overhead. Source compilation gives you full control and is ideal for development. All three methods configure the same MCP server on localhost:18060. Docker Compose handles dependencies automatically; binary and source methods require manual environment setup for macOS, Linux, or Windows.
How do I resolve Docker image pull or port conflicts?
setup-xhs-mcp addresses Docker deployment issues. If image pull fails, check your internet connection and Docker daemon status. For port 18060 conflicts, either stop the process using that port or modify the Docker Compose `ports` mapping to a free port, then update your client configuration. Ensure Docker has sufficient disk space and memory. Run `docker compose logs` to see detailed error messages. If problems persist, rebuild the image locally with `docker compose build --no-cache`.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
项目仓库：https://github.com/xpzouying/xiaohongshu-mcp
执行流程
1. 检测服务状态
检查 xiaohongshu-mcp 是否已在运行（注意：MCP 端点只接受 POST，GET 会返回 405，不能用 -f 判断）：
curl -so /dev/null http://localhost:18060/mcp && echo "running" || echo "not running"
- 已运行 → 记录地址
http://localhost:18060/mcp，跳到步骤 3 - 未运行 → 询问用户：服务是否部署在其他地址/端口？
- 用户提供地址 → 验证可达后跳到步骤 3
- 未部署 → 进入步骤 2
2. 部署服务
确认操作系统（macOS / Linux / Windows）和是否已安装 Docker。
方式一：Docker Compose（推荐）
Docker 镜像内置 Chrome 和中文字体，无需额外配置。
# 下载 docker-compose.yml
wget https://raw.githubusercontent.com/xpzouying/xiaohongshu-mcp/main/docker/docker-compose.yml
# 启动服务
docker compose up -d
# 查看日志
docker compose logs -f
镜像源：
- Docker Hub（默认）：xpzouying/xiaohongshu-mcp
- 阿里云（国内推荐）：crpi-hocnvtkomt7w9v8t.cn-beijing.personal.cr.aliyuncs.com/xpzouying/xiaohongshu-mcp
切换方法：编辑 docker-compose.yml，注释默认 image 行，取消注释阿里云 image 行。
数据持久化：
- ./data — cookies 登录状态
- ./images — 发布图片时的挂载目录
方式二：下载二进制
从 GitHub Releases
(truncated - see the full file via the links below)
File tree — 1 file
skills/setup-xhs-mcp/SKILL.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Deploy and configure xiaohongshu-mcp service from scratch”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
xhs-login handles Xiaohongshu account access by checking login status, generating QR codes for mobile app authentication, and resetting sessions to switch accounts. The skill guides users through each step and handles timeouts by regenerating codes when needed.
This skill provides full automation for Xiaohongshu through the MCP protocol, enabling login management, content search, publishing with image support, and interaction features like commenting and liking. It includes 13 MCP tools, HTTP API access, Python client scripts, and built-in cover generation for streamlined content creation and engagement workflows.
Openclaw Xhs wraps xiaohongshu-mcp to enable searching posts, viewing recommendations, fetching details with comments, and publishing content to Xiaohongshu. It supports topic tracking with automated reporting, exporting posts as long images, and managing likes and favorites through shell scripts and MCP tools.
xhs-profile fetches a Xiaohongshu user's profile page, including basic details, follower and engagement metrics, and their recent published posts. Use it to explore any creator's account information and content history.
xhs-search enables keyword-based discovery across Xiaohongshu's note library with flexible filtering by sort order, content format, publish date, and geographic scope. Results display engagement metrics and author details, with direct access to note exploration and interaction features.
xhs-explore lets you browse Xiaohongshu's recommendation feed and access individual note details with full comment threads. Retrieve recommended notes from your home feed, then drill into specific posts to see content, images, author info, and engagement metrics.
More skills xhs-interact (MIT) · post-to-xhs (MIT) · xhs-content-plan (MIT)