xiaohongshu-mcp MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

13 MCP tools for complete Xiaohongshu interaction
Content publishing: image-text posts and video posts with hashtags
Feed browsing, search with filters, and detailed post views with comments
Engagement: like, comment, reply, and favorite posts
QR code authentication with cookie-based session management

라이브 데모

실제 사용 모습

xiaohongshu-mcp.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "xiaohongshu-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/xpzouying/xiaohongshu-mcp"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "xiaohongshu-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/xpzouying/xiaohongshu-mcp"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "xiaohongshu-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/xpzouying/xiaohongshu-mcp"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "xiaohongshu-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/xpzouying/xiaohongshu-mcp"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "xiaohongshu-mcp",
      "command": "TODO",
      "args": [
        "See README: https://github.com/xpzouying/xiaohongshu-mcp"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "xiaohongshu-mcp": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/xpzouying/xiaohongshu-mcp"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add xiaohongshu-mcp -- TODO 'See README: https://github.com/xpzouying/xiaohongshu-mcp'

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: xiaohongshu-mcp

How to publish content to Xiaohongshu with AI assistance

👤 Content creators and brands publishing on Xiaohongshu ⏱ ~10 min beginner

언제 쓸까: You want to publish posts to Xiaohongshu without using the mobile app.

사전 조건

xiaohongshu-mcp running — Download binary from releases or docker run
Xiaohongshu account authenticated — Use get_login_qrcode to scan and authenticate

흐름

Authenticate

Log into Xiaohongshu. Generate a QR code for me to scan.✓ 복사됨

→ QR code displayed for mobile scanning
Publish a post

Publish a post about my coffee shop visit with these 3 photos. Title: '隐藏在街角的宝藏咖啡店'. Add hashtags #咖啡 #探店.✓ 복사됨

→ Post published confirmation with link

결과: Content published to Xiaohongshu with images and hashtags.

함정

Content moderation may reject posts — Xiaohongshu has strict content policies. Avoid promotional language and follow community guidelines.

함께 쓰기: filesystem

Research trending topics and competitors on Xiaohongshu

👤 Marketers and brand managers monitoring the platform ⏱ ~20 min beginner

언제 쓸까: You want to understand what's trending and how competitors are performing.

사전 조건

xiaohongshu-mcp authenticated — Complete QR login

흐름

Search for trends

Search Xiaohongshu for '护肤' (skincare) posts. Show the top 10 by engagement with like and comment counts.✓ 복사됨

→ Trending posts with engagement metrics
Analyze a competitor

Get the profile and recent posts for user @competitor. What content style gets them the most engagement?✓ 복사됨

→ User profile with content analysis

결과: Understanding of platform trends and competitor strategies.

함정

Session expires during long research sessions — Re-authenticate with QR code if you get login errors

함께 쓰기: filesystem

조합

다른 MCP와 조합해 10배 효율

xiaohongshu-mcp + filesystem

Batch prepare posts locally and publish them to Xiaohongshu

Read my prepared posts from ~/content/xhs/ and publish them one by one with appropriate hashtags.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
get_login_qrcode	none	Get QR code for authentication
check_login_status	none	Verify authentication status
publish_content	title: str, description: str, images: str[], hashtags?: str[]	Publish an image-text post
publish_with_video	title: str, description: str, video: str	Publish a video post
search_feeds	keyword: str, filters?	Search for content by keyword
get_feed_detail	feed_id: str	Get post details with comments
post_comment_to_feed	feed_id: str, content: str	Comment on a post
like_feed	feed_id: str	Like or unlike a post
user_profile	user_id: str	Get a user's profile information

비용 및 제한

운영 비용

API 쿼터: Subject to Xiaohongshu's internal rate limits
호출당 토큰: 200–1000 tokens per tool call
금액: Free
팁: Search before publishing to understand what performs well in your niche.

보안

권한, 시크릿, 파급범위

자격 증명 저장: Session cookies stored locally after QR authentication

데이터 외부 송신: Calls to Xiaohongshu's internal API endpoints

WARNING: This tool uses reverse-engineered Xiaohongshu APIs which may violate Xiaohongshu's Terms of Service. Use at your own risk.
Xiaohongshu may change their API at any time, breaking functionality.
Automated posting and engagement may trigger account restrictions.
Your Xiaohongshu account is used for all actions — all activity is attributed to you.

문제 해결

자주 발생하는 오류와 해결

QR code login fails

Ensure you scan the QR code with the Xiaohongshu mobile app within the timeout period. Try generating a new code.

확인: check_login_status after scanning

Session expired

Re-authenticate by generating a new QR code and scanning again.

확인: check_login_status

Post rejected by content moderation

Xiaohongshu has strict content policies. Review your content for promotional language, sensitive topics, or policy violations.

확인: Check Xiaohongshu's content guidelines

대안

xiaohongshu-mcp 다른 것과 비교

대안	언제 쓰나	단점/장점
Manual posting via Xiaohongshu app	You want guaranteed ToS compliance	Manual but no risk of account restrictions

xiaohongshu-mcp

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

설치

클라이언트 선택

사용 사례

실전 활용법: xiaohongshu-mcp

How to publish content to Xiaohongshu with AI assistance

사전 조건

흐름

함정

Research trending topics and competitors on Xiaohongshu

사전 조건

흐름

함정

조합

다른 MCP와 조합해 10배 효율

도구

이 MCP가 노출하는 것

비용 및 제한

운영 비용

보안

권한, 시크릿, 파급범위

문제 해결

자주 발생하는 오류와 해결

대안

xiaohongshu-mcp 다른 것과 비교

더 보기

리소스