Agent skill

Setup Xhs MCP

by autoclaw-cc in autoclaw-cc/xiaohongshu-mcp-skills

安装部署 xiaohongshu-mcp 服务并配置 MCP 连接，引导用户完成从零到可用的全流程. An agent skill from autoclaw-cc/xiaohongshu-mcp-skills.

Install Setup Xhs MCP

skills CLI

$ npx skills add autoclaw-cc/xiaohongshu-mcp-skills --skill setup-xhs-mcp -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install autoclaw-cc/xiaohongshu-mcp-skills setup-xhs-mcp --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/autoclaw-cc/xiaohongshu-mcp-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/setup-xhs-mcp .claude/skills/setup-xhs-mcp && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "setup-xhs-mcp" agent skill from https://github.com/autoclaw-cc/xiaohongshu-mcp-skills/tree/main/skills/setup-xhs-mcp into .claude/skills/setup-xhs-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "setup-xhs-mcp", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/autoclaw-cc/xiaohongshu-mcp-skills/tree/main/skills/setup-xhs-mcp

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add autoclaw-cc/xiaohongshu-mcp-skills --skill setup-xhs-mcp -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install autoclaw-cc/xiaohongshu-mcp-skills setup-xhs-mcp --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/autoclaw-cc/xiaohongshu-mcp-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/setup-xhs-mcp .agents/skills/setup-xhs-mcp && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "setup-xhs-mcp" agent skill from https://github.com/autoclaw-cc/xiaohongshu-mcp-skills/tree/main/skills/setup-xhs-mcp into .agents/skills/setup-xhs-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "setup-xhs-mcp", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add autoclaw-cc/xiaohongshu-mcp-skills --skill setup-xhs-mcp -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install autoclaw-cc/xiaohongshu-mcp-skills setup-xhs-mcp --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/autoclaw-cc/xiaohongshu-mcp-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/setup-xhs-mcp .cursor/skills/setup-xhs-mcp && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "setup-xhs-mcp" agent skill from https://github.com/autoclaw-cc/xiaohongshu-mcp-skills/tree/main/skills/setup-xhs-mcp into .cursor/skills/setup-xhs-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "setup-xhs-mcp", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/autoclaw-cc/xiaohongshu-mcp-skills.git --path skills/setup-xhs-mcp

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add autoclaw-cc/xiaohongshu-mcp-skills --skill setup-xhs-mcp -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install autoclaw-cc/xiaohongshu-mcp-skills setup-xhs-mcp --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/autoclaw-cc/xiaohongshu-mcp-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/setup-xhs-mcp .gemini/skills/setup-xhs-mcp && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "setup-xhs-mcp" agent skill from https://github.com/autoclaw-cc/xiaohongshu-mcp-skills/tree/main/skills/setup-xhs-mcp into .gemini/skills/setup-xhs-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "setup-xhs-mcp", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install autoclaw-cc/xiaohongshu-mcp-skills setup-xhs-mcp

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add autoclaw-cc/xiaohongshu-mcp-skills --skill setup-xhs-mcp -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/autoclaw-cc/xiaohongshu-mcp-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/setup-xhs-mcp .github/skills/setup-xhs-mcp && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "setup-xhs-mcp" agent skill from https://github.com/autoclaw-cc/xiaohongshu-mcp-skills/tree/main/skills/setup-xhs-mcp into .github/skills/setup-xhs-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "setup-xhs-mcp", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add autoclaw-cc/xiaohongshu-mcp-skills --skill setup-xhs-mcp -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install autoclaw-cc/xiaohongshu-mcp-skills setup-xhs-mcp --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/autoclaw-cc/xiaohongshu-mcp-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/setup-xhs-mcp .opencode/skills/setup-xhs-mcp && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "setup-xhs-mcp" agent skill from https://github.com/autoclaw-cc/xiaohongshu-mcp-skills/tree/main/skills/setup-xhs-mcp into .opencode/skills/setup-xhs-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "setup-xhs-mcp", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: setup-xhs-mcp
GitHub stars: 272
Token cost: ~678 tokens
SKILL.md length: 167 words
Files: 1
Skills in repo: 9
Repo updated: Mar 5, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

安装部署 xiaohongshu-mcp 服务并配置 MCP 连接，引导用户完成从零到可用的全流程. An agent skill from autoclaw-cc/xiaohongshu-mcp-skills.

Works in 5 steps: 检测服务状态 → 部署服务 → 检测 MCP 连接配置 → …
Tasks that involve MCP servers
SKILL.md covers 执行流程, 环境变量（可选） and 失败处理
Calls curl, docker and wget; reaches raw.githubusercontent.com and api.github.com

What it does

Setup Xhs MCP is an agent skill from autoclaw-cc/xiaohongshu-mcp-skills. 安装部署 xiaohongshu-mcp 服务并配置 MCP 连接，引导用户完成从零到可用的全流程。当用户第一次使用小红书功能、提到安装/部署/配置小红书、环境搭建、MCP 服务连接失败、或 checkloginstatus 等 MCP 工具不可用时使用。

