xpzouying/xiaohongshu-mcp

xiaohongshu-mcp – 샤오홍슈(小红书, Xiaohongshu)를 위한 AI 기반 브리지

개요 – 자체 호스팅 서비스로, Model Context Protocol(MCP)을 구현하여 AI 어시스턴트(Claude Code, Cursor, VS Code, Open Claw 등)가 중국 소셜 플랫폼 샤오홍슈에서 읽고 쓸 수 있게 합니다. 로그인, 게시물 게시, 검색, 댓글, 좋아요, 컬렉션, 사용자 프로필 가져오기 등의 JSON-RPC 도구 세트를 노출하며, MCP 호환 클라이언트에서 호출할 수 있습니다.

핵심 기능

도구	설명
`check_login_status`	샤오홍슈 계정이 로그인되어 있는지 여부를 반환합니다.
`get_login_qrcode`	인터랙티브 로그인용 QR 코드(Base64)를 생성합니다.
`publish_content`	텍스트+이미지 게시물을 게시합니다(제목, 본문, 이미지 URL 또는 로컬 경로, 선택적 태그, 예약, 가시성, 제품 링크).
`publish_with_video`	동영상 게시물을 게시합니다(제목, 본문, 로컬 동영상 파일, 선택적 태그, 예약, 가시성).
`list_feeds`	홈페이지 추천 피드를 검색합니다.
`search_feeds`	키워드로 샤오홍슈를 검색하며 정렬, 유형, 시간 범위 필터 등을 지원합니다.
`get_feed_detail`	작성자 정보, 상호작용 수, 댓글을 포함한 전체 게시물 세부 정보를 가져옵니다.
`post_comment_to_feed` / `reply_comment_in_feed`	댓글을 추가하거나 특정 댓글에 답글을 답니다.
`like_feed` / `favorite_feed`	게시물에 좋아요/좋아요 취소 또는 컬렉션/컬렉션 취소를 합니다.
`user_profile`	사용자의 프로필과 공개 노트를 가져옵니다.

시작하기

1. 배포 방법 선택

방법	대상
사전 빌드된 바이너리 – Releases 페이지에서 적절한 `xiaohongshu-mcp` 및 `xiaohongshu-login` 실행 파일을 다운로드(macOS Apple Silicon, Windows x64, Linux x64).
Docker – 공식 이미지 `xpzouying/xiaohongshu-mcp`를 풀하여 실행(포트 18060 노출, `./data`는 쿠키용, `./images`는 업로드 미디어용 마운트).
소스에서 빌드 – Go 1.22+ 필요. `GOPROXY`를 중국 미러로 설정한 후 `go build ./cmd/mcp` 및 `go build ./cmd/login` 실행.

2. 한 번 로그인

# 로그인 도우미 실행(OS에 맞는 바이너리 선택)
./xiaohongshu-login-<platform>

헤드리스 Chromium 인스턴스가 열리고 QR 코드를 스캔하거나 자격 증명을 입력합니다. 도구는 쿠키를 data/에 저장하므로 이후 MCP 호출은 인증됩니다.

3. MCP 서버 시작

# 기본 헤드리스(UI 없음)
./xiaohongshu-mcp-<platform>
# 또는 디버깅용 브라우저 표시
./xiaohongshu-mcp-<platform> -headless=false

서비스는 http://localhost:18060/mcp에서 수신합니다.

4. (선택 사항) 엔드포인트 보안

환경 변수 AUTH_TOKEN=your-secret을 설정하거나 -token=your-secret으로 바이너리를 시작합니다. 그러면 클라이언트는 Authorization: Bearer <token>을 보내야 합니다.

AI 클라이언트 연결(Claude Code 예시)

claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp
claude mcp list   # 서버가 연결된 것으로 표시되어야 함

이제 모든 Claude 프롬프트에서 도구를 호출할 수 있습니다. 예:

帮我检查小红书登录状态

어시스턴트가 check_login_status를 호출하고 결과를 보고합니다.

Cursor(.cursor/mcp.json), VS Code(.vscode/mcp.json), Open Claw(MCPorter 경유), Google Gemini CLI, Cline 등에서도 유사한 단계가 있습니다.

일반적인 워크플로 예시

이미지 게시물 게시

帮我写一篇关于春天的笔记，标题《春日漫步》，内容随意，配图 /Users/me/Pictures/flowers.jpg，使用 xiaohongshu-mcp 发布。

음식 관련 노트 검색

在小红书上搜索“川菜”，只要图文笔记，按最新排序，使用 xiaohongshu-mcp。

자동 댓글

给笔记 123456 的评论 987654 回复‘谢谢分享’，使用 xiaohongshu-mcp。

커뮤니티 및 지원

이슈 및 문제 해결 – 일반적인 Docker/Windows 문제 모음은 issue #56 참조.
Docker 이미지 – Docker Hub에서 풀. 리포지토리에는 원클릭 실행용 docker-compose.yml 포함.
기여 – CONTRIBUTING.md 참조. 프로젝트는 All-Contributors 모델을 따름(31명의 기여자).
기부 – 모든 수익은 자선 단체에 기부됨(DONATIONS.md 참조).

라이선스 및 면책 조항

README에는 소프트웨어가 학습/자동화 목적으로만 사용되어야 하며 오용(스팸, 불법 콘텐츠)은 금지된다고 명시되어 있습니다. 명시적 라이선스 배지는 표시되지 않으므로 정확한 조건은 리포지토리의 LICENSE 파일을 확인하세요.

TL;DR

xiaohongshu-mcp는 Go 기반의 Docker 준비 MCP 서버로, 최신 AI 어시스턴트가 샤오홍슈에서 로그인, 이미지/동영상 게시, 검색, 댓글, 좋아요, 사용자 데이터 가져오기 등의 작업을 표준 JSON-RPC 인터페이스를 통해 수행할 수 있게 합니다. 바이너리, Docker 또는 소스에서 설치하고, 한 번 로그인한 후 서버를 시작하고, MCP 호환 AI 도구를 http://localhost:18060/mcp로 지정하세요.