小红书 MCP

개요

Xiaohongshu MCP (저장소: xpzouying/xiaohongshu-mcp)는 Xiaohongshu(小红书, RedNote 또는 XHS로도 알려짐)에 특화된 인기 오픈소스 Model Context Protocol (MCP) 서버입니다. 이 서버는 안정적인 브라우저 자동화(Playwright)를 통해 AI 어시스턴트에게 플랫폼 상호작용을 자동화하는 강력한 도구를 제공합니다.

이 서버는 지속적인 로그인 세션 관리, 콘텐츠 생성 및 발행, 데이터 조회, 다양한 운영 작업을 지원하여 중국 소셜 이커머스 및 라이프스타일 콘텐츠 플랫폼을 위한 가장 포괄적인 MCP 서버 중 하나입니다.

주요 기능

.

• 안전한 로그인 관리: 지속적인 세션 저장 기능이 있는 일회성 QR 코드 로그인(빈번한 재로그인 회피).
• 콘텐츠 발행: 이미지 + 텍스트 노트(图文笔记) 발행, 일부 구성에서는 비디오 지원.
• 검색 및 발견: 키워드로 노트 검색, 맞춤형 추천 피드(홈 피드) 가져오기.

1. 상호작용 도구: 노트 보기, 댓글 작성, 알림 모니터링.

• 데이터 조회: 노트 상세 정보, 사용자 정보 등 추출.
• 브라우저 자동화: 안정성 및 IP 위험 회피를 위해 Chrome/Edge에서 로컬 실행. .
• 다중 플랫폼 지원: Windows, macOS, Linux용 사전 빌드된 바이너리; Docker 이미지로도 이용 가능.
• MCP 네이티브: Claude Desktop, Cursor, Gemini CLI, Cherry Studio, OpenClaw 및 기타 MCP 클라이언트와 완벽 호환.

작동 방식

1. 저장소 릴리스에서 바이너리 또는 Docker 이미지를 다운로드합니다.
2. QR 코드를 통해 인증하고 세션을 저장하기 위해 로그인 스크립트를 한 번 실행합니다.
3. MCP 서버를 시작합니다(기본 포트는 일반적으로 18060 또는 구성 가능).
4. 서버 URL(예: http://localhost:18060/mcp)을 MCP 클라이언트 구성에 추가합니다.
5. AI 에이전트는 이제 자연어를 사용해 "이 이미지와 캡션으로 새 노트를 발행하라" 또는 "인기 있는 뷰티 노트를 검색하라"와 같은 도구를 호출할 수 있습니다.

서버는 MCP 도구 호출을 Xiaohongshu.com의 브라우저 동작으로 변환합니다.

사용 사례

• AI 기반 콘텐츠 생성: Xiaohongshu에서 노트, 캡션 및 시각 자료 생성 및 자동 발행.
• 자동화된 소셜 운영: 수작업 없이 일일 게시, 댓글 작성 및 참여. .
• 콘텐츠 리서치: 트렌딩 토픽, 경쟁사 노트 또는 사용자 피드백 검색 및 분석.
• 크리에이터 워크플로우: 라이프스타일, 패션, 뷰티 또는 이커머스 콘텐츠 예약 또는 일괄 발행.
• 다중 에이전트 시스템: 전체 콘텐츠 파이프라인(리서치 → 작성 → 발행)을 위해 다른 MCP 서버와 결합.

시작하기

빠른 시작 (바이너리)

• GitHub 릴리스에서 사용 중인 OS용 최신 릴리스를 다운로드합니다. .
• 세션을 저장하기 위해 로그인 명령을 실행합니다.
• MCP 서버를 시작합니다.

Docker

docker run -p 18060:18060 xpzouying/xiaohongshu-mcp

MCP 클라이언트에서 구성하기 (Claude/Cursor 예시):

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

자세한 가이드와 문제 해결 방법은 저장소 README와 작성자의 블로그(haha.ai/xiaohongshu-mcp)에서 확인할 수 있습니다.

장점

Xiaohongshu MCP는 안정성, 사용 편의성, 그리고 실제 브라우저 시뮬레이션에 초점을 둔 점으로 차별화되어 많은 봇 방지 조치를 우회하는 데 도움을 줍니다. 이를 통해 AI 코딩 어시스턴트를 효과적인 Xiaohongshu 콘텐츠 운영자로 변환하여, 워크플로우 자동화를 원하는 크리에이터와 마케터를 지원하면서도 작업을 로컬에서 안전하게 유지할 수 있습니다.

참고: 자동화 작업 시 항상 Xiaohongshu의 서비스 약관과 플랫폼 규칙을 존중하세요. 개인 계정이나 승인된 계정에 대해 책임감 있게 사용하십시오.

현재 이는 Xiaohongshu 자동화를 위한 가장 활발하게 유지 관리되고 널리 사용되는 MCP 서버 중 하나입니다.