Its SKILL.md is about 680 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering MCP servers and Containers. It works with Model Context Protocol, Xiaohongshu and Docker. The repository describes itself as: xiaohongshu-mcp skills. The licence is MIT.

When your agent uses it

Tasks that involve MCP servers
Tasks that involve Containers

Example prompts

“/setup-xhs-mcp”

Requirements

Docker

Workflow steps

5 steps, taken from the step headings in SKILL.md.

检测服务状态
部署服务
检测 MCP 连接配置
配置 MCP 连接
验证与提示

What it can do on your machine

Read from SKILL.md and the folder at commit c79206c. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- curl
- docker
- wget
- claude
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- raw.githubusercontent.com
- api.github.com
Also links to:
- github.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Setup Xhs MCP loads about 678 tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 167 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~36
When it runs · the whole SKILL.md, loaded when a task matches: ~678

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from autoclaw-cc/xiaohongshu-mcp-skills at commit c79206c, republished under its MIT licence (© autoclaw-cc). 167 words, ~678 tokens.

Download SKILL.mdSave it as .claude/skills/setup-xhs-mcp/SKILL.md (or your agent's skills folder).

name: setup-xhs-mcp
description: 安装部署 xiaohongshu-mcp 服务并配置 MCP 连接，引导用户完成从零到可用的全流程。当用户第一次使用小红书功能、提到安装/部署/配置小红书、环境搭建、MCP 服务连接失败、或 check_login_status 等 MCP 工具不可用时使用。

项目仓库：https://github.com/xpzouying/xiaohongshu-mcp

执行流程

1. 检测服务状态

检查 xiaohongshu-mcp 是否已在运行（注意：MCP 端点只接受 POST，GET 会返回 405，不能用 -f 判断）：

bash

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 和中文字体，无需额外配置。

bash

# 下载 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 下载：https://github.com/xpzouying/xiaohongshu-mcp/releases/latest

bash

curl -s https://api.github.com/repos/xpzouying/xiaohongshu-mcp/releases/latest | grep browser_download_url

注意：二进制方式需要本机已安装 Chrome 或 Chromium。

方式三：源码编译

不推荐，仅适合 Go 开发者。参考项目仓库 README。

部署完成后用 curl 确认服务已启动，然后进入步骤 3。

3. 检测 MCP 连接配置

检查当前客户端是否已配置 xiaohongshu MCP 连接。

Claude Code：读取 ~/.claude/settings.json 和项目级 .claude/settings.json，查找 mcpServers 中是否有 xiaohongshu 配置。

已配置且地址正确 → 跳到步骤 5
已配置但地址不匹配 → 修正地址
未配置 → 进入步骤 4

4. 配置 MCP 连接

询问用户：

连接地址：如果步骤 1 已确认可达的地址，用该地址作为默认值，否则默认 http://localhost:18060/mcp。

使用的客户端：

Claude Code：

bash

claude mcp add xiaohongshu --transport http <地址>

或写入配置文件：

全局：~/.claude/settings.json
项目级：.claude/settings.json

json

{
  "mcpServers": {
    "xiaohongshu": {
      "url": "http://localhost:18060/mcp"
    }
  }
}

Cursor（.cursor/mcp.json）：

json

{
  "mcpServers": {
    "xiaohongshu": {
      "url": "http://localhost:18060/mcp"
    }
  }
}

其他客户端：告知用户 MCP 服务地址，让用户按客户端文档自行配置。

5. 验证与提示

提示用户重启当前会话 — MCP 配置变更后需重启客户端才能加载新的 MCP 工具
重启后调用 check_login_status 验证连接正常
验证成功 → 引导用户使用 /xhs-login 完成扫码登录

环境变量（可选）

XHS_PROXY — HTTP/HTTPS/SOCKS5 代理地址
ROD_BROWSER_BIN — 自定义 Chromium 路径
HEADLESS — 无头模式开关

失败处理

场景	处理
Docker 未安装	建议安装 Docker 或改用二进制方式
国内拉取镜像慢	切换到阿里云镜像源
端口 18060 被占用	检查已有进程，或更换端口
Chrome 未安装（二进制方式）	引导安装 Chrome 或改用 Docker 方式
配置写入后工具仍不可用	提示重启客户端会话
已有配置但地址错误	修正地址并重启

Files

Just SKILL.md in skills/setup-xhs-mcp of autoclaw-cc/xiaohongshu-mcp-skills.

Open the folder on GitHubat commit c79206c

Compare with similar skills

Setup Xhs MCP next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Setup Xhs MCP compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Setup Xhs MCP this skillautoclaw-cc/xiaohongshu-mcp-skills	272	—	~678	Automated safety check: Pass	MIT	7 mo ago
Project Releaseswimmwatch/cloakbrowser-mcp	164	—	~1.9k	Automated safety check: Pass	MIT	2 days ago
Devcontainer Devstacklok/toolhive-studio	171	—	~3.8k	Automated safety check: Notes	Apache-2.0	today
MCP Atlassiansundial-org/awesome-openclaw-skills	663	—	~433	Automated safety check: Pass	None	7 mo ago
Unraiddinglebear-ai/unraid	135	—	~5.4k	Automated safety check: Notes	MIT	6 days ago
Devsydevsy-org/devsy	112	—	~1.7k	Automated safety check: Pass	MPL-2.0	today

Similar skills

Project Release
swimmwatch/cloakbrowser-mcp
Prepare, publish, verify, or recover a cloakbrowser-mcp release only when the user explicitly requests release work.
164 GitHub stars~1.9k tokensUpdated 2 days ago
Agent WorkflowsAuto-check passed
Devcontainer Dev
stacklok/toolhive-studio
Spin up and interact with ToolHive Studio's containerized dev environment (Xvfb + noVNC + DinD).
171 GitHub stars~3.8k tokensUpdated today
Agent WorkflowsAuto-check: notes
MCP Atlassian
sundial-org/awesome-openclaw-skills
Run the Model Context Protocol (MCP) Atlassian server in Docker, enabling integration with Jira, Confluence, and other Atlassian products.
663 GitHub stars~433 tokensUpdated 7 mo ago
Agent WorkflowsAuto-check passed
Unraid
dinglebear-ai/unraid
This skill should be used when the user mentions Unraid, asks to check server health, monitor array or disk status, list or restart Docker containers, start or stop VMs, read system logs, check…
135 GitHub stars~5.4k tokensUpdated 6 days ago
DevOps & CloudAuto-check: notes
Devsy
devsy-org/devsy
Operate Devsy workspaces and providers for end users. An agent skill from devsy-org/devsy.
112 GitHub stars~1.7k tokensUpdated today
DevOps & CloudAuto-check passed
Pluggedin Stack Ops
VeriTeknik/pluggedin-app
A skill your agent uses when deploying, restarting, verifying or rolling back the containerised plugged.in production stack, when the site returns 404 or 5xx after a deploy or git operation, or when…
103 GitHub stars~1.3k tokensUpdated 4 days ago
DevOps & CloudAuto-check: notes

Questions about Setup Xhs MCP

What does Setup Xhs MCP do?

安装部署 xiaohongshu-mcp 服务并配置 MCP 连接，引导用户完成从零到可用的全流程. An agent skill from autoclaw-cc/xiaohongshu-mcp-skills. Setup Xhs MCP is an agent skill from autoclaw-cc/xiaohongshu-mcp-skills.

When should I use Setup Xhs MCP?

Setup Xhs MCP fits situations like: tasks that involve MCP servers; tasks that involve Containers.

How do I install Setup Xhs MCP in Claude Code?

Run `npx skills add autoclaw-cc/xiaohongshu-mcp-skills --skill setup-xhs-mcp -a claude-code`. Or copy the skill folder (skills/setup-xhs-mcp in autoclaw-cc/xiaohongshu-mcp-skills) into .claude/skills/setup-xhs-mcp in your project. Claude Code loads it when a task matches its description.

How do I install Setup Xhs MCP in Codex?

Run `npx skills add autoclaw-cc/xiaohongshu-mcp-skills --skill setup-xhs-mcp -a codex`. Or copy the skill folder (skills/setup-xhs-mcp in autoclaw-cc/xiaohongshu-mcp-skills) into .agents/skills/setup-xhs-mcp in your project. Codex loads it when a task matches its description.

Can I use Setup Xhs MCP in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add autoclaw-cc/xiaohongshu-mcp-skills --skill setup-xhs-mcp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/setup-xhs-mcp, .gemini/skills/setup-xhs-mcp, .github/skills/setup-xhs-mcp and .opencode/skills/setup-xhs-mcp in your project.

What does Setup Xhs MCP need to run?

Going by SKILL.md and its folder, Setup Xhs MCP needs the command-line tools its instructions call (curl, docker, wget and claude). Our summary lists: Docker.

Does Setup Xhs MCP access the network?

SKILL.md names 3 domains. In commands or code: raw.githubusercontent.com and api.github.com; the agent is likely to contact these when it follows the instructions. As links in the text: github.com. This is read from the text; nothing was executed.

Is Setup Xhs MCP safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Setup Xhs MCP use?

Setup Xhs MCP is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Setup Xhs MCP use?

About 678 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Setup Xhs MCP?

Skills that share tags, products or a category with Setup Xhs MCP: Project Release (swimmwatch/cloakbrowser-mcp, 164 stars), Devcontainer Dev (stacklok/toolhive-studio, 171 stars), MCP Atlassian (sundial-org/awesome-openclaw-skills, 663 stars) and Unraid (dinglebear-ai/unraid, 135 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Setup Xhs MCP?

autoclaw-cc (a GitHub organization) maintains it in autoclaw-cc/xiaohongshu-mcp-skills, which has 272 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on March 5, 2026.

Source: autoclaw-cc/xiaohongshu-mcp-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Setup Xhs MCP

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

执行流程

1. 检测服务状态

2. 部署服务

方式一：Docker Compose（推荐）

方式二：下载二进制

方式三：源码编译

3. 检测 MCP 连接配置

4. 配置 MCP 连接

5. 验证与提示

环境变量（可选）

失败处理

Files

Compare with similar skills

Similar skills

More from autoclaw-cc/xiaohongshu-mcp-skills

Related

Questions about Setup Xhs MCP